novacode-cli 1.2.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- novacode_cli/__init__.py +29 -0
- novacode_cli/__main__.py +6 -0
- novacode_cli/_lazy_heavy.py +99 -0
- novacode_cli/_version.py +3 -0
- novacode_cli/agent_stream.py +178 -0
- novacode_cli/agents/agent_file.py +250 -0
- novacode_cli/agents/agent_mailbox.py +120 -0
- novacode_cli/agents/approval_decisions.py +146 -0
- novacode_cli/agents/arg_repair.py +196 -0
- novacode_cli/agents/async_agents/__init__.py +6 -0
- novacode_cli/agents/async_agents/_config.py +213 -0
- novacode_cli/agents/async_agents/_mcp_tools.py +192 -0
- novacode_cli/agents/async_agents/_specialist.py +84 -0
- novacode_cli/agents/async_agents/_test_commands.py +89 -0
- novacode_cli/agents/async_agents/_tools.py +432 -0
- novacode_cli/agents/async_agents/general_purpose.py +42 -0
- novacode_cli/agents/async_agents/langgraph.json +9 -0
- novacode_cli/agents/async_agents/research.py +22 -0
- novacode_cli/agents/async_context.py +303 -0
- novacode_cli/agents/async_on_demand.py +52 -0
- novacode_cli/agents/async_task_errors.py +75 -0
- novacode_cli/agents/async_workspace.py +27 -0
- novacode_cli/agents/attribution.py +165 -0
- novacode_cli/agents/browser_mode.py +119 -0
- novacode_cli/agents/btw_agent.py +71 -0
- novacode_cli/agents/caveman.py +352 -0
- novacode_cli/agents/caveman_support.py +370 -0
- novacode_cli/agents/code_mode.py +774 -0
- novacode_cli/agents/code_runtime.py +160 -0
- novacode_cli/agents/context_compaction.py +1339 -0
- novacode_cli/agents/core_agent.py +2710 -0
- novacode_cli/agents/default_subagents/__init__.py +24 -0
- novacode_cli/agents/default_subagents/async_subagents.py +296 -0
- novacode_cli/agents/default_subagents/builtin/browser-automation-agent.md +110 -0
- novacode_cli/agents/default_subagents/builtin/bug-fix-agent.md +22 -0
- novacode_cli/agents/default_subagents/builtin/bug-investigation-agent.md +42 -0
- novacode_cli/agents/default_subagents/builtin/code-explorer.md +37 -0
- novacode_cli/agents/default_subagents/builtin/code-review-agent.md +33 -0
- novacode_cli/agents/default_subagents/builtin/dependency-audit-agent.md +34 -0
- novacode_cli/agents/default_subagents/builtin/documentation-update-agent.md +46 -0
- novacode_cli/agents/default_subagents/builtin/performance-audit-agent.md +41 -0
- novacode_cli/agents/default_subagents/builtin/plan-scout-agent.md +64 -0
- novacode_cli/agents/default_subagents/builtin/refactoring-agent.md +35 -0
- novacode_cli/agents/default_subagents/builtin/refactoring-specialist-agent.md +175 -0
- novacode_cli/agents/default_subagents/builtin/security-audit-agent.md +96 -0
- novacode_cli/agents/default_subagents/builtin/test-generation-agent.md +33 -0
- novacode_cli/agents/default_subagents/builtin/test-runner-agent.md +55 -0
- novacode_cli/agents/default_subagents/prompt.py +88 -0
- novacode_cli/agents/default_subagents/subagents.py +138 -0
- novacode_cli/agents/dream_agent.py +93 -0
- novacode_cli/agents/edit_diagnostics.py +362 -0
- novacode_cli/agents/edit_fallback.py +62 -0
- novacode_cli/agents/handoff.py +166 -0
- novacode_cli/agents/invocation.py +152 -0
- novacode_cli/agents/model_budget.py +42 -0
- novacode_cli/agents/model_retry.py +113 -0
- novacode_cli/agents/model_router.py +420 -0
- novacode_cli/agents/openai_decisions.py +186 -0
- novacode_cli/agents/plan_agent/__init__.py +12 -0
- novacode_cli/agents/plan_agent/plan_agent.py +357 -0
- novacode_cli/agents/plan_agent/plan_mode_middleware.py +64 -0
- novacode_cli/agents/plan_execution.py +237 -0
- novacode_cli/agents/ponytail.py +66 -0
- novacode_cli/agents/prime.py +274 -0
- novacode_cli/agents/provider_caching.py +99 -0
- novacode_cli/agents/server_launcher.py +904 -0
- novacode_cli/agents/strict_tools.py +384 -0
- novacode_cli/agents/task_discipline.py +294 -0
- novacode_cli/agents/tool_call_repair.py +290 -0
- novacode_cli/agents/tool_offload.py +291 -0
- novacode_cli/agents/tool_search.py +806 -0
- novacode_cli/agents/tool_search_variants.py +106 -0
- novacode_cli/agents/tool_verdicts.py +1194 -0
- novacode_cli/agents/user_async_agents.py +312 -0
- novacode_cli/artifacts/__init__.py +10 -0
- novacode_cli/artifacts/registry.py +278 -0
- novacode_cli/artifacts/server.py +426 -0
- novacode_cli/assets/Nova.png +0 -0
- novacode_cli/assets/nova-avatar.png +0 -0
- novacode_cli/audio/__init__.py +301 -0
- novacode_cli/audio/capture.py +137 -0
- novacode_cli/audio/downloads.py +273 -0
- novacode_cli/audio/pipeline.py +391 -0
- novacode_cli/audio/playback.py +87 -0
- novacode_cli/audio/providers.py +208 -0
- novacode_cli/audio/speakable.py +78 -0
- novacode_cli/audio/stt.py +132 -0
- novacode_cli/audio/stt_deepgram.py +69 -0
- novacode_cli/audio/stt_elevenlabs.py +89 -0
- novacode_cli/audio/stt_parakeet.py +94 -0
- novacode_cli/audio/stt_whistle.py +61 -0
- novacode_cli/audio/summarize.py +92 -0
- novacode_cli/audio/tts.py +85 -0
- novacode_cli/audio/tts_kokoro.py +73 -0
- novacode_cli/audio/tts_orpheus.py +180 -0
- novacode_cli/audio/tts_pocket.py +131 -0
- novacode_cli/audio/tts_sano.py +69 -0
- novacode_cli/audio/vad.py +145 -0
- novacode_cli/backends/__init__.py +17 -0
- novacode_cli/backends/filesystem.py +894 -0
- novacode_cli/backends/native_search.py +92 -0
- novacode_cli/bootstrap/__init__.py +9 -0
- novacode_cli/bootstrap/env_snapshot.py +240 -0
- novacode_cli/bootstrap/steering.py +464 -0
- novacode_cli/bootstrap/vision_router.py +604 -0
- novacode_cli/brand.py +362 -0
- novacode_cli/cli_args.py +718 -0
- novacode_cli/commands/__init__.py +237 -0
- novacode_cli/commands/agents_commands.py +231 -0
- novacode_cli/commands/auth_handler.py +40 -0
- novacode_cli/commands/browser_use_handler.py +75 -0
- novacode_cli/commands/cache_handler.py +32 -0
- novacode_cli/commands/chat_handler.py +1357 -0
- novacode_cli/commands/ci_fix.py +171 -0
- novacode_cli/commands/claude_plan.py +331 -0
- novacode_cli/commands/codex_plan.py +195 -0
- novacode_cli/commands/commands.py +1113 -0
- novacode_cli/commands/create_handler.py +124 -0
- novacode_cli/commands/create_server.py +1887 -0
- novacode_cli/commands/cron_handler.py +119 -0
- novacode_cli/commands/dream_handler.py +203 -0
- novacode_cli/commands/effort_handler.py +65 -0
- novacode_cli/commands/evolution_handler.py +214 -0
- novacode_cli/commands/file_commands.py +381 -0
- novacode_cli/commands/handoff_handler.py +68 -0
- novacode_cli/commands/hooks_handler.py +269 -0
- novacode_cli/commands/init_handler.py +146 -0
- novacode_cli/commands/learning_handler.py +160 -0
- novacode_cli/commands/lite_mode_handler.py +76 -0
- novacode_cli/commands/log_commands.py +363 -0
- novacode_cli/commands/mcp_handler.py +29 -0
- novacode_cli/commands/model_handler.py +29 -0
- novacode_cli/commands/notifications_handler.py +158 -0
- novacode_cli/commands/onboard_handler.py +121 -0
- novacode_cli/commands/plan_handler.py +440 -0
- novacode_cli/commands/planner_usage.py +250 -0
- novacode_cli/commands/plugin_install_handler.py +38 -0
- novacode_cli/commands/plugins_handler.py +35 -0
- novacode_cli/commands/prime_handler.py +455 -0
- novacode_cli/commands/prompt_handler.py +149 -0
- novacode_cli/commands/provider_usage.py +160 -0
- novacode_cli/commands/ralph_events.py +106 -0
- novacode_cli/commands/ralph_handler.py +1293 -0
- novacode_cli/commands/refine_handler.py +213 -0
- novacode_cli/commands/research_handler.py +202 -0
- novacode_cli/commands/rootapp_remote.py +83 -0
- novacode_cli/commands/router_handler.py +36 -0
- novacode_cli/commands/server_commands.py +249 -0
- novacode_cli/commands/session_commands.py +203 -0
- novacode_cli/commands/share_handler.py +450 -0
- novacode_cli/commands/side_commands.py +366 -0
- novacode_cli/commands/skill_invoke.py +420 -0
- novacode_cli/commands/skills_commands.py +48 -0
- novacode_cli/commands/trace_handler.py +322 -0
- novacode_cli/commands/trello_handler.py +226 -0
- novacode_cli/commands/trello_remote.py +177 -0
- novacode_cli/commands/trello_server.py +1214 -0
- novacode_cli/commands/vision_handler.py +127 -0
- novacode_cli/commands/voice_handler.py +447 -0
- novacode_cli/commands/webhook_handler.py +134 -0
- novacode_cli/commands/wiki_commands.py +227 -0
- novacode_cli/compaction.py +753 -0
- novacode_cli/computation_cache.py +159 -0
- novacode_cli/computer/__init__.py +1 -0
- novacode_cli/computer/persistent.py +234 -0
- novacode_cli/computer/preview.py +253 -0
- novacode_cli/computer/runtime.py +474 -0
- novacode_cli/computer/windows_console.py +152 -0
- novacode_cli/computer/windows_qemu.py +211 -0
- novacode_cli/config/browser_mode.py +159 -0
- novacode_cli/config/catalog_models.py +95 -0
- novacode_cli/config/config.py +1388 -0
- novacode_cli/config/credentials.py +540 -0
- novacode_cli/config/google_oauth_auth.py +281 -0
- novacode_cli/config/model_capabilities.py +343 -0
- novacode_cli/config/model_catalog.py +275 -0
- novacode_cli/config/model_create.py +1325 -0
- novacode_cli/config/model_manager.py +695 -0
- novacode_cli/config/nova_config.py +1283 -0
- novacode_cli/config/openai_chatgpt_auth.py +384 -0
- novacode_cli/config/opencode_gateway.py +25 -0
- novacode_cli/config/plan_mode.py +188 -0
- novacode_cli/config/provider_auth.py +438 -0
- novacode_cli/config/provider_catalog.json +5127 -0
- novacode_cli/config/provider_registry.py +38 -0
- novacode_cli/config/provider_transports.py +258 -0
- novacode_cli/config/role_models.py +175 -0
- novacode_cli/context/__init__.py +50 -0
- novacode_cli/context/_analysis.py +799 -0
- novacode_cli/context/_budget.py +116 -0
- novacode_cli/context/_conversation.py +73 -0
- novacode_cli/context/_dynamic.py +264 -0
- novacode_cli/context/_model_config.py +380 -0
- novacode_cli/context/_models_dev.py +99 -0
- novacode_cli/context/archives.py +248 -0
- novacode_cli/context/estimates.py +65 -0
- novacode_cli/context/history.py +17 -0
- novacode_cli/context/knowledge_cache.py +292 -0
- novacode_cli/context/manager.py +101 -0
- novacode_cli/context/observations.py +65 -0
- novacode_cli/context/pressure.py +168 -0
- novacode_cli/context/provider_accounting.py +109 -0
- novacode_cli/context/snapshot.py +493 -0
- novacode_cli/context/strategies.py +279 -0
- novacode_cli/context/task_progress.py +122 -0
- novacode_cli/core/__init__.py +0 -0
- novacode_cli/core/agent_loop.py +1821 -0
- novacode_cli/core/autonomous_loop.py +277 -0
- novacode_cli/core/code_approvals.py +57 -0
- novacode_cli/core/input_preparation.py +276 -0
- novacode_cli/core/reasoning.py +67 -0
- novacode_cli/core/streaming.py +326 -0
- novacode_cli/core/subagent_tasks.py +696 -0
- novacode_cli/core/subagent_tracking.py +235 -0
- novacode_cli/core/tool_results.py +116 -0
- novacode_cli/core/verification_loop.py +272 -0
- novacode_cli/council.py +595 -0
- novacode_cli/council_consensus.py +115 -0
- novacode_cli/council_decision.py +157 -0
- novacode_cli/council_planner.py +1421 -0
- novacode_cli/council_settings.py +208 -0
- novacode_cli/council_web_settings.py +41 -0
- novacode_cli/council_workspace.py +56 -0
- novacode_cli/cowork/__init__.py +10 -0
- novacode_cli/cowork/broker_middleware.py +162 -0
- novacode_cli/cowork/launcher.py +102 -0
- novacode_cli/cowork/policy.py +284 -0
- novacode_cli/cowork/ui.py +826 -0
- novacode_cli/daemons/__init__.py +1 -0
- novacode_cli/daemons/registry.py +342 -0
- novacode_cli/desktop_notifications.py +302 -0
- novacode_cli/doctor.py +251 -0
- novacode_cli/embeddings.py +109 -0
- novacode_cli/entrypoint.py +56 -0
- novacode_cli/errors/__init__.py +19 -0
- novacode_cli/errors/handlers.py +648 -0
- novacode_cli/errors/provider_errors.py +249 -0
- novacode_cli/errors/taxonomy.py +80 -0
- novacode_cli/events.py +179 -0
- novacode_cli/file_ops.py +714 -0
- novacode_cli/git_safety.py +281 -0
- novacode_cli/handoff.py +383 -0
- novacode_cli/headless/__init__.py +18 -0
- novacode_cli/headless/input.py +58 -0
- novacode_cli/headless/output.py +224 -0
- novacode_cli/headless/pipe.py +532 -0
- novacode_cli/headless/runner.py +461 -0
- novacode_cli/hermes/__init__.py +39 -0
- novacode_cli/hermes/activation.py +297 -0
- novacode_cli/hermes/config.py +129 -0
- novacode_cli/hermes/curator.py +199 -0
- novacode_cli/hermes/evolution.py +374 -0
- novacode_cli/hermes/ledger.py +364 -0
- novacode_cli/hermes/memory_tiers.py +969 -0
- novacode_cli/hermes/middleware.py +678 -0
- novacode_cli/hermes/overview.py +174 -0
- novacode_cli/hermes/prompt_evolution.py +503 -0
- novacode_cli/hermes/refine_loop.py +643 -0
- novacode_cli/hermes/refinement_log.py +190 -0
- novacode_cli/hermes/review.py +674 -0
- novacode_cli/hermes/skill_debate.py +135 -0
- novacode_cli/hermes/skill_discovery.py +450 -0
- novacode_cli/hermes/skill_manager.py +335 -0
- novacode_cli/hermes/skill_proposals.py +43 -0
- novacode_cli/hermes/test_gaming.py +119 -0
- novacode_cli/hermes/tracker.py +435 -0
- novacode_cli/hermes/tuner.py +206 -0
- novacode_cli/hermes/verification_memory.py +134 -0
- novacode_cli/hermes/verifier.py +277 -0
- novacode_cli/hitl/__init__.py +22 -0
- novacode_cli/hitl/interrupts.py +493 -0
- novacode_cli/hooks.py +359 -0
- novacode_cli/image_utils.py +517 -0
- novacode_cli/init/__init__.py +7 -0
- novacode_cli/init/events.py +43 -0
- novacode_cli/input_utils.py +526 -0
- novacode_cli/install_commands.py +87 -0
- novacode_cli/integrations/__init__.py +82 -0
- novacode_cli/integrations/daytona.py +122 -0
- novacode_cli/integrations/docker.py +309 -0
- novacode_cli/integrations/host_path.py +111 -0
- novacode_cli/integrations/langsmith.py +151 -0
- novacode_cli/integrations/modal.py +134 -0
- novacode_cli/integrations/runloop.py +130 -0
- novacode_cli/integrations/sandbox_factory.py +1388 -0
- novacode_cli/integrations/sandbox_registry.py +312 -0
- novacode_cli/integrations/workdir_backend.py +589 -0
- novacode_cli/main.py +2078 -0
- novacode_cli/mcp/__init__.py +73 -0
- novacode_cli/mcp/auth.py +189 -0
- novacode_cli/mcp/client.py +571 -0
- novacode_cli/mcp/code_mode.py +5 -0
- novacode_cli/mcp/code_runtime.py +5 -0
- novacode_cli/mcp/commands.py +902 -0
- novacode_cli/mcp/config.py +406 -0
- novacode_cli/mcp/generic.py +128 -0
- novacode_cli/mcp/middleware.py +993 -0
- novacode_cli/mcp/presets.py +367 -0
- novacode_cli/memory/__init__.py +1 -0
- novacode_cli/memory/agent_memory.py +1312 -0
- novacode_cli/memory/builtin_lessons.py +60 -0
- novacode_cli/memory/dream_gates.py +192 -0
- novacode_cli/memory/limits.py +59 -0
- novacode_cli/memory/parsed_cache.py +106 -0
- novacode_cli/memory/recall_stats.py +97 -0
- novacode_cli/memory/semantic.py +116 -0
- novacode_cli/memory/store.py +335 -0
- novacode_cli/memory/wiki.py +274 -0
- novacode_cli/migrate.py +185 -0
- novacode_cli/onboarding.py +649 -0
- novacode_cli/onboarding_check.py +119 -0
- novacode_cli/path_approval.py +297 -0
- novacode_cli/plan_archive.py +148 -0
- novacode_cli/plugins/__init__.py +121 -0
- novacode_cli/plugins/claude_plugins.py +538 -0
- novacode_cli/plugins/cli.py +168 -0
- novacode_cli/plugins/components.py +413 -0
- novacode_cli/plugins/hooks.py +356 -0
- novacode_cli/plugins/loader.py +317 -0
- novacode_cli/plugins/marketplaces.py +199 -0
- novacode_cli/plugins/storage.py +70 -0
- novacode_cli/prime.py +759 -0
- novacode_cli/prime_factory/__init__.py +15 -0
- novacode_cli/prime_factory/container.py +198 -0
- novacode_cli/prime_factory/controller.py +565 -0
- novacode_cli/prime_factory/knowledge.py +261 -0
- novacode_cli/prime_factory/publication.py +218 -0
- novacode_cli/prime_factory/recovery.py +50 -0
- novacode_cli/prime_factory/research.py +370 -0
- novacode_cli/prime_factory/runner.py +608 -0
- novacode_cli/prime_factory/runtime.py +261 -0
- novacode_cli/prime_factory/state.py +201 -0
- novacode_cli/prime_factory/store.py +128 -0
- novacode_cli/prime_factory/worker.py +129 -0
- novacode_cli/prime_factory/workflow.py +899 -0
- novacode_cli/prime_factory/workspace.py +317 -0
- novacode_cli/prime_memory.py +290 -0
- novacode_cli/process_manager.py +585 -0
- novacode_cli/project_onboard.py +537 -0
- novacode_cli/prompts/System_Prompt_Nova.jinja +23 -0
- novacode_cli/prompts/__init__.py +168 -0
- novacode_cli/prompts/agent_definitions.jinja +11 -0
- novacode_cli/prompts/agent_generation.jinja +125 -0
- novacode_cli/prompts/async_agents/general_purpose.jinja +22 -0
- novacode_cli/prompts/claude_plan_mode.jinja +12 -0
- novacode_cli/prompts/coding_workflow.jinja +18 -0
- novacode_cli/prompts/computer_use.jinja +17 -0
- novacode_cli/prompts/core_agent_system.jinja +81 -0
- novacode_cli/prompts/delegation.jinja +15 -0
- novacode_cli/prompts/desktop_power.jinja +4 -0
- novacode_cli/prompts/file_paths.jinja +15 -0
- novacode_cli/prompts/file_tracker.jinja +23 -0
- novacode_cli/prompts/init_agents_md.jinja +56 -0
- novacode_cli/prompts/init_exploration.jinja +174 -0
- novacode_cli/prompts/init_semantic_orchestrate.jinja +37 -0
- novacode_cli/prompts/instruction_scope.jinja +5 -0
- novacode_cli/prompts/learnings_extraction.jinja +45 -0
- novacode_cli/prompts/longterm_memory.jinja +54 -0
- novacode_cli/prompts/mcp.jinja +84 -0
- novacode_cli/prompts/memory_consolidation.jinja +40 -0
- novacode_cli/prompts/nova_evolution.jinja +73 -0
- novacode_cli/prompts/nova_review.jinja +158 -0
- novacode_cli/prompts/nova_skill_debate.jinja +36 -0
- novacode_cli/prompts/nova_standing_instructions.jinja +26 -0
- novacode_cli/prompts/nova_verify.jinja +100 -0
- novacode_cli/prompts/onboard_dashboard.jinja +378 -0
- novacode_cli/prompts/plan_agent.jinja +87 -0
- novacode_cli/prompts/plan_scouts.jinja +5 -0
- novacode_cli/prompts/plan_storage.jinja +8 -0
- novacode_cli/prompts/planning.jinja +82 -0
- novacode_cli/prompts/ponytail/LICENSE +21 -0
- novacode_cli/prompts/ponytail/UPSTREAM.json +15 -0
- novacode_cli/prompts/ponytail/hooks/ponytail-config.js +175 -0
- novacode_cli/prompts/ponytail/hooks/ponytail-instructions.js +98 -0
- novacode_cli/prompts/ponytail/skills/ponytail/SKILL.md +52 -0
- novacode_cli/prompts/ponytail/skills/ponytail-audit/SKILL.md +103 -0
- novacode_cli/prompts/ponytail/skills/ponytail-debt/SKILL.md +44 -0
- novacode_cli/prompts/ponytail/skills/ponytail-gain/SKILL.md +52 -0
- novacode_cli/prompts/ponytail/skills/ponytail-help/SKILL.md +76 -0
- novacode_cli/prompts/ponytail/skills/ponytail-review/SKILL.md +101 -0
- novacode_cli/prompts/prompt_evolution.jinja +27 -0
- novacode_cli/prompts/ralph_iteration.jinja +75 -0
- novacode_cli/prompts/refine_gate.jinja +31 -0
- novacode_cli/prompts/refine_plan.jinja +64 -0
- novacode_cli/prompts/refine_review.jinja +34 -0
- novacode_cli/prompts/research_delivery.jinja +9 -0
- novacode_cli/prompts/research_swarm.jinja +130 -0
- novacode_cli/prompts/response_style.jinja +5 -0
- novacode_cli/prompts/session_summarization.jinja +86 -0
- novacode_cli/prompts/skill_creation.jinja +85 -0
- novacode_cli/prompts/subagents/fact_checker.jinja +48 -0
- novacode_cli/prompts/subagents/financial_analyst.jinja +50 -0
- novacode_cli/prompts/subagents/literature_reviewer.jinja +52 -0
- novacode_cli/prompts/subagents/market_analyst.jinja +48 -0
- novacode_cli/prompts/subagents/research_synthesizer.jinja +57 -0
- novacode_cli/prompts/subagents/technical_researcher.jinja +56 -0
- novacode_cli/prompts/subagents/web_researcher.jinja +46 -0
- novacode_cli/prompts/summarization.jinja +107 -0
- novacode_cli/prompts/summarization_answers.jinja +23 -0
- novacode_cli/prompts/summarization_questions.jinja +32 -0
- novacode_cli/prompts/vision_caption.jinja +21 -0
- novacode_cli/prompts/voice_summary.jinja +65 -0
- novacode_cli/prompts/wiki_file.jinja +57 -0
- novacode_cli/prompts/wiki_ingest.jinja +87 -0
- novacode_cli/recovery.py +383 -0
- novacode_cli/remote/__init__.py +45 -0
- novacode_cli/remote/approvals.py +282 -0
- novacode_cli/remote/async_task_clients.py +97 -0
- novacode_cli/remote/async_task_watcher.py +240 -0
- novacode_cli/remote/bridge.py +905 -0
- novacode_cli/remote/command_menu.py +26 -0
- novacode_cli/remote/command_ui.py +243 -0
- novacode_cli/remote/config.py +199 -0
- novacode_cli/remote/discord_bridge.py +530 -0
- novacode_cli/remote/discord_format.py +31 -0
- novacode_cli/remote/discord_threads.py +225 -0
- novacode_cli/remote/images.py +97 -0
- novacode_cli/remote/processor.py +601 -0
- novacode_cli/remote/rootapp_bot/bot.cjs +16 -0
- novacode_cli/remote/rootapp_bot/package-lock.json +2683 -0
- novacode_cli/remote/rootapp_bot/package.json +18 -0
- novacode_cli/remote/rootapp_bot/transport.cjs +80 -0
- novacode_cli/remote/rootapp_bridge.py +370 -0
- novacode_cli/remote/rootapp_setup.py +89 -0
- novacode_cli/remote/routing.py +103 -0
- novacode_cli/remote/scheduler.py +302 -0
- novacode_cli/remote/session.py +164 -0
- novacode_cli/remote/status.py +411 -0
- novacode_cli/remote/streaming.py +188 -0
- novacode_cli/remote/telegram_bridge.py +1118 -0
- novacode_cli/remote/telegram_format.py +215 -0
- novacode_cli/remote/telegram_hub.py +256 -0
- novacode_cli/remote/voice_notes.py +120 -0
- novacode_cli/remote/webhook_adapters.py +167 -0
- novacode_cli/remote/webhook_server.py +154 -0
- novacode_cli/rewind.py +150 -0
- novacode_cli/rooms/__init__.py +1 -0
- novacode_cli/rooms/bridge.py +86 -0
- novacode_cli/rooms/cli.py +231 -0
- novacode_cli/rooms/nova.py +227 -0
- novacode_cli/rooms/runtime.py +299 -0
- novacode_cli/rooms/store.py +538 -0
- novacode_cli/rooms/workspace.py +94 -0
- novacode_cli/security/__init__.py +29 -0
- novacode_cli/security/approval_context.py +45 -0
- novacode_cli/security/delegated_approval.py +68 -0
- novacode_cli/security/local_http.py +85 -0
- novacode_cli/security/middleware.py +87 -0
- novacode_cli/security/paths.py +35 -0
- novacode_cli/security/policy.py +535 -0
- novacode_cli/security/policy_writer.py +90 -0
- novacode_cli/security/prompt_injection.py +203 -0
- novacode_cli/security/remember.py +81 -0
- novacode_cli/security/rule_synthesis.py +116 -0
- novacode_cli/security/secret_files.py +61 -0
- novacode_cli/security/session_allow.py +114 -0
- novacode_cli/security/unicode_security.py +516 -0
- novacode_cli/security/validator.py +173 -0
- novacode_cli/server/__init__.py +9 -0
- novacode_cli/server/app.py +632 -0
- novacode_cli/server/event_adapter.py +189 -0
- novacode_cli/server/session_manager.py +90 -0
- novacode_cli/server_main.py +64 -0
- novacode_cli/server_runner/dev_server.py +530 -0
- novacode_cli/server_runner/test_runner.py +470 -0
- novacode_cli/session/__init__.py +1 -0
- novacode_cli/session/adapters/__init__.py +240 -0
- novacode_cli/session/adapters/claude_code.py +102 -0
- novacode_cli/session/adapters/codex.py +77 -0
- novacode_cli/session/adapters/harness_native.py +75 -0
- novacode_cli/session/checkpoint_coordinator.py +448 -0
- novacode_cli/session/context_restore.py +25 -0
- novacode_cli/session/history_export.py +228 -0
- novacode_cli/session/history_tree.py +174 -0
- novacode_cli/session/imported_context.py +267 -0
- novacode_cli/session/runtime_identity.py +32 -0
- novacode_cli/session/session_persistence.py +1168 -0
- novacode_cli/session/session_prompt_builder.py +279 -0
- novacode_cli/session/session_restore.py +351 -0
- novacode_cli/session/session_summarization.py +20 -0
- novacode_cli/session/transcript_journal.py +153 -0
- novacode_cli/sessions/__init__.py +11 -0
- novacode_cli/sessions/gateway.py +84 -0
- novacode_cli/sessions/launch.py +51 -0
- novacode_cli/sessions/lease.py +213 -0
- novacode_cli/sessions/messaging.py +255 -0
- novacode_cli/sessions/protocol.py +216 -0
- novacode_cli/sessions/resume.py +31 -0
- novacode_cli/sessions/supervisor.py +498 -0
- novacode_cli/sessions/tasks.py +73 -0
- novacode_cli/sessions/tui_messaging.py +413 -0
- novacode_cli/sessions/worker.py +652 -0
- novacode_cli/sessions/worktree.py +262 -0
- novacode_cli/shell/__init__.py +27 -0
- novacode_cli/shell/jobs.py +475 -0
- novacode_cli/shell/middleware.py +1568 -0
- novacode_cli/shell/os_sandbox.py +205 -0
- novacode_cli/shell/output.py +181 -0
- novacode_cli/shell/patterns.py +275 -0
- novacode_cli/shell/processes.py +87 -0
- novacode_cli/shell/utils.py +236 -0
- novacode_cli/skills/__init__.py +26 -0
- novacode_cli/skills/builtin/handoff/SKILL.md +15 -0
- novacode_cli/skills/curation_middleware.py +69 -0
- novacode_cli/skills/executable.py +161 -0
- novacode_cli/skills/libraries.py +102 -0
- novacode_cli/skills/load.py +248 -0
- novacode_cli/skills/prune.py +215 -0
- novacode_cli/skills/refreshing_middleware.py +896 -0
- novacode_cli/skills/retrieval.py +248 -0
- novacode_cli/skills/runtime.py +118 -0
- novacode_cli/skills/schema.py +254 -0
- novacode_cli/skills/skill_creation.py +1549 -0
- novacode_cli/skills/skill_lock.py +75 -0
- novacode_cli/skills/skill_system_prompt.py +16 -0
- novacode_cli/skills/skills_prefs.py +126 -0
- novacode_cli/skills/tool_resolver.py +31 -0
- novacode_cli/skills/upstream.py +50 -0
- novacode_cli/skills/versioning.py +291 -0
- novacode_cli/states/Session.py +847 -0
- novacode_cli/states/__init__.py +31 -0
- novacode_cli/states/slices/__init__.py +17 -0
- novacode_cli/states/slices/agent_runtime.py +249 -0
- novacode_cli/states/slices/background_tasks.py +21 -0
- novacode_cli/states/slices/notifications.py +74 -0
- novacode_cli/states/slices/remote_bridge.py +56 -0
- novacode_cli/states/slices/ui_settings.py +49 -0
- novacode_cli/states/slices/wiki.py +25 -0
- novacode_cli/teammates/__init__.py +1 -0
- novacode_cli/teammates/controller.py +557 -0
- novacode_cli/teammates/graph.py +104 -0
- novacode_cli/teammates/registry.py +175 -0
- novacode_cli/teammates/service.py +254 -0
- novacode_cli/teammates/worker.py +19 -0
- novacode_cli/teams/__init__.py +1 -0
- novacode_cli/teams/adapters/__init__.py +1 -0
- novacode_cli/teams/adapters/container.py +316 -0
- novacode_cli/teams/adapters/inprocess.py +206 -0
- novacode_cli/teams/adapters/process.py +364 -0
- novacode_cli/teams/bootstrap.py +246 -0
- novacode_cli/teams/container_git.py +67 -0
- novacode_cli/teams/context.py +34 -0
- novacode_cli/teams/coordinator.py +815 -0
- novacode_cli/teams/gateway.py +200 -0
- novacode_cli/teams/host.py +64 -0
- novacode_cli/teams/legacy.py +52 -0
- novacode_cli/teams/middleware.py +176 -0
- novacode_cli/teams/models.py +104 -0
- novacode_cli/teams/output.py +47 -0
- novacode_cli/teams/protocol.py +50 -0
- novacode_cli/teams/recovery.py +80 -0
- novacode_cli/teams/scheduler.py +44 -0
- novacode_cli/teams/store.py +631 -0
- novacode_cli/teams/worker.py +251 -0
- novacode_cli/teams/workspace.py +100 -0
- novacode_cli/token_utils.py +256 -0
- novacode_cli/tools/__init__.py +104 -0
- novacode_cli/tools/_shared.py +97 -0
- novacode_cli/tools/_types.py +24 -0
- novacode_cli/tools/artifact_tools.py +137 -0
- novacode_cli/tools/code_search_tools.py +330 -0
- novacode_cli/tools/computer_tools.py +77 -0
- novacode_cli/tools/cron_tools.py +65 -0
- novacode_cli/tools/daemon_tool.py +290 -0
- novacode_cli/tools/desktop_tools.py +161 -0
- novacode_cli/tools/fetch_tools.py +530 -0
- novacode_cli/tools/http_tools.py +279 -0
- novacode_cli/tools/inspection_tools.py +107 -0
- novacode_cli/tools/job_tools.py +143 -0
- novacode_cli/tools/knowledge_tools.py +427 -0
- novacode_cli/tools/memory_tools.py +461 -0
- novacode_cli/tools/memory_wiki_tools.py +40 -0
- novacode_cli/tools/notebook_tools.py +238 -0
- novacode_cli/tools/oracle_tool.py +83 -0
- novacode_cli/tools/plan_archive_tools.py +80 -0
- novacode_cli/tools/plan_mode_tools.py +315 -0
- novacode_cli/tools/python_kernel_loop.py +165 -0
- novacode_cli/tools/python_kernel_tool.py +222 -0
- novacode_cli/tools/reflection_tools.py +34 -0
- novacode_cli/tools/scraper_tools.py +377 -0
- novacode_cli/tools/skill_tools.py +275 -0
- novacode_cli/tools/speak_tool.py +51 -0
- novacode_cli/tools/store_memory_tools.py +227 -0
- novacode_cli/tools/ui_tools.py +62 -0
- novacode_cli/tools/waiter_tools.py +408 -0
- novacode_cli/tools/web_tools.py +349 -0
- novacode_cli/tools/wiki_tools.py +152 -0
- novacode_cli/tools/worktree_tools.py +219 -0
- novacode_cli/tracking/__init__.py +10 -0
- novacode_cli/tracking/file_tracker.py +826 -0
- novacode_cli/tracking/local_metrics.py +170 -0
- novacode_cli/tracking/loop_guard.py +507 -0
- novacode_cli/tracking/request_metrics.py +60 -0
- novacode_cli/tracking/tracing.py +692 -0
- novacode_cli/tracking/usage_tree.py +677 -0
- novacode_cli/tracking/workspace_anchoring.py +231 -0
- novacode_cli/tui/__init__.py +11 -0
- novacode_cli/tui/animation_rate.py +9 -0
- novacode_cli/tui/animations.py +332 -0
- novacode_cli/tui/app.py +19315 -0
- novacode_cli/tui/auth_display.py +87 -0
- novacode_cli/tui/auth_screens.py +826 -0
- novacode_cli/tui/avatar.py +294 -0
- novacode_cli/tui/avatar_frames.py +21 -0
- novacode_cli/tui/background_tasks.py +35 -0
- novacode_cli/tui/browser_settings_screen.py +70 -0
- novacode_cli/tui/caveman_screen.py +185 -0
- novacode_cli/tui/council_settings_screen.py +182 -0
- novacode_cli/tui/council_view.py +535 -0
- novacode_cli/tui/decision_settings.py +268 -0
- novacode_cli/tui/diff_preview.py +199 -0
- novacode_cli/tui/gc_tuning.py +63 -0
- novacode_cli/tui/handoff_screen.py +206 -0
- novacode_cli/tui/harness.py +244 -0
- novacode_cli/tui/history_tree_screen.py +179 -0
- novacode_cli/tui/home.py +328 -0
- novacode_cli/tui/home_scene.py +94 -0
- novacode_cli/tui/icons.py +81 -0
- novacode_cli/tui/interface_styles.tcss +327 -0
- novacode_cli/tui/matrix3.py +108 -0
- novacode_cli/tui/mcp_tools_screen.py +131 -0
- novacode_cli/tui/motion.py +178 -0
- novacode_cli/tui/output_body.py +136 -0
- novacode_cli/tui/output_buffer.py +59 -0
- novacode_cli/tui/palette.py +334 -0
- novacode_cli/tui/pickers.py +237 -0
- novacode_cli/tui/prime_panel.py +506 -0
- novacode_cli/tui/provider_signin.py +213 -0
- novacode_cli/tui/pty_shell.py +159 -0
- novacode_cli/tui/reference_screens.py +444 -0
- novacode_cli/tui/resume_picker.py +346 -0
- novacode_cli/tui/rooms.py +597 -0
- novacode_cli/tui/screens.py +7088 -0
- novacode_cli/tui/session_import.py +333 -0
- novacode_cli/tui/session_pane.py +242 -0
- novacode_cli/tui/session_tab.py +42 -0
- novacode_cli/tui/session_transcript.py +118 -0
- novacode_cli/tui/shell_output.py +7 -0
- novacode_cli/tui/stall_watch.py +174 -0
- novacode_cli/tui/statusline.py +40 -0
- novacode_cli/tui/statusline_screen.py +91 -0
- novacode_cli/tui/teammate_updates.py +162 -0
- novacode_cli/tui/teammates.py +548 -0
- novacode_cli/tui/terminal.py +289 -0
- novacode_cli/tui/terminal_view.py +235 -0
- novacode_cli/tui/themes.py +118 -0
- novacode_cli/tui/update_notice.py +84 -0
- novacode_cli/tui/voice_downloads.py +113 -0
- novacode_cli/tui/widgets.py +2038 -0
- novacode_cli/tui/windows_input.py +38 -0
- novacode_cli/tui/workspace_approval.py +165 -0
- novacode_cli/ui/council_web.py +113 -0
- novacode_cli/ui/council_workspace.py +72 -0
- novacode_cli/ui/cowork_web.py +41 -0
- novacode_cli/ui/diff_highlight.py +160 -0
- novacode_cli/ui/execution.py +1396 -0
- novacode_cli/ui/exit_summary.py +65 -0
- novacode_cli/ui/hitl_approval.py +196 -0
- novacode_cli/ui/input_preparation.py +2 -0
- novacode_cli/ui/interrupt_handlers.py +215 -0
- novacode_cli/ui/question_prompt.py +151 -0
- novacode_cli/ui/status_phrases.py +157 -0
- novacode_cli/ui/stream_preview.py +66 -0
- novacode_cli/ui/streaming.py +2 -0
- novacode_cli/ui/subagent_tracking.py +2 -0
- novacode_cli/ui/ui_elements.py +1585 -0
- novacode_cli/ui/web_workspace.py +244 -0
- novacode_cli/ui_events.py +299 -0
- novacode_cli/update_ui.py +243 -0
- novacode_cli/updates.py +489 -0
- novacode_cli/utils/backend_patches.py +399 -0
- novacode_cli/utils/backend_paths.py +467 -0
- novacode_cli/utils/lazy_providers.py +51 -0
- novacode_cli/utils/model_info.py +223 -0
- novacode_cli/utils/pdf_extraction.py +183 -0
- novacode_cli/utils/startup.py +29 -0
- novacode_cli/utils/tasks.py +42 -0
- novacode_cli/utils/windows.py +9 -0
- novacode_cli/vixie/hook_adapter.py +127 -0
- novacode_cli/vixie/server.py +375 -0
- novacode_cli/wiki/__init__.py +15 -0
- novacode_cli/wiki/ask.py +56 -0
- novacode_cli/wiki/file.py +71 -0
- novacode_cli/wiki/ingest.py +184 -0
- novacode_cli/wiki/manager.py +261 -0
- novacode_cli-1.2.0.dist-info/METADATA +271 -0
- novacode_cli-1.2.0.dist-info/RECORD +691 -0
- novacode_cli-1.2.0.dist-info/WHEEL +5 -0
- novacode_cli-1.2.0.dist-info/entry_points.txt +2 -0
- novacode_cli-1.2.0.dist-info/licenses/LICENSE +21 -0
- novacode_cli-1.2.0.dist-info/top_level.txt +1 -0
|
@@ -0,0 +1,370 @@
|
|
|
1
|
+
"""Version-aware research receipts from host-controlled document retrieval."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import hashlib
|
|
6
|
+
import importlib.metadata
|
|
7
|
+
import ipaddress
|
|
8
|
+
import json
|
|
9
|
+
import re
|
|
10
|
+
import socket
|
|
11
|
+
import time
|
|
12
|
+
import tomllib
|
|
13
|
+
from collections.abc import Callable, Iterable
|
|
14
|
+
from dataclasses import dataclass
|
|
15
|
+
from http import HTTPStatus
|
|
16
|
+
from itertools import islice
|
|
17
|
+
from typing import TYPE_CHECKING
|
|
18
|
+
from urllib.parse import urljoin, urlsplit
|
|
19
|
+
|
|
20
|
+
if TYPE_CHECKING:
|
|
21
|
+
from pathlib import Path
|
|
22
|
+
|
|
23
|
+
from novacode_cli.prime_factory.knowledge import MAX_BYTES, KnowledgeIndex, Record
|
|
24
|
+
from novacode_cli.prime_memory import DEPENDENCIES, MAX_FILE_BYTES, safe_text
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
@dataclass(frozen=True)
|
|
28
|
+
class FetchResult:
|
|
29
|
+
"""A transport's observed response; model summaries are not fetch receipts."""
|
|
30
|
+
|
|
31
|
+
url: str
|
|
32
|
+
status: int
|
|
33
|
+
content: str
|
|
34
|
+
version: str
|
|
35
|
+
official: bool = False
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
Fetcher = Callable[[str], FetchResult]
|
|
39
|
+
MAX_REDIRECTS = 5
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
def make_fetcher(
|
|
43
|
+
version: str, *, authorize: Callable[[str], bool], dependency: str = ""
|
|
44
|
+
) -> Fetcher:
|
|
45
|
+
"""Create a bounded transport after the originating host grants each URL.
|
|
46
|
+
|
|
47
|
+
A configured URL policy is still enforced even when the host grants a URL.
|
|
48
|
+
Version identity must appear in the fetched page or URL; absent evidence
|
|
49
|
+
returns an empty version and cannot satisfy the research gate.
|
|
50
|
+
"""
|
|
51
|
+
import httpx
|
|
52
|
+
|
|
53
|
+
from novacode_cli.security.policy import get_policy
|
|
54
|
+
from novacode_cli.security.unicode_security import check_url_safety
|
|
55
|
+
from novacode_cli.tools.web_tools import _DOCS_SITES
|
|
56
|
+
|
|
57
|
+
def fetch_document(url: str) -> FetchResult:
|
|
58
|
+
target = url
|
|
59
|
+
with httpx.Client(
|
|
60
|
+
timeout=15,
|
|
61
|
+
follow_redirects=False,
|
|
62
|
+
trust_env=False,
|
|
63
|
+
limits=httpx.Limits(max_keepalive_connections=0),
|
|
64
|
+
) as client:
|
|
65
|
+
for _ in range(MAX_REDIRECTS + 1):
|
|
66
|
+
ResearchLedger._url(target)
|
|
67
|
+
parsed = urlsplit(target)
|
|
68
|
+
if (
|
|
69
|
+
not check_url_safety(target).safe
|
|
70
|
+
or get_policy().evaluate("fetch_url", {"url": target}).tier == "deny"
|
|
71
|
+
or not authorize(target)
|
|
72
|
+
):
|
|
73
|
+
msg = "Documentation URL requires host authorization"
|
|
74
|
+
raise ValueError(msg)
|
|
75
|
+
addresses = socket.getaddrinfo(
|
|
76
|
+
parsed.hostname,
|
|
77
|
+
parsed.port or (443 if parsed.scheme == "https" else 80),
|
|
78
|
+
type=socket.SOCK_STREAM,
|
|
79
|
+
)
|
|
80
|
+
if not addresses or any(
|
|
81
|
+
not ipaddress.ip_address(address[4][0]).is_global for address in addresses
|
|
82
|
+
):
|
|
83
|
+
msg = "Documentation URL must resolve to public network addresses"
|
|
84
|
+
raise ValueError(msg)
|
|
85
|
+
# Pin the checked address while keeping Host, SNI and certificate
|
|
86
|
+
# verification on the authorized origin. A second DNS lookup can rebind.
|
|
87
|
+
connection_url = httpx.URL(target).copy_with(host=addresses[0][4][0])
|
|
88
|
+
with client.stream(
|
|
89
|
+
"GET",
|
|
90
|
+
connection_url,
|
|
91
|
+
headers={"Host": parsed.netloc},
|
|
92
|
+
extensions={"sni_hostname": parsed.hostname},
|
|
93
|
+
) as response:
|
|
94
|
+
if response.is_redirect:
|
|
95
|
+
target = urljoin(target, response.headers.get("location", ""))
|
|
96
|
+
continue
|
|
97
|
+
chunks = bytearray()
|
|
98
|
+
for chunk in response.iter_bytes():
|
|
99
|
+
chunks.extend(chunk)
|
|
100
|
+
if len(chunks) > MAX_BYTES:
|
|
101
|
+
msg = "Documentation exceeds content bound"
|
|
102
|
+
raise ValueError(msg)
|
|
103
|
+
content = chunks.decode(response.encoding or "utf-8", errors="replace")
|
|
104
|
+
marker = re.compile(r"(?<![\w.])v?" + re.escape(version) + r"(?![\w.])")
|
|
105
|
+
observed_version = (
|
|
106
|
+
version if version and marker.search(target + "\n" + content) else ""
|
|
107
|
+
)
|
|
108
|
+
official_sites = _DOCS_SITES.get(dependency.lower(), [])[:1]
|
|
109
|
+
official = any(parsed.hostname == site.split("/")[0] for site in official_sites)
|
|
110
|
+
return FetchResult(
|
|
111
|
+
target, response.status_code, content, observed_version, official
|
|
112
|
+
)
|
|
113
|
+
msg = "Documentation exceeded redirect limit"
|
|
114
|
+
raise ValueError(msg)
|
|
115
|
+
|
|
116
|
+
return fetch_document
|
|
117
|
+
|
|
118
|
+
|
|
119
|
+
class ResearchLedger:
|
|
120
|
+
"""Persist sources locally and block dependent work without current documentation."""
|
|
121
|
+
|
|
122
|
+
def __init__(self, root: Path, directory: Path | None = None) -> None:
|
|
123
|
+
"""Use the repository's versioned knowledge storage."""
|
|
124
|
+
self.index = KnowledgeIndex(root, directory)
|
|
125
|
+
self._validated: set[str] = set()
|
|
126
|
+
self._exempt = False
|
|
127
|
+
self.environment = self.inspect_environment()
|
|
128
|
+
|
|
129
|
+
def inspect_environment(
|
|
130
|
+
self,
|
|
131
|
+
dependencies: Iterable[str] = (),
|
|
132
|
+
*,
|
|
133
|
+
environment_path: Path | None = None,
|
|
134
|
+
) -> Record:
|
|
135
|
+
"""Inspect lockfiles before installed metadata, without importing dependencies."""
|
|
136
|
+
versions: dict[str, str] = {}
|
|
137
|
+
lock = self.index.root / "uv.lock"
|
|
138
|
+
if lock.is_file() and lock.stat().st_size <= MAX_FILE_BYTES:
|
|
139
|
+
parsed = tomllib.loads(lock.read_text(encoding="utf-8"))
|
|
140
|
+
versions.update(
|
|
141
|
+
(entry["name"], entry["version"])
|
|
142
|
+
for entry in parsed.get("package", [])
|
|
143
|
+
if isinstance(entry.get("name"), str) and isinstance(entry.get("version"), str)
|
|
144
|
+
)
|
|
145
|
+
package_lock = self.index.root / "package-lock.json"
|
|
146
|
+
if package_lock.is_file() and package_lock.stat().st_size <= MAX_FILE_BYTES:
|
|
147
|
+
parsed = json.loads(package_lock.read_text(encoding="utf-8"))
|
|
148
|
+
versions.update(
|
|
149
|
+
(name.removeprefix("node_modules/"), entry["version"])
|
|
150
|
+
for name, entry in parsed.get("packages", {}).items()
|
|
151
|
+
if name.startswith("node_modules/") and isinstance(entry.get("version"), str)
|
|
152
|
+
)
|
|
153
|
+
installed: dict[str, str | None] = {}
|
|
154
|
+
isolated: dict[str, str] = {}
|
|
155
|
+
if environment_path is not None:
|
|
156
|
+
search = [
|
|
157
|
+
environment_path / "Lib" / "site-packages",
|
|
158
|
+
*sorted(environment_path.glob("lib/python*/site-packages")),
|
|
159
|
+
]
|
|
160
|
+
distributions = importlib.metadata.distributions(path=[str(path) for path in search])
|
|
161
|
+
for number, distribution in enumerate(islice(distributions, 1025)):
|
|
162
|
+
if number >= 1024: # noqa: PLR2004 - Bound execution-environment metadata enumeration.
|
|
163
|
+
message = "Execution environment exceeds package metadata bound"
|
|
164
|
+
raise ValueError(message)
|
|
165
|
+
package = distribution.metadata["Name"]
|
|
166
|
+
if package:
|
|
167
|
+
isolated[re.sub(r"[-_.]+", "-", package).lower()] = distribution.version
|
|
168
|
+
for name in sorted(set(dependencies)):
|
|
169
|
+
if environment_path is not None:
|
|
170
|
+
installed[name] = isolated.get(re.sub(r"[-_.]+", "-", name).lower())
|
|
171
|
+
continue
|
|
172
|
+
try:
|
|
173
|
+
installed[name] = importlib.metadata.version(name)
|
|
174
|
+
except importlib.metadata.PackageNotFoundError:
|
|
175
|
+
installed[name] = None
|
|
176
|
+
fingerprints = {
|
|
177
|
+
name: self.index.fingerprint(name)
|
|
178
|
+
for name in DEPENDENCIES
|
|
179
|
+
if (self.index.root / name).is_file()
|
|
180
|
+
}
|
|
181
|
+
return {
|
|
182
|
+
"locked_versions": versions,
|
|
183
|
+
"installed_versions": installed,
|
|
184
|
+
"fingerprints": fingerprints,
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
@staticmethod
|
|
188
|
+
def _url(url: str) -> None:
|
|
189
|
+
parsed = urlsplit(url)
|
|
190
|
+
if (
|
|
191
|
+
parsed.scheme not in {"https", "http"}
|
|
192
|
+
or not parsed.hostname
|
|
193
|
+
or parsed.username
|
|
194
|
+
or parsed.password
|
|
195
|
+
):
|
|
196
|
+
msg = "Research requires a credential-free HTTP documentation URL"
|
|
197
|
+
raise ValueError(msg)
|
|
198
|
+
if safe_text(url, len(url)) != url:
|
|
199
|
+
msg = "Research URL contains excluded credentials"
|
|
200
|
+
raise ValueError(msg)
|
|
201
|
+
|
|
202
|
+
def fetch(
|
|
203
|
+
self,
|
|
204
|
+
url: str,
|
|
205
|
+
*,
|
|
206
|
+
dependency: str,
|
|
207
|
+
version: str,
|
|
208
|
+
excerpt: str,
|
|
209
|
+
decisions: list[str],
|
|
210
|
+
fetcher: Fetcher,
|
|
211
|
+
) -> Record:
|
|
212
|
+
"""Accept a real successful response only through the authorized host fetcher.
|
|
213
|
+
|
|
214
|
+
The caller supplies a transport that already enforces Nova's network policy.
|
|
215
|
+
This layer never opens sockets or treats retrieved instructions as authority.
|
|
216
|
+
"""
|
|
217
|
+
self._url(url)
|
|
218
|
+
result = fetcher(url)
|
|
219
|
+
if not isinstance(result, FetchResult):
|
|
220
|
+
msg = "Research needs a host-observed fetch receipt"
|
|
221
|
+
raise TypeError(msg)
|
|
222
|
+
self._url(result.url)
|
|
223
|
+
if (
|
|
224
|
+
result.status != HTTPStatus.OK
|
|
225
|
+
or not result.content
|
|
226
|
+
or len(result.content.encode()) > MAX_BYTES
|
|
227
|
+
):
|
|
228
|
+
msg = "Documentation fetch unavailable or exceeds content bound"
|
|
229
|
+
raise ValueError(msg)
|
|
230
|
+
if not dependency.strip() or not version.strip() or result.version != version:
|
|
231
|
+
msg = "Documentation version mismatch"
|
|
232
|
+
raise ValueError(msg)
|
|
233
|
+
if (
|
|
234
|
+
not excerpt.strip()
|
|
235
|
+
or excerpt not in result.content
|
|
236
|
+
or not decisions
|
|
237
|
+
or not all(decisions)
|
|
238
|
+
):
|
|
239
|
+
msg = "Documentation requires a fetched excerpt and supported decisions"
|
|
240
|
+
raise ValueError(msg)
|
|
241
|
+
environment = self.inspect_environment([dependency])
|
|
242
|
+
locked = environment["locked_versions"].get(dependency)
|
|
243
|
+
installed = environment["installed_versions"].get(dependency)
|
|
244
|
+
if (locked is not None and locked != version) or (
|
|
245
|
+
installed is not None and installed != version
|
|
246
|
+
):
|
|
247
|
+
msg = "Documentation does not match locked or installed dependency version"
|
|
248
|
+
raise ValueError(msg)
|
|
249
|
+
identity = hashlib.sha256(f"{dependency}\0{version}\0{url}".encode()).hexdigest()
|
|
250
|
+
record = self.index.put(
|
|
251
|
+
"source",
|
|
252
|
+
identity,
|
|
253
|
+
{
|
|
254
|
+
"requested_url": url,
|
|
255
|
+
"url": result.url,
|
|
256
|
+
"status": result.status,
|
|
257
|
+
"dependency": dependency,
|
|
258
|
+
"dependency_version": version,
|
|
259
|
+
"retrieved_at": time.time(),
|
|
260
|
+
"content_digest": hashlib.sha256(result.content.encode()).hexdigest(),
|
|
261
|
+
"excerpt": safe_text(excerpt),
|
|
262
|
+
"decisions": [safe_text(decision) for decision in decisions],
|
|
263
|
+
"official": result.official,
|
|
264
|
+
"untrusted": True,
|
|
265
|
+
},
|
|
266
|
+
fingerprints=environment["fingerprints"],
|
|
267
|
+
)
|
|
268
|
+
self._validated.add(identity)
|
|
269
|
+
return record
|
|
270
|
+
|
|
271
|
+
def exempt(self, reason: str) -> Record:
|
|
272
|
+
"""Explicitly record why a repository-only task needs no external API research."""
|
|
273
|
+
if not reason.strip():
|
|
274
|
+
msg = "Repository-only research exemption needs a reason"
|
|
275
|
+
raise ValueError(msg)
|
|
276
|
+
record = self.index.put("finding", "research_exemption", {"reason": safe_text(reason)})
|
|
277
|
+
self._exempt = True
|
|
278
|
+
return record
|
|
279
|
+
|
|
280
|
+
def validate(self, requirements: dict[str, str]) -> list[str]:
|
|
281
|
+
"""Return blockers; search snippets and stale/version-mismatched sources cannot pass."""
|
|
282
|
+
sources = self.index.records("source")
|
|
283
|
+
blockers = []
|
|
284
|
+
environment = self.inspect_environment(requirements)
|
|
285
|
+
for dependency, version in sorted(requirements.items()):
|
|
286
|
+
if any(
|
|
287
|
+
versions.get(dependency) not in {None, version}
|
|
288
|
+
for versions in (environment["locked_versions"], environment["installed_versions"])
|
|
289
|
+
):
|
|
290
|
+
blockers.append(f"Documentation version mismatch: {dependency} {version}")
|
|
291
|
+
continue
|
|
292
|
+
matching = [
|
|
293
|
+
source
|
|
294
|
+
for source in sources
|
|
295
|
+
if source["content"].get("dependency") == dependency
|
|
296
|
+
and source["id"] in self._validated
|
|
297
|
+
and source["content"].get("dependency_version") == version
|
|
298
|
+
and source["content"].get("status") == HTTPStatus.OK
|
|
299
|
+
and source["content"].get("excerpt")
|
|
300
|
+
and source["content"].get("decisions")
|
|
301
|
+
and self.index.current(source)
|
|
302
|
+
and source["fingerprints"] == environment["fingerprints"]
|
|
303
|
+
]
|
|
304
|
+
if not matching:
|
|
305
|
+
blockers.append(f"Required documentation unavailable: {dependency} {version}")
|
|
306
|
+
if not requirements and not self._exempt:
|
|
307
|
+
blockers.append("Record a repository-only research exemption or required dependencies")
|
|
308
|
+
return blockers
|
|
309
|
+
|
|
310
|
+
def revalidate_source(self, source_record: Record, fetcher: Fetcher) -> bool:
|
|
311
|
+
"""Revalidate one approved source without changing its original provenance.
|
|
312
|
+
|
|
313
|
+
Changed content needs a new research and approval decision. In particular,
|
|
314
|
+
a fresh retrieval time cannot silently alter the approved plan identity.
|
|
315
|
+
"""
|
|
316
|
+
identity = source_record["id"]
|
|
317
|
+
self._validated.discard(identity)
|
|
318
|
+
content = source_record["content"]
|
|
319
|
+
expected_identity = hashlib.sha256(
|
|
320
|
+
f"{content['dependency']}\0{content['dependency_version']}\0{content['requested_url']}".encode()
|
|
321
|
+
).hexdigest()
|
|
322
|
+
if (
|
|
323
|
+
source_record.get("version") != 1
|
|
324
|
+
or source_record.get("kind") != "source"
|
|
325
|
+
or identity != expected_identity
|
|
326
|
+
):
|
|
327
|
+
msg = "Invalid documentation source identity"
|
|
328
|
+
raise ValueError(msg)
|
|
329
|
+
self._url(content["requested_url"])
|
|
330
|
+
result = fetcher(content["requested_url"])
|
|
331
|
+
if isinstance(result, FetchResult):
|
|
332
|
+
self._url(result.url)
|
|
333
|
+
environment = self.inspect_environment([content["dependency"]])
|
|
334
|
+
if (
|
|
335
|
+
not isinstance(result, FetchResult)
|
|
336
|
+
or result.status != HTTPStatus.OK
|
|
337
|
+
or result.url != content["url"]
|
|
338
|
+
or result.version != content["dependency_version"]
|
|
339
|
+
or not result.content
|
|
340
|
+
or len(result.content.encode()) > MAX_BYTES
|
|
341
|
+
or hashlib.sha256(result.content.encode()).hexdigest() != content["content_digest"]
|
|
342
|
+
or not self.index.current(source_record)
|
|
343
|
+
or source_record["fingerprints"] != environment["fingerprints"]
|
|
344
|
+
or any(
|
|
345
|
+
versions.get(content["dependency"]) not in {None, content["dependency_version"]}
|
|
346
|
+
for versions in (environment["locked_versions"], environment["installed_versions"])
|
|
347
|
+
)
|
|
348
|
+
):
|
|
349
|
+
msg = f"Documentation changed or unavailable: {content['url']}"
|
|
350
|
+
raise ValueError(msg)
|
|
351
|
+
self.index.put(
|
|
352
|
+
"source",
|
|
353
|
+
identity,
|
|
354
|
+
content,
|
|
355
|
+
sources=tuple(source_record["sources"]),
|
|
356
|
+
links=tuple((link[0], link[1]) for link in source_record["links"]),
|
|
357
|
+
fingerprints=source_record["fingerprints"],
|
|
358
|
+
)
|
|
359
|
+
self._validated.add(identity)
|
|
360
|
+
return True
|
|
361
|
+
|
|
362
|
+
def revalidate(self, fetcher: Fetcher) -> list[str]:
|
|
363
|
+
"""Fetch reused sources again; changed/unavailable content blocks dependent work."""
|
|
364
|
+
blockers = []
|
|
365
|
+
for source in self.index.records("source"):
|
|
366
|
+
try:
|
|
367
|
+
self.revalidate_source(source, fetcher)
|
|
368
|
+
except (OSError, ValueError) as exc:
|
|
369
|
+
blockers.append(f"Documentation revalidation unavailable: {source['id']}: {exc}")
|
|
370
|
+
return blockers
|