netra-zen 1.0.9__py3-none-any.whl → 1.0.11__py3-none-any.whl

{netra_zen-1.0.9.dist-info → netra_zen-1.0.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: netra-zen
-Version: 1.0.9
+Version: 1.0.11
 Summary: Multi-instance Claude orchestrator for parallel task execution
 Home-page: https://github.com/netra-systems/zen
 Author:  Systems
@@ -60,39 +60,38 @@ It works by analyzing your usage logs for metadata optimizations. It is focused
 
 This is a micro startup effort, aiming to provide real value for individual devs in exchange for feedback. Our intent is to charge businesses for larger scale optimizations.
 
-The process is simple. One time install, then one command. It auto grabs the last 3 log files and provides actionable items to update going forward to get the value of the optimizations.
+The process is simple. One time install, then one command. It analyzes your most recent log file and provides actionable items to update going forward to get the value of the optimizations. For best results, analyze one log file at a time with payloads under 1MB for focused, accurate analysis.
 
 ## Quick start
 
 1. `pip install netra-zen`
-2. `zen --apex --send-logs`
+2. `zen --apex`  # Logs are now sent by default
 3. Read the results and update claude settings, prompts, commands, etc. as needed to benefit
 
 See detailed install below if needed.
 
 ### Log Collection Options
 
-The optimizer analyzes your Claude Code usage logs to identify optimization opportunities. You can customize what logs are sent:
+The optimizer automatically analyzes your Claude Code usage logs to identify optimization opportunities. You can customize the behavior:
 
 ```bash
-# Send logs from the 3 most recent files (default)
-zen --apex --send-logs
-
-# Send logs from more files for deeper analysis
-zen --apex --send-logs --logs-count 5
+# Send logs from the most recent file (default behavior)
+zen --apex
 
 # Send logs from a specific project
-zen --apex --send-logs --logs-project "my-project-name"
+zen --apex --logs-project "my-project-name"
 
 # Send logs from a custom location
-zen --apex --send-logs --logs-path "/path/to/.claude/Projects"
+zen --apex --logs-path "/path/to/.claude/Projects"
 
-# Combine options for targeted analysis
-zen --apex --send-logs --logs-count 3 --logs-project "production-app"
+# Advanced: Send multiple files (use with caution)
+zen --apex --logs-count 2
 ```
 
 **Important:**
-- `--logs-count` specifies the number of **files** to read, not entries
+- `--logs-count` default is **1** for current Alpha release limitations. 
+- For optimal analysis, use **1 log file at a time** and keep payload under 1MB
+- Multiple log files can dilute the analysis and reduce accuracy
 - Each file may contain many log entries
 - The tool will display exactly how many entries from how many files are being sent
 
@@ -110,7 +109,7 @@ This was just changing a few small lines on a 400 line command.
 
 ## Example output from single file
 ```
-zen --apex --send-logs --logs-path /Users/user/.claude/projects/-Users-Desktop-netra-apex/7ac6d7ac-abc3-4903-a482-......-1.jsonl
+zen --apex --logs-path /Users/user/.claude/projects/-Users-Desktop-netra-apex/7ac6d7ac-abc3-4903-a482-......-1.jsonl
 
 SUCCESS: WebSocket connected successfully!
 
@@ -237,6 +236,28 @@ Receiving events...
 📊 Received 8 events
 ```
 
+# Another example
+```
+"issue": "Confused execution path and backtracking",                                               │
+
+"evidence": "The model initially assumes a JavaScript/TypeScript frontend based on the term 
+│ \"client side\", leading to incorrect file searches. After realizing it's a Python project, it gets stuck  
+│ repeatedly grepping `scripts/agent_cli.py` and requires multiple user interventions to be redirected to    
+│ the actual root cause in `zen_orchestrator.py` and `zen/telemetry/apex_telemetry.py`",         ...                                                                          │
+│         "token_waste": "8000-10000",                                                                       │
+│         "fix": "When an initial search term (e.g., 'ultrathink') fails, the model should prioritize        │
+│ understanding the project's overall structure and language (`ls -R` or `find . -type f | head -n 20`)      │
+│ before making assumptions. For regressions, `git log` should be used earlier in the process to identify    │
+│ recent, relevant changes that could have introduced the bug.",        
+
+│         "ideal prompt": "There's a regression where events are batched instead of streamed. The user       │
+│ mentioned 'client side ultrathink', but that could be a red herring. Start by checking the project         │
+│ structure and language, then review the git history for recent changes related to event handling,          │
+│ streaming, telemetry, or subprocess execution before deep-diving into code.",                              │
+│         "priority": "high"                                                                                 │
+│       }
+```                                    
+
 # Advanced features & detailed install guide
 
 In addition to optimizing your costs and latency,

netra_zen-1.0.11.dist-info/RECORD

@@ -0,0 +1,30 @@
+zen_orchestrator.py,sha256=hKeP2dW6eJgEhtUHYylnhIgP_HgaxrDAwCnlS7mKkgU,156167
+agent_interface/__init__.py,sha256=OsbOKzElHsxhVgak87oOx_u46QNgKmz-Reis-plAMwk,525
+agent_interface/base_agent.py,sha256=GNskG9VaZgno7X24lQTpFdxUoQE0yJHLh0UPFJvOPn4,11098
+netra_zen-1.0.11.dist-info/licenses/LICENSE.md,sha256=PZrP0UDn58i4LjV4zijIQTnsQPvWm4zq9Fet9i7qgwI,80
+scripts/__init__.py,sha256=r6jX6e9SaisREml6B7uDoV-_rzIW0_yQXMm6OhNgbIw,52
+scripts/__main__.py,sha256=NSqyN47EijNf7m_8QsoxeYevKYgH2sNtNPFZcwKWMs0,160
+scripts/agent_cli.py,sha256=nN_uVvvMvFznEeIo4aHx3hBpXov5BkloQHcC6quAGFE,338473
+scripts/agent_logs.py,sha256=ppseAtUCvS2N-iEDSUQh84I9Ov-gBEw5ElxYajNdpJs,11218
+scripts/bump_version.py,sha256=fjABzzRVXJ00CbYMpUIUMwcOHwafLYtFL6NvUga-i6M,4183
+scripts/demo_log_collection.py,sha256=5XladS8j4lz-jJdVzSeDSxopChqHKX7HLNJUzSWR40c,5623
+scripts/embed_release_credentials.py,sha256=dEw3jP5Hvzbd0YUaXRZtiAZSpj315uVWIIjvwcK4g6Y,2103
+scripts/test_apex_telemetry_debug.py,sha256=UG5pbOmna653S9q83qPjrDAjkLeb6utW8ruXpWYy3aQ,6896
+scripts/verify_log_transmission.py,sha256=IZBeQos1rMHSdCyml_HL2x1XpLcpOuI0EUr0qA7mkE8,4493
+token_budget/__init__.py,sha256=_2tmi72DGNtbYcZ-rGIxVKMytdkHFjzJaWz8bDhYACc,33
+token_budget/budget_manager.py,sha256=VRWxKcGDtgJfIRh-ztYQ4-wuhBvddVJJnyoGfxCBlv0,9567
+token_budget/models.py,sha256=14xFTk2-R1Ql0F9WLDof7vADrKC_5Fj7EE7UmZdoG00,2384
+token_budget/visualization.py,sha256=SaNnZ15edHXtjDCA5Yfu7w3AztCZRYsYCPGBqzapupY,719
+token_transparency/__init__.py,sha256=go86Rg4_VYAPLw3myVpLe1s1PbMu1llDTw1wfomP1lA,453
+token_transparency/claude_pricing_engine.py,sha256=9zWQJS3HJEs_lljil-xT1cUvG-Jf3ykNAninJFyfNSM,12630
+zen/__init__.py,sha256=lVT1vB_ohU1o9-WRPwVsI2jtXB9mb7WaIdfDRfYC1PE,213
+zen/__main__.py,sha256=3Sex-j1o01NGoFnZOO9lPxcNX--M5VdIbjkJ_0z16qU,181
+zen/telemetry/__init__.py,sha256=zyH7YcK_eWxwaQZW0MRefu1bX5hEgfRljr_dsqNU-tw,452
+zen/telemetry/apex_telemetry.py,sha256=FAkiHXOuzZFL-51oYetTC4wbjCL5UH-qOghwcaaOVgE,9685
+zen/telemetry/embedded_credentials.py,sha256=z-j_TfuVIz3nX-Vvh4O6_iDQhtteEyQgfc-xSslVbXU,1716
+zen/telemetry/manager.py,sha256=Rdbpnjbjel9xZEJyvLqy2M-4amvkr80abRiWnqHghIQ,9980
+netra_zen-1.0.11.dist-info/METADATA,sha256=0NbAxCCoF9-SB30FfxA2lU0oo0da1XNtNvSHkrRZX9I,46284
+netra_zen-1.0.11.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+netra_zen-1.0.11.dist-info/entry_points.txt,sha256=oDehCnPGZezG0m9ZWspxjHLHyQ3eERX87eojR4ljaRo,45
+netra_zen-1.0.11.dist-info/top_level.txt,sha256=OhiyXmoXftBijCF6ck-RS1dN2NBJv9wdd7kBG1Es7zA,77
+netra_zen-1.0.11.dist-info/RECORD,,

{netra_zen-1.0.9.dist-info → netra_zen-1.0.11.dist-info}/licenses/LICENSE.md

@@ -1 +1 @@
-© Netra Inc. All rights reserved. Use is subject to Netra's Terms of Service.
+© Netra Inc. All rights reserved. Use is subject to Netra's Terms of Service.

scripts/__init__.py

@@ -1 +1 @@
-"""Scripts package for Zen orchestration tools."""
+"""Scripts package for Zen orchestration tools."""

scripts/__main__.py

@@ -1,5 +1,5 @@
-"""Allow scripts.agent_cli to be run as a module: python -m scripts.agent_cli"""
-from scripts.agent_cli import main
-
-if __name__ == "__main__":
-    main()
+"""Allow scripts.agent_cli to be run as a module: python -m scripts.agent_cli"""
+from scripts.agent_cli import main
+
+if __name__ == "__main__":
+    main()