novacode-cli 1.2.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- novacode_cli/__init__.py +29 -0
- novacode_cli/__main__.py +6 -0
- novacode_cli/_lazy_heavy.py +99 -0
- novacode_cli/_version.py +3 -0
- novacode_cli/agent_stream.py +178 -0
- novacode_cli/agents/agent_file.py +250 -0
- novacode_cli/agents/agent_mailbox.py +120 -0
- novacode_cli/agents/approval_decisions.py +146 -0
- novacode_cli/agents/arg_repair.py +196 -0
- novacode_cli/agents/async_agents/__init__.py +6 -0
- novacode_cli/agents/async_agents/_config.py +213 -0
- novacode_cli/agents/async_agents/_mcp_tools.py +192 -0
- novacode_cli/agents/async_agents/_specialist.py +84 -0
- novacode_cli/agents/async_agents/_test_commands.py +89 -0
- novacode_cli/agents/async_agents/_tools.py +432 -0
- novacode_cli/agents/async_agents/general_purpose.py +42 -0
- novacode_cli/agents/async_agents/langgraph.json +9 -0
- novacode_cli/agents/async_agents/research.py +22 -0
- novacode_cli/agents/async_context.py +303 -0
- novacode_cli/agents/async_on_demand.py +52 -0
- novacode_cli/agents/async_task_errors.py +75 -0
- novacode_cli/agents/async_workspace.py +27 -0
- novacode_cli/agents/attribution.py +165 -0
- novacode_cli/agents/browser_mode.py +119 -0
- novacode_cli/agents/btw_agent.py +71 -0
- novacode_cli/agents/caveman.py +352 -0
- novacode_cli/agents/caveman_support.py +370 -0
- novacode_cli/agents/code_mode.py +774 -0
- novacode_cli/agents/code_runtime.py +160 -0
- novacode_cli/agents/context_compaction.py +1339 -0
- novacode_cli/agents/core_agent.py +2710 -0
- novacode_cli/agents/default_subagents/__init__.py +24 -0
- novacode_cli/agents/default_subagents/async_subagents.py +296 -0
- novacode_cli/agents/default_subagents/builtin/browser-automation-agent.md +110 -0
- novacode_cli/agents/default_subagents/builtin/bug-fix-agent.md +22 -0
- novacode_cli/agents/default_subagents/builtin/bug-investigation-agent.md +42 -0
- novacode_cli/agents/default_subagents/builtin/code-explorer.md +37 -0
- novacode_cli/agents/default_subagents/builtin/code-review-agent.md +33 -0
- novacode_cli/agents/default_subagents/builtin/dependency-audit-agent.md +34 -0
- novacode_cli/agents/default_subagents/builtin/documentation-update-agent.md +46 -0
- novacode_cli/agents/default_subagents/builtin/performance-audit-agent.md +41 -0
- novacode_cli/agents/default_subagents/builtin/plan-scout-agent.md +64 -0
- novacode_cli/agents/default_subagents/builtin/refactoring-agent.md +35 -0
- novacode_cli/agents/default_subagents/builtin/refactoring-specialist-agent.md +175 -0
- novacode_cli/agents/default_subagents/builtin/security-audit-agent.md +96 -0
- novacode_cli/agents/default_subagents/builtin/test-generation-agent.md +33 -0
- novacode_cli/agents/default_subagents/builtin/test-runner-agent.md +55 -0
- novacode_cli/agents/default_subagents/prompt.py +88 -0
- novacode_cli/agents/default_subagents/subagents.py +138 -0
- novacode_cli/agents/dream_agent.py +93 -0
- novacode_cli/agents/edit_diagnostics.py +362 -0
- novacode_cli/agents/edit_fallback.py +62 -0
- novacode_cli/agents/handoff.py +166 -0
- novacode_cli/agents/invocation.py +152 -0
- novacode_cli/agents/model_budget.py +42 -0
- novacode_cli/agents/model_retry.py +113 -0
- novacode_cli/agents/model_router.py +420 -0
- novacode_cli/agents/openai_decisions.py +186 -0
- novacode_cli/agents/plan_agent/__init__.py +12 -0
- novacode_cli/agents/plan_agent/plan_agent.py +357 -0
- novacode_cli/agents/plan_agent/plan_mode_middleware.py +64 -0
- novacode_cli/agents/plan_execution.py +237 -0
- novacode_cli/agents/ponytail.py +66 -0
- novacode_cli/agents/prime.py +274 -0
- novacode_cli/agents/provider_caching.py +99 -0
- novacode_cli/agents/server_launcher.py +904 -0
- novacode_cli/agents/strict_tools.py +384 -0
- novacode_cli/agents/task_discipline.py +294 -0
- novacode_cli/agents/tool_call_repair.py +290 -0
- novacode_cli/agents/tool_offload.py +291 -0
- novacode_cli/agents/tool_search.py +806 -0
- novacode_cli/agents/tool_search_variants.py +106 -0
- novacode_cli/agents/tool_verdicts.py +1194 -0
- novacode_cli/agents/user_async_agents.py +312 -0
- novacode_cli/artifacts/__init__.py +10 -0
- novacode_cli/artifacts/registry.py +278 -0
- novacode_cli/artifacts/server.py +426 -0
- novacode_cli/assets/Nova.png +0 -0
- novacode_cli/assets/nova-avatar.png +0 -0
- novacode_cli/audio/__init__.py +301 -0
- novacode_cli/audio/capture.py +137 -0
- novacode_cli/audio/downloads.py +273 -0
- novacode_cli/audio/pipeline.py +391 -0
- novacode_cli/audio/playback.py +87 -0
- novacode_cli/audio/providers.py +208 -0
- novacode_cli/audio/speakable.py +78 -0
- novacode_cli/audio/stt.py +132 -0
- novacode_cli/audio/stt_deepgram.py +69 -0
- novacode_cli/audio/stt_elevenlabs.py +89 -0
- novacode_cli/audio/stt_parakeet.py +94 -0
- novacode_cli/audio/stt_whistle.py +61 -0
- novacode_cli/audio/summarize.py +92 -0
- novacode_cli/audio/tts.py +85 -0
- novacode_cli/audio/tts_kokoro.py +73 -0
- novacode_cli/audio/tts_orpheus.py +180 -0
- novacode_cli/audio/tts_pocket.py +131 -0
- novacode_cli/audio/tts_sano.py +69 -0
- novacode_cli/audio/vad.py +145 -0
- novacode_cli/backends/__init__.py +17 -0
- novacode_cli/backends/filesystem.py +894 -0
- novacode_cli/backends/native_search.py +92 -0
- novacode_cli/bootstrap/__init__.py +9 -0
- novacode_cli/bootstrap/env_snapshot.py +240 -0
- novacode_cli/bootstrap/steering.py +464 -0
- novacode_cli/bootstrap/vision_router.py +604 -0
- novacode_cli/brand.py +362 -0
- novacode_cli/cli_args.py +718 -0
- novacode_cli/commands/__init__.py +237 -0
- novacode_cli/commands/agents_commands.py +231 -0
- novacode_cli/commands/auth_handler.py +40 -0
- novacode_cli/commands/browser_use_handler.py +75 -0
- novacode_cli/commands/cache_handler.py +32 -0
- novacode_cli/commands/chat_handler.py +1357 -0
- novacode_cli/commands/ci_fix.py +171 -0
- novacode_cli/commands/claude_plan.py +331 -0
- novacode_cli/commands/codex_plan.py +195 -0
- novacode_cli/commands/commands.py +1113 -0
- novacode_cli/commands/create_handler.py +124 -0
- novacode_cli/commands/create_server.py +1887 -0
- novacode_cli/commands/cron_handler.py +119 -0
- novacode_cli/commands/dream_handler.py +203 -0
- novacode_cli/commands/effort_handler.py +65 -0
- novacode_cli/commands/evolution_handler.py +214 -0
- novacode_cli/commands/file_commands.py +381 -0
- novacode_cli/commands/handoff_handler.py +68 -0
- novacode_cli/commands/hooks_handler.py +269 -0
- novacode_cli/commands/init_handler.py +146 -0
- novacode_cli/commands/learning_handler.py +160 -0
- novacode_cli/commands/lite_mode_handler.py +76 -0
- novacode_cli/commands/log_commands.py +363 -0
- novacode_cli/commands/mcp_handler.py +29 -0
- novacode_cli/commands/model_handler.py +29 -0
- novacode_cli/commands/notifications_handler.py +158 -0
- novacode_cli/commands/onboard_handler.py +121 -0
- novacode_cli/commands/plan_handler.py +440 -0
- novacode_cli/commands/planner_usage.py +250 -0
- novacode_cli/commands/plugin_install_handler.py +38 -0
- novacode_cli/commands/plugins_handler.py +35 -0
- novacode_cli/commands/prime_handler.py +455 -0
- novacode_cli/commands/prompt_handler.py +149 -0
- novacode_cli/commands/provider_usage.py +160 -0
- novacode_cli/commands/ralph_events.py +106 -0
- novacode_cli/commands/ralph_handler.py +1293 -0
- novacode_cli/commands/refine_handler.py +213 -0
- novacode_cli/commands/research_handler.py +202 -0
- novacode_cli/commands/rootapp_remote.py +83 -0
- novacode_cli/commands/router_handler.py +36 -0
- novacode_cli/commands/server_commands.py +249 -0
- novacode_cli/commands/session_commands.py +203 -0
- novacode_cli/commands/share_handler.py +450 -0
- novacode_cli/commands/side_commands.py +366 -0
- novacode_cli/commands/skill_invoke.py +420 -0
- novacode_cli/commands/skills_commands.py +48 -0
- novacode_cli/commands/trace_handler.py +322 -0
- novacode_cli/commands/trello_handler.py +226 -0
- novacode_cli/commands/trello_remote.py +177 -0
- novacode_cli/commands/trello_server.py +1214 -0
- novacode_cli/commands/vision_handler.py +127 -0
- novacode_cli/commands/voice_handler.py +447 -0
- novacode_cli/commands/webhook_handler.py +134 -0
- novacode_cli/commands/wiki_commands.py +227 -0
- novacode_cli/compaction.py +753 -0
- novacode_cli/computation_cache.py +159 -0
- novacode_cli/computer/__init__.py +1 -0
- novacode_cli/computer/persistent.py +234 -0
- novacode_cli/computer/preview.py +253 -0
- novacode_cli/computer/runtime.py +474 -0
- novacode_cli/computer/windows_console.py +152 -0
- novacode_cli/computer/windows_qemu.py +211 -0
- novacode_cli/config/browser_mode.py +159 -0
- novacode_cli/config/catalog_models.py +95 -0
- novacode_cli/config/config.py +1388 -0
- novacode_cli/config/credentials.py +540 -0
- novacode_cli/config/google_oauth_auth.py +281 -0
- novacode_cli/config/model_capabilities.py +343 -0
- novacode_cli/config/model_catalog.py +275 -0
- novacode_cli/config/model_create.py +1325 -0
- novacode_cli/config/model_manager.py +695 -0
- novacode_cli/config/nova_config.py +1283 -0
- novacode_cli/config/openai_chatgpt_auth.py +384 -0
- novacode_cli/config/opencode_gateway.py +25 -0
- novacode_cli/config/plan_mode.py +188 -0
- novacode_cli/config/provider_auth.py +438 -0
- novacode_cli/config/provider_catalog.json +5127 -0
- novacode_cli/config/provider_registry.py +38 -0
- novacode_cli/config/provider_transports.py +258 -0
- novacode_cli/config/role_models.py +175 -0
- novacode_cli/context/__init__.py +50 -0
- novacode_cli/context/_analysis.py +799 -0
- novacode_cli/context/_budget.py +116 -0
- novacode_cli/context/_conversation.py +73 -0
- novacode_cli/context/_dynamic.py +264 -0
- novacode_cli/context/_model_config.py +380 -0
- novacode_cli/context/_models_dev.py +99 -0
- novacode_cli/context/archives.py +248 -0
- novacode_cli/context/estimates.py +65 -0
- novacode_cli/context/history.py +17 -0
- novacode_cli/context/knowledge_cache.py +292 -0
- novacode_cli/context/manager.py +101 -0
- novacode_cli/context/observations.py +65 -0
- novacode_cli/context/pressure.py +168 -0
- novacode_cli/context/provider_accounting.py +109 -0
- novacode_cli/context/snapshot.py +493 -0
- novacode_cli/context/strategies.py +279 -0
- novacode_cli/context/task_progress.py +122 -0
- novacode_cli/core/__init__.py +0 -0
- novacode_cli/core/agent_loop.py +1821 -0
- novacode_cli/core/autonomous_loop.py +277 -0
- novacode_cli/core/code_approvals.py +57 -0
- novacode_cli/core/input_preparation.py +276 -0
- novacode_cli/core/reasoning.py +67 -0
- novacode_cli/core/streaming.py +326 -0
- novacode_cli/core/subagent_tasks.py +696 -0
- novacode_cli/core/subagent_tracking.py +235 -0
- novacode_cli/core/tool_results.py +116 -0
- novacode_cli/core/verification_loop.py +272 -0
- novacode_cli/council.py +595 -0
- novacode_cli/council_consensus.py +115 -0
- novacode_cli/council_decision.py +157 -0
- novacode_cli/council_planner.py +1421 -0
- novacode_cli/council_settings.py +208 -0
- novacode_cli/council_web_settings.py +41 -0
- novacode_cli/council_workspace.py +56 -0
- novacode_cli/cowork/__init__.py +10 -0
- novacode_cli/cowork/broker_middleware.py +162 -0
- novacode_cli/cowork/launcher.py +102 -0
- novacode_cli/cowork/policy.py +284 -0
- novacode_cli/cowork/ui.py +826 -0
- novacode_cli/daemons/__init__.py +1 -0
- novacode_cli/daemons/registry.py +342 -0
- novacode_cli/desktop_notifications.py +302 -0
- novacode_cli/doctor.py +251 -0
- novacode_cli/embeddings.py +109 -0
- novacode_cli/entrypoint.py +56 -0
- novacode_cli/errors/__init__.py +19 -0
- novacode_cli/errors/handlers.py +648 -0
- novacode_cli/errors/provider_errors.py +249 -0
- novacode_cli/errors/taxonomy.py +80 -0
- novacode_cli/events.py +179 -0
- novacode_cli/file_ops.py +714 -0
- novacode_cli/git_safety.py +281 -0
- novacode_cli/handoff.py +383 -0
- novacode_cli/headless/__init__.py +18 -0
- novacode_cli/headless/input.py +58 -0
- novacode_cli/headless/output.py +224 -0
- novacode_cli/headless/pipe.py +532 -0
- novacode_cli/headless/runner.py +461 -0
- novacode_cli/hermes/__init__.py +39 -0
- novacode_cli/hermes/activation.py +297 -0
- novacode_cli/hermes/config.py +129 -0
- novacode_cli/hermes/curator.py +199 -0
- novacode_cli/hermes/evolution.py +374 -0
- novacode_cli/hermes/ledger.py +364 -0
- novacode_cli/hermes/memory_tiers.py +969 -0
- novacode_cli/hermes/middleware.py +678 -0
- novacode_cli/hermes/overview.py +174 -0
- novacode_cli/hermes/prompt_evolution.py +503 -0
- novacode_cli/hermes/refine_loop.py +643 -0
- novacode_cli/hermes/refinement_log.py +190 -0
- novacode_cli/hermes/review.py +674 -0
- novacode_cli/hermes/skill_debate.py +135 -0
- novacode_cli/hermes/skill_discovery.py +450 -0
- novacode_cli/hermes/skill_manager.py +335 -0
- novacode_cli/hermes/skill_proposals.py +43 -0
- novacode_cli/hermes/test_gaming.py +119 -0
- novacode_cli/hermes/tracker.py +435 -0
- novacode_cli/hermes/tuner.py +206 -0
- novacode_cli/hermes/verification_memory.py +134 -0
- novacode_cli/hermes/verifier.py +277 -0
- novacode_cli/hitl/__init__.py +22 -0
- novacode_cli/hitl/interrupts.py +493 -0
- novacode_cli/hooks.py +359 -0
- novacode_cli/image_utils.py +517 -0
- novacode_cli/init/__init__.py +7 -0
- novacode_cli/init/events.py +43 -0
- novacode_cli/input_utils.py +526 -0
- novacode_cli/install_commands.py +87 -0
- novacode_cli/integrations/__init__.py +82 -0
- novacode_cli/integrations/daytona.py +122 -0
- novacode_cli/integrations/docker.py +309 -0
- novacode_cli/integrations/host_path.py +111 -0
- novacode_cli/integrations/langsmith.py +151 -0
- novacode_cli/integrations/modal.py +134 -0
- novacode_cli/integrations/runloop.py +130 -0
- novacode_cli/integrations/sandbox_factory.py +1388 -0
- novacode_cli/integrations/sandbox_registry.py +312 -0
- novacode_cli/integrations/workdir_backend.py +589 -0
- novacode_cli/main.py +2078 -0
- novacode_cli/mcp/__init__.py +73 -0
- novacode_cli/mcp/auth.py +189 -0
- novacode_cli/mcp/client.py +571 -0
- novacode_cli/mcp/code_mode.py +5 -0
- novacode_cli/mcp/code_runtime.py +5 -0
- novacode_cli/mcp/commands.py +902 -0
- novacode_cli/mcp/config.py +406 -0
- novacode_cli/mcp/generic.py +128 -0
- novacode_cli/mcp/middleware.py +993 -0
- novacode_cli/mcp/presets.py +367 -0
- novacode_cli/memory/__init__.py +1 -0
- novacode_cli/memory/agent_memory.py +1312 -0
- novacode_cli/memory/builtin_lessons.py +60 -0
- novacode_cli/memory/dream_gates.py +192 -0
- novacode_cli/memory/limits.py +59 -0
- novacode_cli/memory/parsed_cache.py +106 -0
- novacode_cli/memory/recall_stats.py +97 -0
- novacode_cli/memory/semantic.py +116 -0
- novacode_cli/memory/store.py +335 -0
- novacode_cli/memory/wiki.py +274 -0
- novacode_cli/migrate.py +185 -0
- novacode_cli/onboarding.py +649 -0
- novacode_cli/onboarding_check.py +119 -0
- novacode_cli/path_approval.py +297 -0
- novacode_cli/plan_archive.py +148 -0
- novacode_cli/plugins/__init__.py +121 -0
- novacode_cli/plugins/claude_plugins.py +538 -0
- novacode_cli/plugins/cli.py +168 -0
- novacode_cli/plugins/components.py +413 -0
- novacode_cli/plugins/hooks.py +356 -0
- novacode_cli/plugins/loader.py +317 -0
- novacode_cli/plugins/marketplaces.py +199 -0
- novacode_cli/plugins/storage.py +70 -0
- novacode_cli/prime.py +759 -0
- novacode_cli/prime_factory/__init__.py +15 -0
- novacode_cli/prime_factory/container.py +198 -0
- novacode_cli/prime_factory/controller.py +565 -0
- novacode_cli/prime_factory/knowledge.py +261 -0
- novacode_cli/prime_factory/publication.py +218 -0
- novacode_cli/prime_factory/recovery.py +50 -0
- novacode_cli/prime_factory/research.py +370 -0
- novacode_cli/prime_factory/runner.py +608 -0
- novacode_cli/prime_factory/runtime.py +261 -0
- novacode_cli/prime_factory/state.py +201 -0
- novacode_cli/prime_factory/store.py +128 -0
- novacode_cli/prime_factory/worker.py +129 -0
- novacode_cli/prime_factory/workflow.py +899 -0
- novacode_cli/prime_factory/workspace.py +317 -0
- novacode_cli/prime_memory.py +290 -0
- novacode_cli/process_manager.py +585 -0
- novacode_cli/project_onboard.py +537 -0
- novacode_cli/prompts/System_Prompt_Nova.jinja +23 -0
- novacode_cli/prompts/__init__.py +168 -0
- novacode_cli/prompts/agent_definitions.jinja +11 -0
- novacode_cli/prompts/agent_generation.jinja +125 -0
- novacode_cli/prompts/async_agents/general_purpose.jinja +22 -0
- novacode_cli/prompts/claude_plan_mode.jinja +12 -0
- novacode_cli/prompts/coding_workflow.jinja +18 -0
- novacode_cli/prompts/computer_use.jinja +17 -0
- novacode_cli/prompts/core_agent_system.jinja +81 -0
- novacode_cli/prompts/delegation.jinja +15 -0
- novacode_cli/prompts/desktop_power.jinja +4 -0
- novacode_cli/prompts/file_paths.jinja +15 -0
- novacode_cli/prompts/file_tracker.jinja +23 -0
- novacode_cli/prompts/init_agents_md.jinja +56 -0
- novacode_cli/prompts/init_exploration.jinja +174 -0
- novacode_cli/prompts/init_semantic_orchestrate.jinja +37 -0
- novacode_cli/prompts/instruction_scope.jinja +5 -0
- novacode_cli/prompts/learnings_extraction.jinja +45 -0
- novacode_cli/prompts/longterm_memory.jinja +54 -0
- novacode_cli/prompts/mcp.jinja +84 -0
- novacode_cli/prompts/memory_consolidation.jinja +40 -0
- novacode_cli/prompts/nova_evolution.jinja +73 -0
- novacode_cli/prompts/nova_review.jinja +158 -0
- novacode_cli/prompts/nova_skill_debate.jinja +36 -0
- novacode_cli/prompts/nova_standing_instructions.jinja +26 -0
- novacode_cli/prompts/nova_verify.jinja +100 -0
- novacode_cli/prompts/onboard_dashboard.jinja +378 -0
- novacode_cli/prompts/plan_agent.jinja +87 -0
- novacode_cli/prompts/plan_scouts.jinja +5 -0
- novacode_cli/prompts/plan_storage.jinja +8 -0
- novacode_cli/prompts/planning.jinja +82 -0
- novacode_cli/prompts/ponytail/LICENSE +21 -0
- novacode_cli/prompts/ponytail/UPSTREAM.json +15 -0
- novacode_cli/prompts/ponytail/hooks/ponytail-config.js +175 -0
- novacode_cli/prompts/ponytail/hooks/ponytail-instructions.js +98 -0
- novacode_cli/prompts/ponytail/skills/ponytail/SKILL.md +52 -0
- novacode_cli/prompts/ponytail/skills/ponytail-audit/SKILL.md +103 -0
- novacode_cli/prompts/ponytail/skills/ponytail-debt/SKILL.md +44 -0
- novacode_cli/prompts/ponytail/skills/ponytail-gain/SKILL.md +52 -0
- novacode_cli/prompts/ponytail/skills/ponytail-help/SKILL.md +76 -0
- novacode_cli/prompts/ponytail/skills/ponytail-review/SKILL.md +101 -0
- novacode_cli/prompts/prompt_evolution.jinja +27 -0
- novacode_cli/prompts/ralph_iteration.jinja +75 -0
- novacode_cli/prompts/refine_gate.jinja +31 -0
- novacode_cli/prompts/refine_plan.jinja +64 -0
- novacode_cli/prompts/refine_review.jinja +34 -0
- novacode_cli/prompts/research_delivery.jinja +9 -0
- novacode_cli/prompts/research_swarm.jinja +130 -0
- novacode_cli/prompts/response_style.jinja +5 -0
- novacode_cli/prompts/session_summarization.jinja +86 -0
- novacode_cli/prompts/skill_creation.jinja +85 -0
- novacode_cli/prompts/subagents/fact_checker.jinja +48 -0
- novacode_cli/prompts/subagents/financial_analyst.jinja +50 -0
- novacode_cli/prompts/subagents/literature_reviewer.jinja +52 -0
- novacode_cli/prompts/subagents/market_analyst.jinja +48 -0
- novacode_cli/prompts/subagents/research_synthesizer.jinja +57 -0
- novacode_cli/prompts/subagents/technical_researcher.jinja +56 -0
- novacode_cli/prompts/subagents/web_researcher.jinja +46 -0
- novacode_cli/prompts/summarization.jinja +107 -0
- novacode_cli/prompts/summarization_answers.jinja +23 -0
- novacode_cli/prompts/summarization_questions.jinja +32 -0
- novacode_cli/prompts/vision_caption.jinja +21 -0
- novacode_cli/prompts/voice_summary.jinja +65 -0
- novacode_cli/prompts/wiki_file.jinja +57 -0
- novacode_cli/prompts/wiki_ingest.jinja +87 -0
- novacode_cli/recovery.py +383 -0
- novacode_cli/remote/__init__.py +45 -0
- novacode_cli/remote/approvals.py +282 -0
- novacode_cli/remote/async_task_clients.py +97 -0
- novacode_cli/remote/async_task_watcher.py +240 -0
- novacode_cli/remote/bridge.py +905 -0
- novacode_cli/remote/command_menu.py +26 -0
- novacode_cli/remote/command_ui.py +243 -0
- novacode_cli/remote/config.py +199 -0
- novacode_cli/remote/discord_bridge.py +530 -0
- novacode_cli/remote/discord_format.py +31 -0
- novacode_cli/remote/discord_threads.py +225 -0
- novacode_cli/remote/images.py +97 -0
- novacode_cli/remote/processor.py +601 -0
- novacode_cli/remote/rootapp_bot/bot.cjs +16 -0
- novacode_cli/remote/rootapp_bot/package-lock.json +2683 -0
- novacode_cli/remote/rootapp_bot/package.json +18 -0
- novacode_cli/remote/rootapp_bot/transport.cjs +80 -0
- novacode_cli/remote/rootapp_bridge.py +370 -0
- novacode_cli/remote/rootapp_setup.py +89 -0
- novacode_cli/remote/routing.py +103 -0
- novacode_cli/remote/scheduler.py +302 -0
- novacode_cli/remote/session.py +164 -0
- novacode_cli/remote/status.py +411 -0
- novacode_cli/remote/streaming.py +188 -0
- novacode_cli/remote/telegram_bridge.py +1118 -0
- novacode_cli/remote/telegram_format.py +215 -0
- novacode_cli/remote/telegram_hub.py +256 -0
- novacode_cli/remote/voice_notes.py +120 -0
- novacode_cli/remote/webhook_adapters.py +167 -0
- novacode_cli/remote/webhook_server.py +154 -0
- novacode_cli/rewind.py +150 -0
- novacode_cli/rooms/__init__.py +1 -0
- novacode_cli/rooms/bridge.py +86 -0
- novacode_cli/rooms/cli.py +231 -0
- novacode_cli/rooms/nova.py +227 -0
- novacode_cli/rooms/runtime.py +299 -0
- novacode_cli/rooms/store.py +538 -0
- novacode_cli/rooms/workspace.py +94 -0
- novacode_cli/security/__init__.py +29 -0
- novacode_cli/security/approval_context.py +45 -0
- novacode_cli/security/delegated_approval.py +68 -0
- novacode_cli/security/local_http.py +85 -0
- novacode_cli/security/middleware.py +87 -0
- novacode_cli/security/paths.py +35 -0
- novacode_cli/security/policy.py +535 -0
- novacode_cli/security/policy_writer.py +90 -0
- novacode_cli/security/prompt_injection.py +203 -0
- novacode_cli/security/remember.py +81 -0
- novacode_cli/security/rule_synthesis.py +116 -0
- novacode_cli/security/secret_files.py +61 -0
- novacode_cli/security/session_allow.py +114 -0
- novacode_cli/security/unicode_security.py +516 -0
- novacode_cli/security/validator.py +173 -0
- novacode_cli/server/__init__.py +9 -0
- novacode_cli/server/app.py +632 -0
- novacode_cli/server/event_adapter.py +189 -0
- novacode_cli/server/session_manager.py +90 -0
- novacode_cli/server_main.py +64 -0
- novacode_cli/server_runner/dev_server.py +530 -0
- novacode_cli/server_runner/test_runner.py +470 -0
- novacode_cli/session/__init__.py +1 -0
- novacode_cli/session/adapters/__init__.py +240 -0
- novacode_cli/session/adapters/claude_code.py +102 -0
- novacode_cli/session/adapters/codex.py +77 -0
- novacode_cli/session/adapters/harness_native.py +75 -0
- novacode_cli/session/checkpoint_coordinator.py +448 -0
- novacode_cli/session/context_restore.py +25 -0
- novacode_cli/session/history_export.py +228 -0
- novacode_cli/session/history_tree.py +174 -0
- novacode_cli/session/imported_context.py +267 -0
- novacode_cli/session/runtime_identity.py +32 -0
- novacode_cli/session/session_persistence.py +1168 -0
- novacode_cli/session/session_prompt_builder.py +279 -0
- novacode_cli/session/session_restore.py +351 -0
- novacode_cli/session/session_summarization.py +20 -0
- novacode_cli/session/transcript_journal.py +153 -0
- novacode_cli/sessions/__init__.py +11 -0
- novacode_cli/sessions/gateway.py +84 -0
- novacode_cli/sessions/launch.py +51 -0
- novacode_cli/sessions/lease.py +213 -0
- novacode_cli/sessions/messaging.py +255 -0
- novacode_cli/sessions/protocol.py +216 -0
- novacode_cli/sessions/resume.py +31 -0
- novacode_cli/sessions/supervisor.py +498 -0
- novacode_cli/sessions/tasks.py +73 -0
- novacode_cli/sessions/tui_messaging.py +413 -0
- novacode_cli/sessions/worker.py +652 -0
- novacode_cli/sessions/worktree.py +262 -0
- novacode_cli/shell/__init__.py +27 -0
- novacode_cli/shell/jobs.py +475 -0
- novacode_cli/shell/middleware.py +1568 -0
- novacode_cli/shell/os_sandbox.py +205 -0
- novacode_cli/shell/output.py +181 -0
- novacode_cli/shell/patterns.py +275 -0
- novacode_cli/shell/processes.py +87 -0
- novacode_cli/shell/utils.py +236 -0
- novacode_cli/skills/__init__.py +26 -0
- novacode_cli/skills/builtin/handoff/SKILL.md +15 -0
- novacode_cli/skills/curation_middleware.py +69 -0
- novacode_cli/skills/executable.py +161 -0
- novacode_cli/skills/libraries.py +102 -0
- novacode_cli/skills/load.py +248 -0
- novacode_cli/skills/prune.py +215 -0
- novacode_cli/skills/refreshing_middleware.py +896 -0
- novacode_cli/skills/retrieval.py +248 -0
- novacode_cli/skills/runtime.py +118 -0
- novacode_cli/skills/schema.py +254 -0
- novacode_cli/skills/skill_creation.py +1549 -0
- novacode_cli/skills/skill_lock.py +75 -0
- novacode_cli/skills/skill_system_prompt.py +16 -0
- novacode_cli/skills/skills_prefs.py +126 -0
- novacode_cli/skills/tool_resolver.py +31 -0
- novacode_cli/skills/upstream.py +50 -0
- novacode_cli/skills/versioning.py +291 -0
- novacode_cli/states/Session.py +847 -0
- novacode_cli/states/__init__.py +31 -0
- novacode_cli/states/slices/__init__.py +17 -0
- novacode_cli/states/slices/agent_runtime.py +249 -0
- novacode_cli/states/slices/background_tasks.py +21 -0
- novacode_cli/states/slices/notifications.py +74 -0
- novacode_cli/states/slices/remote_bridge.py +56 -0
- novacode_cli/states/slices/ui_settings.py +49 -0
- novacode_cli/states/slices/wiki.py +25 -0
- novacode_cli/teammates/__init__.py +1 -0
- novacode_cli/teammates/controller.py +557 -0
- novacode_cli/teammates/graph.py +104 -0
- novacode_cli/teammates/registry.py +175 -0
- novacode_cli/teammates/service.py +254 -0
- novacode_cli/teammates/worker.py +19 -0
- novacode_cli/teams/__init__.py +1 -0
- novacode_cli/teams/adapters/__init__.py +1 -0
- novacode_cli/teams/adapters/container.py +316 -0
- novacode_cli/teams/adapters/inprocess.py +206 -0
- novacode_cli/teams/adapters/process.py +364 -0
- novacode_cli/teams/bootstrap.py +246 -0
- novacode_cli/teams/container_git.py +67 -0
- novacode_cli/teams/context.py +34 -0
- novacode_cli/teams/coordinator.py +815 -0
- novacode_cli/teams/gateway.py +200 -0
- novacode_cli/teams/host.py +64 -0
- novacode_cli/teams/legacy.py +52 -0
- novacode_cli/teams/middleware.py +176 -0
- novacode_cli/teams/models.py +104 -0
- novacode_cli/teams/output.py +47 -0
- novacode_cli/teams/protocol.py +50 -0
- novacode_cli/teams/recovery.py +80 -0
- novacode_cli/teams/scheduler.py +44 -0
- novacode_cli/teams/store.py +631 -0
- novacode_cli/teams/worker.py +251 -0
- novacode_cli/teams/workspace.py +100 -0
- novacode_cli/token_utils.py +256 -0
- novacode_cli/tools/__init__.py +104 -0
- novacode_cli/tools/_shared.py +97 -0
- novacode_cli/tools/_types.py +24 -0
- novacode_cli/tools/artifact_tools.py +137 -0
- novacode_cli/tools/code_search_tools.py +330 -0
- novacode_cli/tools/computer_tools.py +77 -0
- novacode_cli/tools/cron_tools.py +65 -0
- novacode_cli/tools/daemon_tool.py +290 -0
- novacode_cli/tools/desktop_tools.py +161 -0
- novacode_cli/tools/fetch_tools.py +530 -0
- novacode_cli/tools/http_tools.py +279 -0
- novacode_cli/tools/inspection_tools.py +107 -0
- novacode_cli/tools/job_tools.py +143 -0
- novacode_cli/tools/knowledge_tools.py +427 -0
- novacode_cli/tools/memory_tools.py +461 -0
- novacode_cli/tools/memory_wiki_tools.py +40 -0
- novacode_cli/tools/notebook_tools.py +238 -0
- novacode_cli/tools/oracle_tool.py +83 -0
- novacode_cli/tools/plan_archive_tools.py +80 -0
- novacode_cli/tools/plan_mode_tools.py +315 -0
- novacode_cli/tools/python_kernel_loop.py +165 -0
- novacode_cli/tools/python_kernel_tool.py +222 -0
- novacode_cli/tools/reflection_tools.py +34 -0
- novacode_cli/tools/scraper_tools.py +377 -0
- novacode_cli/tools/skill_tools.py +275 -0
- novacode_cli/tools/speak_tool.py +51 -0
- novacode_cli/tools/store_memory_tools.py +227 -0
- novacode_cli/tools/ui_tools.py +62 -0
- novacode_cli/tools/waiter_tools.py +408 -0
- novacode_cli/tools/web_tools.py +349 -0
- novacode_cli/tools/wiki_tools.py +152 -0
- novacode_cli/tools/worktree_tools.py +219 -0
- novacode_cli/tracking/__init__.py +10 -0
- novacode_cli/tracking/file_tracker.py +826 -0
- novacode_cli/tracking/local_metrics.py +170 -0
- novacode_cli/tracking/loop_guard.py +507 -0
- novacode_cli/tracking/request_metrics.py +60 -0
- novacode_cli/tracking/tracing.py +692 -0
- novacode_cli/tracking/usage_tree.py +677 -0
- novacode_cli/tracking/workspace_anchoring.py +231 -0
- novacode_cli/tui/__init__.py +11 -0
- novacode_cli/tui/animation_rate.py +9 -0
- novacode_cli/tui/animations.py +332 -0
- novacode_cli/tui/app.py +19315 -0
- novacode_cli/tui/auth_display.py +87 -0
- novacode_cli/tui/auth_screens.py +826 -0
- novacode_cli/tui/avatar.py +294 -0
- novacode_cli/tui/avatar_frames.py +21 -0
- novacode_cli/tui/background_tasks.py +35 -0
- novacode_cli/tui/browser_settings_screen.py +70 -0
- novacode_cli/tui/caveman_screen.py +185 -0
- novacode_cli/tui/council_settings_screen.py +182 -0
- novacode_cli/tui/council_view.py +535 -0
- novacode_cli/tui/decision_settings.py +268 -0
- novacode_cli/tui/diff_preview.py +199 -0
- novacode_cli/tui/gc_tuning.py +63 -0
- novacode_cli/tui/handoff_screen.py +206 -0
- novacode_cli/tui/harness.py +244 -0
- novacode_cli/tui/history_tree_screen.py +179 -0
- novacode_cli/tui/home.py +328 -0
- novacode_cli/tui/home_scene.py +94 -0
- novacode_cli/tui/icons.py +81 -0
- novacode_cli/tui/interface_styles.tcss +327 -0
- novacode_cli/tui/matrix3.py +108 -0
- novacode_cli/tui/mcp_tools_screen.py +131 -0
- novacode_cli/tui/motion.py +178 -0
- novacode_cli/tui/output_body.py +136 -0
- novacode_cli/tui/output_buffer.py +59 -0
- novacode_cli/tui/palette.py +334 -0
- novacode_cli/tui/pickers.py +237 -0
- novacode_cli/tui/prime_panel.py +506 -0
- novacode_cli/tui/provider_signin.py +213 -0
- novacode_cli/tui/pty_shell.py +159 -0
- novacode_cli/tui/reference_screens.py +444 -0
- novacode_cli/tui/resume_picker.py +346 -0
- novacode_cli/tui/rooms.py +597 -0
- novacode_cli/tui/screens.py +7088 -0
- novacode_cli/tui/session_import.py +333 -0
- novacode_cli/tui/session_pane.py +242 -0
- novacode_cli/tui/session_tab.py +42 -0
- novacode_cli/tui/session_transcript.py +118 -0
- novacode_cli/tui/shell_output.py +7 -0
- novacode_cli/tui/stall_watch.py +174 -0
- novacode_cli/tui/statusline.py +40 -0
- novacode_cli/tui/statusline_screen.py +91 -0
- novacode_cli/tui/teammate_updates.py +162 -0
- novacode_cli/tui/teammates.py +548 -0
- novacode_cli/tui/terminal.py +289 -0
- novacode_cli/tui/terminal_view.py +235 -0
- novacode_cli/tui/themes.py +118 -0
- novacode_cli/tui/update_notice.py +84 -0
- novacode_cli/tui/voice_downloads.py +113 -0
- novacode_cli/tui/widgets.py +2038 -0
- novacode_cli/tui/windows_input.py +38 -0
- novacode_cli/tui/workspace_approval.py +165 -0
- novacode_cli/ui/council_web.py +113 -0
- novacode_cli/ui/council_workspace.py +72 -0
- novacode_cli/ui/cowork_web.py +41 -0
- novacode_cli/ui/diff_highlight.py +160 -0
- novacode_cli/ui/execution.py +1396 -0
- novacode_cli/ui/exit_summary.py +65 -0
- novacode_cli/ui/hitl_approval.py +196 -0
- novacode_cli/ui/input_preparation.py +2 -0
- novacode_cli/ui/interrupt_handlers.py +215 -0
- novacode_cli/ui/question_prompt.py +151 -0
- novacode_cli/ui/status_phrases.py +157 -0
- novacode_cli/ui/stream_preview.py +66 -0
- novacode_cli/ui/streaming.py +2 -0
- novacode_cli/ui/subagent_tracking.py +2 -0
- novacode_cli/ui/ui_elements.py +1585 -0
- novacode_cli/ui/web_workspace.py +244 -0
- novacode_cli/ui_events.py +299 -0
- novacode_cli/update_ui.py +243 -0
- novacode_cli/updates.py +489 -0
- novacode_cli/utils/backend_patches.py +399 -0
- novacode_cli/utils/backend_paths.py +467 -0
- novacode_cli/utils/lazy_providers.py +51 -0
- novacode_cli/utils/model_info.py +223 -0
- novacode_cli/utils/pdf_extraction.py +183 -0
- novacode_cli/utils/startup.py +29 -0
- novacode_cli/utils/tasks.py +42 -0
- novacode_cli/utils/windows.py +9 -0
- novacode_cli/vixie/hook_adapter.py +127 -0
- novacode_cli/vixie/server.py +375 -0
- novacode_cli/wiki/__init__.py +15 -0
- novacode_cli/wiki/ask.py +56 -0
- novacode_cli/wiki/file.py +71 -0
- novacode_cli/wiki/ingest.py +184 -0
- novacode_cli/wiki/manager.py +261 -0
- novacode_cli-1.2.0.dist-info/METADATA +271 -0
- novacode_cli-1.2.0.dist-info/RECORD +691 -0
- novacode_cli-1.2.0.dist-info/WHEEL +5 -0
- novacode_cli-1.2.0.dist-info/entry_points.txt +2 -0
- novacode_cli-1.2.0.dist-info/licenses/LICENSE +21 -0
- novacode_cli-1.2.0.dist-info/top_level.txt +1 -0
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"
|