shotgun-sh 0.1.0.dev7__py3-none-any.whl → 0.1.0.dev8__py3-none-any.whl

{shotgun_sh-0.1.0.dev7.dist-info → shotgun_sh-0.1.0.dev8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shotgun-sh
-Version: 0.1.0.dev7
+Version: 0.1.0.dev8
 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
@@ -29,8 +29,11 @@ Requires-Dist: jinja2>=3.1.0
 Requires-Dist: kuzu>=0.7.0
 Requires-Dist: logfire[pydantic-ai]>=2.0.0
 Requires-Dist: openai>=1.0.0
+Requires-Dist: packaging>=23.0
+Requires-Dist: posthog>=3.0.0
 Requires-Dist: pydantic-ai>=0.0.14
 Requires-Dist: rich>=13.0.0
+Requires-Dist: sentry-sdk[pure-eval]>=2.0.0
 Requires-Dist: textual-dev>=1.7.0
 Requires-Dist: textual>=6.1.0
 Requires-Dist: tree-sitter-go>=0.23.0
@@ -131,6 +134,44 @@ uv run shotgun plan "Build a web application"
 uv run shotgun tasks "Create a machine learning model"
 ```
 
+## Auto-Updates
+
+Shotgun automatically checks for updates to keep you on the latest version.
+
+### How it works
+
+- Checks for updates on startup (runs in background, non-blocking)
+- Caches results for 24 hours to minimize API calls
+- Shows notification after command execution if an update is available
+- Never auto-updates development versions
+
+### Update Commands
+
+```bash
+# Check for available updates
+shotgun update --check
+
+# Install available updates
+shotgun update
+
+# Force update (even for dev versions with confirmation)
+shotgun update --force
+```
+
+### Disable Update Checks
+
+```bash
+# Disable for a single command
+shotgun --no-update-check research "topic"
+```
+
+### Installation Methods
+
+The update command automatically detects and uses the appropriate method:
+- **pipx**: `pipx upgrade shotgun-sh`
+- **pip**: `pip install --upgrade shotgun-sh`
+- **venv**: Updates within the virtual environment
+
 ## Development Setup
 
 ### Requirements
@@ -312,6 +353,114 @@ GitHub Actions automatically:
 - Validates code with ruff, ruff-format, and mypy
 - Ensures all checks pass before merge
 
+## Observability & Telemetry
+
+Shotgun includes built-in observability with Sentry for error tracking and Logfire for logging and tracing. Both services track users anonymously using a UUID generated on first run.
+
+### Anonymous User Tracking
+
+Each user gets a unique anonymous ID stored in their config:
+```bash
+# Get your anonymous user ID
+shotgun config get-user-id
+```
+
+This ID is automatically included in:
+- **Sentry**: Error reports and exceptions
+- **Logfire**: All logs, traces, and spans
+
+### Logfire Queries
+
+Logfire uses SQL for querying logs. Here are helpful queries for debugging and analysis:
+
+#### Find all logs for a specific user
+```sql
+SELECT * FROM records
+WHERE attributes->>'user_id' = 'your-user-id-here'
+ORDER BY timestamp DESC;
+```
+
+#### Track user actions
+```sql
+SELECT
+  timestamp,
+  span_name,
+  message,
+  attributes
+FROM records
+WHERE attributes->>'user_id' = 'your-user-id-here'
+  AND span_name LIKE '%research%'
+ORDER BY timestamp DESC;
+```
+
+#### Find slow operations for a user
+```sql
+SELECT
+  span_name,
+  duration_ms,
+  attributes
+FROM records
+WHERE attributes->>'user_id' = 'your-user-id-here'
+  AND duration_ms > 1000
+ORDER BY duration_ms DESC;
+```
+
+#### Find errors for a user
+```sql
+SELECT * FROM records
+WHERE attributes->>'user_id' = 'your-user-id-here'
+  AND level = 'error'
+ORDER BY timestamp DESC;
+```
+
+#### Analyze user's AI provider usage
+```sql
+SELECT
+  attributes->>'provider' as provider,
+  COUNT(*) as usage_count,
+  AVG(duration_ms) as avg_duration
+FROM records
+WHERE attributes->>'user_id' = 'your-user-id-here'
+  AND attributes->>'provider' IS NOT NULL
+GROUP BY provider;
+```
+
+#### Track feature usage by user
+```sql
+SELECT
+  span_name,
+  COUNT(*) as usage_count
+FROM records
+WHERE attributes->>'user_id' = 'your-user-id-here'
+  AND span_name IN ('research', 'plan', 'tasks')
+GROUP BY span_name
+ORDER BY usage_count DESC;
+```
+
+### Setting Up Observability (Optional)
+
+For local development with Logfire:
+```bash
+# Set environment variables
+export LOGFIRE_ENABLED=true
+export LOGFIRE_TOKEN=your-logfire-token
+
+# Run shotgun - will now send logs to Logfire
+shotgun research "topic"
+```
+
+For Sentry (automatically configured in production builds):
+```bash
+# Set for local development
+export SENTRY_DSN=your-sentry-dsn
+```
+
+### Privacy
+
+- **No PII collected**: Only anonymous UUIDs are used for identification
+- **Opt-in for development**: Telemetry requires explicit environment variables
+- **Automatic in production**: Production builds include telemetry for error tracking
+
 ## Support
 
 Join our discord https://discord.gg/5RmY6J2N7s

{shotgun_sh-0.1.0.dev7.dist-info → shotgun_sh-0.1.0.dev8.dist-info}/RECORD

@@ -1,8 +1,11 @@
-shotgun/__init__.py,sha256=5pveArOu7XFzA-uGyx58sIlsoja3-yr25JiMg6LaoGY,55
+shotgun/__init__.py,sha256=P40K0fnIsb7SKcQrFnXZ4aREjpWchVDhvM1HxI4cyIQ,104
+shotgun/build_constants.py,sha256=RXNxMz46HaB5jucgMVpw8a2yCJqjbhTOh0PddyEVMN8,713
 shotgun/logging_config.py,sha256=EJL2kpwH8-zRtpKit3_BbpeUxbRR-wen3MaNXuHCoD4,5600
-shotgun/main.py,sha256=SOwxw49hbWlSe_APstonRU3uB34fIToYfx-GFGmXolE,2291
+shotgun/main.py,sha256=7gXkTNmwqW2phBnENn76bUyh5Qm68Iq7NBf3GnWG6J0,4618
+shotgun/posthog_telemetry.py,sha256=7drAXtedvZmpPqq4_9dI19kJ_xEHGk7XKXQk797QvCM,4954
 shotgun/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-shotgun/telemetry.py,sha256=42mItPr4uZ5NtMF--WbRCy2DX8o_cN_zz4se3E3ULLA,1346
+shotgun/sentry_telemetry.py,sha256=3r9on0GQposn9aX6Dkb9mrfaVQl_dIZzhu9BjE838AU,2854
+shotgun/telemetry.py,sha256=p4l9GxDfoxbEsmUpuSkQclRMhVFWqsOv97ze60KxRjk,2899
 shotgun/agents/__init__.py,sha256=8Jzv1YsDuLyNPFJyckSr_qI4ehTVeDyIMDW4omsfPGc,25
 shotgun/agents/agent_manager.py,sha256=1Aof8btrV2Ei3V3bNn8bLzdBiBsJ-sjaQq0t7bnwbpo,6564
 shotgun/agents/common.py,sha256=xNlbvwt68de2588930iI4JnNVyPMGsUEwf_ySFXttFE,9439
@@ -11,8 +14,8 @@ shotgun/agents/plan.py,sha256=mSkaMfavZ1-WNJ-Yk-8ivbNtmbOz-TZI4oO8vIXXu5Y,3537
 shotgun/agents/research.py,sha256=zDoS1BLVn7Wvcc4VAoYWOZ33IhtaHCY_CIlvEFiD1_A,4089
 shotgun/agents/tasks.py,sha256=8miXmOB6zp-9jTZgzpgs-109M5BWAg0n5-TD5D8tm1c,3648
 shotgun/agents/config/__init__.py,sha256=Fl8K_81zBpm-OfOW27M_WWLSFdaHHek6lWz95iDREjQ,318
-shotgun/agents/config/manager.py,sha256=d5Eb0TK6Fwez9XN3f33_meGxs2iP7lukwaAyJM5e4fQ,7821
-shotgun/agents/config/models.py,sha256=TqVtmCDqlSRxc3ZK53O-nJDTTwT_eS2TWvC1RmSin28,3518
+shotgun/agents/config/manager.py,sha256=gUeLtJHk9WUXgWeP9ftZAj1e57wLynjazane0IV7SZY,8601
+shotgun/agents/config/models.py,sha256=AsstJiAJ1J0_7Lv3IuyKsJYQG_g2CHwwKJoWD3eCtgg,3678
 shotgun/agents/config/provider.py,sha256=tN__agB1MiaNL49HTDUz1QzvOXTegLRoJ9xQKoklK-k,5820
 shotgun/agents/history/__init__.py,sha256=XFQj2a6fxDqVg0Q3juvN9RjV_RJbgvFZtQOCOjVJyp4,147
 shotgun/agents/history/history_processors.py,sha256=U0HiJM4zVLfwUnlZ6_2YoXNRteedMxwmr52KE4jky5w,7036
@@ -32,11 +35,12 @@ shotgun/agents/tools/web_search/gemini.py,sha256=RB7AeGDBvjlsA2RLCI8ErxZh3gOPtA0
 shotgun/agents/tools/web_search/openai.py,sha256=ItpV3IquamYJ13ZNUHYjXrSsgOROD51jDd2mwnz0KCE,2972
 shotgun/agents/tools/web_search/utils.py,sha256=GLJ5QV9bT2ubFMuFN7caMN7tK9OTJ0R3GD57B-tCMF0,532
 shotgun/cli/__init__.py,sha256=_F1uW2g87y4bGFxz8Gp8u7mq2voHp8vQIUtCmm8Tojo,40
-shotgun/cli/config.py,sha256=_eKnKG8ySLNDRavw5EC3mXB3u0UKDoqSSj5ZVd6KYkY,8267
+shotgun/cli/config.py,sha256=LbjxDNPdetYJiwlcyOYLnqwzALfgU-m54cfstUshbrs,8715
 shotgun/cli/models.py,sha256=LoajeEK7MEDUSnZXb1Li-dbhXqne812YZglx-LcVpiQ,181
-shotgun/cli/plan.py,sha256=q3nMrNK0J1HAhnfFFqllcHXN_grmzZMd1FBPcCikNvA,2186
-shotgun/cli/research.py,sha256=cmJa1ejxsnK_eqB1KsPQtqsq0cIMSS0Z8R2tJamHu8k,2212
-shotgun/cli/tasks.py,sha256=VdZM0tObUALRg2e_r9YwZYdrG6rYe1wXo5LubXdJ4qw,2289
+shotgun/cli/plan.py,sha256=PNlqpmGkcoEaqK-8khveX1xX9i3-Xmdv-JJbPmlgIMA,2492
+shotgun/cli/research.py,sha256=qvBBtX3Wyn6pDZlJpcEvbeK-0iTOXegi71tm8HKVYaE,2490
+shotgun/cli/tasks.py,sha256=OUdxbB7EU5XVe0QeiTlVTayhLKlQN9HrzDyjoAMf708,2597
+shotgun/cli/update.py,sha256=3IWt3vbFprsyiRH8J-YYVSOuga7Spi7SrbQVvKH8r5U,4771
 shotgun/cli/utils.py,sha256=umVWXDx8pelovMk-nT8B7m0c39AKY9hHsuAMnbw_Hcg,732
 shotgun/cli/codebase/__init__.py,sha256=rKdvx33p0i_BYbNkz5_4DCFgEMwzOOqLi9f5p7XTLKM,73
 shotgun/cli/codebase/commands.py,sha256=zvcM9gjHHO6styhXojb_1bnpq-Cozh2c77ZOIjw4B8s,6683
@@ -79,7 +83,7 @@ shotgun/sdk/exceptions.py,sha256=qBcQv0v7ZTwP7CMcxZST4GqCsfOWtOUjSzGBo0-heqo,412
 shotgun/sdk/models.py,sha256=RsR9e2wiVrNGP2zTvjIZVvBlibgluuhDZlCNcw8JTTA,5488
 shotgun/sdk/services.py,sha256=J4PJFSxCQ6--u7rb3Ta-9eYtlYcxcbnzrMP6ThyCnw4,705
 shotgun/tui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-shotgun/tui/app.py,sha256=Id5_RBQMWq8PISE8NPJkJAQZAMvqq3OvM1Vsj0sMxQQ,1441
+shotgun/tui/app.py,sha256=gHxqOWjJ9hGDRz6esnoM2JTyaP_IWTWmsYnO8pwpeDQ,2762
 shotgun/tui/styles.tcss,sha256=ETyyw1bpMBOqTi5RLcAJUScdPWTvAWEqE9YcT0kVs_E,121
 shotgun/tui/components/prompt_input.py,sha256=Ss-htqraHZAPaehGE4x86ij0veMjc4UgadMXpbdXr40,2229
 shotgun/tui/components/spinner.py,sha256=ovTDeaJ6FD6chZx_Aepia6R3UkPOVJ77EKHfRmn39MY,2427
@@ -91,8 +95,9 @@ shotgun/tui/screens/provider_config.py,sha256=A_tvDHF5KLP5PV60LjMJ_aoOdT3TjI6_g0
 shotgun/tui/screens/splash.py,sha256=E2MsJihi3c9NY1L28o_MstDxGwrCnnV7zdq00MrGAsw,706
 shotgun/utils/__init__.py,sha256=WinIEp9oL2iMrWaDkXz2QX4nYVPAm8C9aBSKTeEwLtE,198
 shotgun/utils/file_system_utils.py,sha256=KQCxgkspb1CR8VE1n66q7-oT6O7MmV_edCXFEEO-CNY,871
-shotgun_sh-0.1.0.dev7.dist-info/METADATA,sha256=AUEfEsKRHN6lZDo59WEQShq582Ji5iw4PkAIV9bvLSM,7701
-shotgun_sh-0.1.0.dev7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-shotgun_sh-0.1.0.dev7.dist-info/entry_points.txt,sha256=zMC2AP_RmTKW4s4FlQRdap3AzzPOUvByudp8cALAiVY,71
-shotgun_sh-0.1.0.dev7.dist-info/licenses/LICENSE,sha256=YebsZl590zCHrF_acCU5pmNt0pnAfD2DmAnevJPB1tY,1065
-shotgun_sh-0.1.0.dev7.dist-info/RECORD,,
+shotgun/utils/update_checker.py,sha256=Xf-7w3Pos3etzCoT771gJe2HLkA8_V2GrqWy7ni9UqA,11373
+shotgun_sh-0.1.0.dev8.dist-info/METADATA,sha256=EYMSwvdWlWiwseTmyKYNvPZraUta6RQXtRqSRzwpz5o,11239
+shotgun_sh-0.1.0.dev8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+shotgun_sh-0.1.0.dev8.dist-info/entry_points.txt,sha256=zMC2AP_RmTKW4s4FlQRdap3AzzPOUvByudp8cALAiVY,71
+shotgun_sh-0.1.0.dev8.dist-info/licenses/LICENSE,sha256=YebsZl590zCHrF_acCU5pmNt0pnAfD2DmAnevJPB1tY,1065
+shotgun_sh-0.1.0.dev8.dist-info/RECORD,,