shotgun-sh 0.1.0.dev27__py3-none-any.whl → 0.1.0.dev29__py3-none-any.whl

shotgun/agents/agent_manager.py

@@ -270,6 +270,9 @@ class AgentManager(Widget):
         if deps is None:
             raise ValueError("AgentDeps must be provided")
 
+        # Clear file tracker before each run to track only this run's operations
+        deps.file_tracker.clear()
+
         if prompt:
             self.ui_message_history.append(ModelRequest.user_text_prompt(prompt))
         self._post_messages_updated()

shotgun/agents/tools/web_search/anthropic.py

@@ -90,16 +90,13 @@ def anthropic_web_search_tool(query: str) -> str:
 
 def main() -> None:
     """Main function for testing the Anthropic web search tool."""
-    import logging
     import os
     import sys
 
-    # Set up basic console logging for testing
-    logging.basicConfig(
-        level=logging.DEBUG,
-        format="%(asctime)s | %(levelname)-8s | %(name)s | %(message)s",
-        stream=sys.stdout,
-    )
+    from shotgun.logging_config import setup_logger
+
+    # Use project's logging configuration instead of basicConfig
+    setup_logger(__name__)
 
     if len(sys.argv) < 2:
         print(

shotgun/logging_config.py

@@ -158,6 +158,27 @@ def setup_logger(
     return logger
 
 
+def get_early_logger(name: str) -> logging.Logger:
+    """Get a logger with NullHandler for early initialization.
+
+    Use this for loggers created at module import time, before
+    configure_root_logger() is called. The NullHandler prevents
+    Python from automatically adding a StreamHandler when WARNING
+    or ERROR messages are logged.
+
+    Args:
+        name: Logger name (typically __name__)
+
+    Returns:
+        Logger with NullHandler attached
+    """
+    logger = logging.getLogger(name)
+    # Only add NullHandler if no handlers exist
+    if not logger.handlers:
+        logger.addHandler(logging.NullHandler())
+    return logger
+
+
 def get_logger(name: str) -> logging.Logger:
     """Get a logger instance with default configuration.
 

shotgun/main.py

@@ -1,5 +1,14 @@
 """Main CLI application for shotgun."""
 
+import logging
+
+# CRITICAL: Add NullHandler to root logger before ANY other imports.
+# This prevents Python from automatically adding a StreamHandler when
+# WARNING/ERROR messages are logged by modules during import.
+# DO NOT MOVE THIS BELOW OTHER IMPORTS.
+logging.getLogger().addHandler(logging.NullHandler())
+
+# ruff: noqa: E402 (module import not at top - intentionally after NullHandler setup)
 from typing import Annotated
 
 import typer

shotgun/posthog_telemetry.py

@@ -1,10 +1,12 @@
 """PostHog analytics setup for Shotgun."""
 
-import logging
 import os
 from typing import Any
 
-logger = logging.getLogger(__name__)
+from shotgun.logging_config import get_early_logger
+
+# Use early logger to prevent automatic StreamHandler creation
+logger = get_early_logger(__name__)
 
 # Global PostHog client instance
 _posthog_client = None

shotgun/prompts/agents/tasks.j2

@@ -19,14 +19,22 @@ Your job is to help create and manage actionable tasks for software projects and
 
 **CRITICAL**: Your output will be consumed by AI coding agents (Claude Code, Cursor, Windsurf, etc.)
 - These agents already know how to code - don't teach programming concepts
+- Each task MUST have a checkbox `[ ]` for tracking completion
 - Each task should be a specific file modification or creation
-- Format: "In [file path], [add/modify/delete] [specific code/feature]"
+- Format each task as: `- [ ] In [file path], [add/modify/delete] [specific code/feature]`
 - Include acceptance criteria as executable commands (npm test, curl endpoints)
 - Reference specific line numbers or function names when modifying existing code
 - Break complex features into atomic, single-file tasks when possible
 - Include validation steps that can be automated
 - Every task should be immediately executable by an AI agent without interpretation
 
+Example task format:
+```markdown
+- [ ] In src/api/auth.py, add JWT token validation to authenticate() function
+- [ ] In tests/test_auth.py, add unit tests for JWT validation (must achieve 80% coverage)
+- [ ] In docs/API.md, update authentication section with JWT token requirements
+```
+
 ## TASK MANAGEMENT WORKFLOW
 
 For task management:
@@ -36,16 +44,45 @@ For task management:
 4. **Create structured tasks**: Use `write_file("tasks.md", content)` to save organized tasks
 5. **Build incrementally**: Update and refine tasks based on new information
 
+## TASK FORMAT
+
+**CRITICAL**: All tasks MUST use checkbox format for tracking completion:
+- Use `[ ]` for incomplete tasks
+- Use `[X]` for completed tasks
+- Include instructions at the top of tasks.md explaining how to mark tasks complete
+
 ## TASK FILE STRUCTURE
 
-Organize tasks into logical sections in tasks.md:
-- **Backlog** - Prioritized list of tasks to be done
-- **In Progress** - Current active tasks and status
-- **Done** - Completed tasks for reference
-- **Blocked** - Tasks waiting on dependencies or decisions
+Start tasks.md with these instructions:
+```markdown
+# Task Management
+
+## Instructions
+- Mark tasks as complete by replacing `[ ]` with `[X]`
+- Tasks without an `[X]` are not finished yet
+```
+
+Then organize tasks into logical sections:
+```markdown
+## Backlog
+- [ ] Task description with clear action
+- [ ] Another specific task to complete
+
+## In Progress
+- [ ] Currently working on this task
+- [ ] Task being actively developed
+
+## Done
+- [X] Completed task for reference
+- [X] Another finished task
+
+## Blocked
+- [ ] Task waiting on dependency (blocked by: reason)
+```
 
 ## TASK CREATION PRINCIPLES
 
+- **ALWAYS use checkbox format `[ ]` for every task**
 - Base tasks on available research findings and plan requirements
 - Create specific, actionable tasks with clear acceptance criteria
 - Include effort estimates and priority levels when possible
@@ -55,7 +92,8 @@ Organize tasks into logical sections in tasks.md:
 - Include both development and testing/validation tasks
 - Break down complex work into manageable chunks
 - Keep tasks.md as the single source of truth
-- Use clear task IDs or numbers for tracking
+- Group related tasks under clear section headings
+- Mark completed tasks with `[X]` when updating the file
 
 {% if interactive_mode %}
 USER INTERACTION - ASK CLARIFYING QUESTIONS:

shotgun/sentry_telemetry.py

@@ -1,9 +1,11 @@
 """Sentry observability setup for Shotgun."""
 
-import logging
 import os
 
-logger = logging.getLogger(__name__)
+from shotgun.logging_config import get_early_logger
+
+# Use early logger to prevent automatic StreamHandler creation
+logger = get_early_logger(__name__)
 
 
 def setup_sentry_observability() -> bool:

shotgun/telemetry.py

@@ -1,11 +1,12 @@
 """Observability setup for Logfire."""
 
-import logging
 import os
 
+from shotgun.logging_config import get_early_logger
 from shotgun.utils.env_utils import is_falsy, is_truthy
 
-logger = logging.getLogger(__name__)
+# Use early logger to prevent automatic StreamHandler creation
+logger = get_early_logger(__name__)
 
 
 def setup_logfire_observability() -> bool:

shotgun/tui/screens/chat.py

@@ -760,6 +760,7 @@ def codebase_indexed_hint(codebase_name: str) -> str:
 
 def help_text_with_codebase() -> str:
     return (
+        "Howdy! Welcome to Shotgun - the context tool for software engineering. \n\nYou can research, build specs, plan, create tasks, and export context to your favorite code-gen agents.\n\n"
         "I can help with:\n\n"
         "- Speccing out a new feature\n"
         "- Onboarding you onto this project\n"
@@ -770,6 +771,7 @@ def help_text_with_codebase() -> str:
 
 def help_text_empty_dir() -> str:
     return (
+        "Howdy! Welcome to Shotgun - the context tool for software engineering.\n\nYou can research, build specs, plan, create tasks, and export context to your favorite code-gen agents.\n\n"
         "What would you like to build? Here are some examples:\n\n"
         "- Research FastAPI vs Django\n"
         "- Plan my new web app using React\n"

{shotgun_sh-0.1.0.dev27.dist-info → shotgun_sh-0.1.0.dev29.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shotgun-sh
-Version: 0.1.0.dev27
+Version: 0.1.0.dev29
 Summary: AI-powered research, planning, and task management CLI tool
 Project-URL: Homepage, https://shotgun.sh/
 Project-URL: Repository, https://github.com/shotgun-sh/shotgun

{shotgun_sh-0.1.0.dev27.dist-info → shotgun_sh-0.1.0.dev29.dist-info}/RECORD

@@ -1,13 +1,13 @@
 shotgun/__init__.py,sha256=P40K0fnIsb7SKcQrFnXZ4aREjpWchVDhvM1HxI4cyIQ,104
 shotgun/build_constants.py,sha256=RXNxMz46HaB5jucgMVpw8a2yCJqjbhTOh0PddyEVMN8,713
-shotgun/logging_config.py,sha256=qWPTKu6IhaA_qiHQFhx8zTphm6oHMZFXox2nieyV32M,6795
-shotgun/main.py,sha256=dW8eqWZM7NAmzkuglZWdJeAzHiKbLKnnUw5V698X4GM,5112
-shotgun/posthog_telemetry.py,sha256=7drAXtedvZmpPqq4_9dI19kJ_xEHGk7XKXQk797QvCM,4954
+shotgun/logging_config.py,sha256=UKenihvgH8OA3W0b8ZFcItYaFJVe9MlsMYlcevyW1HY,7440
+shotgun/main.py,sha256=5WEtPs5kwD1tdeWCnM-jIAwarcwQNc4dhaqdPKCyxug,5510
+shotgun/posthog_telemetry.py,sha256=usfaJ8VyqckLIbLgoj2yhuNyDh0VWA5EJPRr7a0dyVs,5054
 shotgun/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-shotgun/sentry_telemetry.py,sha256=3r9on0GQposn9aX6Dkb9mrfaVQl_dIZzhu9BjE838AU,2854
-shotgun/telemetry.py,sha256=aBwCRFU97oiIK5K13OhT7yYCQUAVQyrvnoG-aX3k2ZE,3109
+shotgun/sentry_telemetry.py,sha256=0W0o810ewFpIcdPsi_q4uKLiaP6zDYRRE5MHpIbQIPo,2954
+shotgun/telemetry.py,sha256=Ves6Ih3hshpKVNVAUUmwRdtW8NkTjFPg8hEqvFKZ0t0,3208
 shotgun/agents/__init__.py,sha256=8Jzv1YsDuLyNPFJyckSr_qI4ehTVeDyIMDW4omsfPGc,25
-shotgun/agents/agent_manager.py,sha256=Tz20_cmCQhuUOIyr3rGrtvN_XBAYBZNuzhXBo-BFngQ,22349
+shotgun/agents/agent_manager.py,sha256=zfGlZGb7A6ZRvTtHaJa9_mFnL_myc52wNbkdVS8Bfxk,22465
 shotgun/agents/common.py,sha256=vt7ECq1rT6GR5Rt63t0whH0R0cydrk7Mty2KyPL8mEg,19045
 shotgun/agents/conversation_history.py,sha256=5J8_1yxdZiiWTq22aDio88DkBDZ4_Lh_p5Iy5_ENszc,3898
 shotgun/agents/conversation_manager.py,sha256=fxAvXbEl3Cl2ugJ4N9aWXaqZtkrnfj3QzwjWC4LFXwI,3514
@@ -43,7 +43,7 @@ shotgun/agents/tools/codebase/models.py,sha256=8eR3_8DQiBNgB2twu0aC_evIJbugN9KW3
 shotgun/agents/tools/codebase/query_graph.py,sha256=vOeyN4-OZj-vpTSk3Z9W5TjraZAepJ-Qjk_zzvum3fU,2115
 shotgun/agents/tools/codebase/retrieve_code.py,sha256=2VjiqVKJMd9rPV-mGrL4C-N8fqGjYLW6ZInFGbcTxOM,2878
 shotgun/agents/tools/web_search/__init__.py,sha256=Sj1tVokrCsJiLRWWTq0zrAolMHEGntRIYnqiyFi8L2E,1840
-shotgun/agents/tools/web_search/anthropic.py,sha256=IEcSujX5F7-b-87HZqcCHfp3C_E0WSSlb3Hvjq43KvE,4908
+shotgun/agents/tools/web_search/anthropic.py,sha256=NDhj8MrdxLsmGwHp7uM0IQeJVW2poY58GCUTJEM9dew,4827
 shotgun/agents/tools/web_search/gemini.py,sha256=hXjWUF-aTX3B9ViaKe5aF2aHXlaoBA5am40cgilinGE,2981
 shotgun/agents/tools/web_search/openai.py,sha256=V8GeqwUAi5wrbRuU41Y38schpXRdyeIfw85-CT5rAhY,3415
 shotgun/agents/tools/web_search/utils.py,sha256=GLJ5QV9bT2ubFMuFN7caMN7tK9OTJ0R3GD57B-tCMF0,532
@@ -78,7 +78,7 @@ shotgun/prompts/agents/export.j2,sha256=GKpOfGbZA9PVa4TNtMORUYiBIAcN6JCo8URmTCWK
 shotgun/prompts/agents/plan.j2,sha256=MyZDyOS21V-zrHNzbIhIdzcESGh_3KVbA4qh9rZR2_E,6086
 shotgun/prompts/agents/research.j2,sha256=JBtjXaMVDRuNTt7-Ai8gUb2InfolfqCkQoEkn9PsQZk,3929
 shotgun/prompts/agents/specify.j2,sha256=AP7XrA3KE7GZsCvW4guASxZHBM2mnrMw3irdZ3RUOBs,2808
-shotgun/prompts/agents/tasks.j2,sha256=Vm6nFSgYzdwRBySUzwMzWHhfYR12Cb_xKPqif7yMuhs,4909
+shotgun/prompts/agents/tasks.j2,sha256=9gGCimCWVvpaQSxkAjt7WmIxFHXJY2FlmqhqomFxQTA,5949
 shotgun/prompts/agents/partials/codebase_understanding.j2,sha256=7WH-PVd-TRBFQUdOdKkwwn9hAUaJznFZMAGHhO7IGGU,5633
 shotgun/prompts/agents/partials/common_agent_system_prompt.j2,sha256=eFuc3z1pSJzQtPJfjMIDNHv5XX9lP6YVrmKcbbskJj8,1877
 shotgun/prompts/agents/partials/content_formatting.j2,sha256=MG0JB7SSp8YV5akDWpbs2f9DcdREIYqLp38NnoWLeQ0,1854
@@ -108,7 +108,7 @@ shotgun/tui/components/prompt_input.py,sha256=Ss-htqraHZAPaehGE4x86ij0veMjc4Ugad
 shotgun/tui/components/spinner.py,sha256=ovTDeaJ6FD6chZx_Aepia6R3UkPOVJ77EKHfRmn39MY,2427
 shotgun/tui/components/splash.py,sha256=vppy9vEIEvywuUKRXn2y11HwXSRkQZHLYoVjhDVdJeU,1267
 shotgun/tui/components/vertical_tail.py,sha256=kkCH0WjAh54jDvRzIaOffRZXUKn_zHFZ_ichfUpgzaE,1071
-shotgun/tui/screens/chat.py,sha256=474e6W6r2QgQZvWwZoFds9Y7YmhjNukR_bXvwutHetM,27690
+shotgun/tui/screens/chat.py,sha256=c9g457FR8JUr_ArTi1bbweC_chYlXastUvCa9XGfDYQ,28075
 shotgun/tui/screens/chat.tcss,sha256=2Yq3E23jxsySYsgZf4G1AYrYVcpX0UDW6kNNI0tDmtM,437
 shotgun/tui/screens/directory_setup.py,sha256=lIZ1J4A6g5Q2ZBX8epW7BhR96Dmdcg22CyiM5S-I5WU,3237
 shotgun/tui/screens/provider_config.py,sha256=A_tvDHF5KLP5PV60LjMJ_aoOdT3TjI6_g04UIUqGPqM,7126
@@ -123,8 +123,8 @@ shotgun/utils/__init__.py,sha256=WinIEp9oL2iMrWaDkXz2QX4nYVPAm8C9aBSKTeEwLtE,198
 shotgun/utils/env_utils.py,sha256=8QK5aw_f_V2AVTleQQlcL0RnD4sPJWXlDG46fsHu0d8,1057
 shotgun/utils/file_system_utils.py,sha256=l-0p1bEHF34OU19MahnRFdClHufThfGAjQ431teAIp0,1004
 shotgun/utils/update_checker.py,sha256=Xf-7w3Pos3etzCoT771gJe2HLkA8_V2GrqWy7ni9UqA,11373
-shotgun_sh-0.1.0.dev27.dist-info/METADATA,sha256=yE6vp8p3JZUIQeu8t1RWTU086EaiZ8wQO7CzCX2HxXU,11197
-shotgun_sh-0.1.0.dev27.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-shotgun_sh-0.1.0.dev27.dist-info/entry_points.txt,sha256=asZxLU4QILneq0MWW10saVCZc4VWhZfb0wFZvERnzfA,45
-shotgun_sh-0.1.0.dev27.dist-info/licenses/LICENSE,sha256=YebsZl590zCHrF_acCU5pmNt0pnAfD2DmAnevJPB1tY,1065
-shotgun_sh-0.1.0.dev27.dist-info/RECORD,,
+shotgun_sh-0.1.0.dev29.dist-info/METADATA,sha256=XLRPwFmfmINfF-iyE1j77l3J2XQ42BJvAIx7d-nz6-k,11197
+shotgun_sh-0.1.0.dev29.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+shotgun_sh-0.1.0.dev29.dist-info/entry_points.txt,sha256=asZxLU4QILneq0MWW10saVCZc4VWhZfb0wFZvERnzfA,45
+shotgun_sh-0.1.0.dev29.dist-info/licenses/LICENSE,sha256=YebsZl590zCHrF_acCU5pmNt0pnAfD2DmAnevJPB1tY,1065
+shotgun_sh-0.1.0.dev29.dist-info/RECORD,,