netra-zen 1.0.0__tar.gz → 1.0.1__tar.gz

{netra_zen-1.0.0/netra_zen.egg-info → netra_zen-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: netra-zen
-Version: 1.0.0
+Version: 1.0.1
 Summary: Multi-instance Claude orchestrator for parallel task execution
 Home-page: https://github.com/netra-systems/zen
 Author:  Systems
@@ -79,10 +79,210 @@ Example portion of status report:
 ║  ⏳        quality-synthesizer    queued    0K
 ╚════════════════════════════════════════════╝
 ```
-Here you can see we are running 5 instances of claude.
-- 2 have completed
-- 2 are running
-- 1 is scheduled
+
+## Example Start
+```
+zen
+```
+
+```
++=== STATUS REPORT [14:47:39] ===+
+| Total: 2 instances
+| Running: 2, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 0 total, 0 cached | Median: 0 | Tools: 0
+| 💰 Cost: $0.0000 total, $0.0000 avg/instance | Pricing: Claude compliant
+|
+| TOKEN BUDGET STATUS |
+| Overall: [--------------------] 0% 0/10.0K
+| Command Budgets:
+|                        /analyze-repository  [--------------------] 0% 0/5.0K
+|                        /README              [--------------------] 0% 0/1.0K
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repo                   opus4      5.1s       0        0        0        0        0      0/5.0K
+|  🏃        help-overview                  sonnet4    0.0s       0        0        0        0        0      0/1.0K
++================================+
+```
+
+## Budget Warning Only
+```
+zen --overall-token-budget 10000
+```
+```
++=== STATUS REPORT [14:47:44] ===+
+| Total: 2 instances
+| Running: 2, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 32.2K total, 32.2K cached | Median: 32.2K | Tools: 1
+| 💰 Cost: $0.0818 total, $0.0409 avg/instance | Pricing: Claude compliant
+|
+| TOKEN BUDGET STATUS |
+| Overall: [####################] 100% 32.2K/10.0K
+| Command Budgets:
+|                        /analyze-repository  [####################] 100% 32.2K/5.0K
+|                        /README              [--------------------] 0% 0/1.0K
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repo                   35sonnet   10.1s      32.2K    5        20.9K    11.4K    1      32.2K/5.0K
+|  🏃        help-overview                  opus4      5.0s       0        0        0        0        0      0/1.0K
++================================+
+
++=== TOOL USAGE DETAILS ===+
+| Tool Name            Uses     Tokens     Cost ($)   Used By
+| -------------------- -------- ---------- ---------- -----------------------------------
+| Bash                 1        33         0.0001     analyze-repo(1 uses, 33 tok)
+| -------------------- -------- ---------- ---------- -----------------------------------
+| TOTAL                1        33         0.0001
++===============================================================================================+
+```
+
+## Budget Block
+```
+zen --overall-token-budget 10000 --budget-enforcement-mode block
+```
+```
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - 💰 BUDGET UPDATE [analyze-repo]: Recording 32240 tokens for command '/analyze-repository'
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - 📊 BUDGET STATE [analyze-repo]: /analyze-repository now at 32240/5000 tokens (644.8%)
+2025-09-18 14:50:42,050 - zen_orchestrator - ERROR - 🚫 🔴 RUNTIME TERMINATION: Runtime budget violation for analyze-repo: Overall budget exceeded: 32240/10000 tokens
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - Terminating instance analyze-repo (PID: 88916): Terminated due to budget violation - Overall budget exceeded: 32240/10000 tokens
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - Sent SIGTERM to analyze-repo (PID: 88916)
+```
+
+```
++=== FINAL STATUS [14:50:57] ===+
+| Total: 2 instances
+| Running: 0, Completed: 0, Failed: 2, Pending: 0
+| Tokens: 85.6K total, 85.2K cached | Median: 42.8K | Tools: 1
+| 💰 Cost: $0.0889 total, $0.0444 avg/instance | Pricing: Claude compliant
+|
+| TOKEN BUDGET STATUS |
+| Overall: [####################] 100% 85.6K/10.0K
+| Command Budgets:
+|                        /analyze-repository  [####################] 100% 48.4K/5.0K
+|                        /README              [####################] 100% 37.2K/1.0K
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  ❌        analyze-repo                   sonnet4    22.5s      48.4K    31       16.1K    32.2K    1      48.4K/5.0K
+|  ❌        help-overview                  35sonnet   16.2s      37.2K    422      0        36.8K    0      37.2K/1.0K
++===============================+
+
++=== TOOL USAGE DETAILS ===+
+| Tool Name            Uses     Tokens     Cost ($)   Used By
+| -------------------- -------- ---------- ---------- -----------------------------------
+| Task                 1        348        0.0010     analyze-repo(1 uses, 348 tok)
+| -------------------- -------- ---------- ---------- -----------------------------------
+| TOTAL                1        348        0.0010
++===============================================================================================+
+```
+
+# Example Start At
+```
+zen --start-at "2am"
+```
+
+```
+...
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Added instance: analyze-repo - Analyze the repository structure and codebase
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Added instance: help-overview - Show project README and overview information
+
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Orchestration scheduled to start at: 2025-09-19 02:00:00
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Waiting 39930.1 seconds (11.1 hours) until start time...
+```
+
+# Example Command
+** Assumes you have a claude command \runtests **
+```
+zen "/runtests"
+```
+```
+...
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Added instance: direct-runtests-3337c2c5 - Direct execution of /runtests
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Starting Claude Code instance orchestration
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Starting 1 instances with 5.0s delay between launches (timeout: 10000s each)
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Now starting instance 'direct-runtests-3337c2c5' (after 0.0s delay)
+
+```
+# Example Config (Recommended Usage)
+
+Your JSON file as `path\my_config.json`
+```JSON
+{
+  "instances": [
+    {
+      "name": "analyze-repository",
+      "command": "/analyze-repository; Spawn three subagents to understand how the information at this website is used in the zen directory. https://docs.claude.com/en/docs/about-claude/pricing#tool-use-pricing.",
+      "description": "Reads and understands the required portion of the repository",
+      "permission_mode": "bypassPermissions",
+      "output_format": "stream-json",
+      "max_tokens_per_command": 5000
+    }
+  ]
+}
+```
+```
+zen --config path\my_config.json
+```
+
+```
+...
+
+2025-09-18 15:00:09,645 - zen_orchestrator - INFO - Loading config from config_example.json
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - 🎯 Token transparency pricing engine enabled - Claude pricing compliance active
+
+2025-09-18 15:00:09,657 - zen_orchestrator - WARNING - Command '/analyze-repository; Spawn three subagents to understand how the information at this website is used in the zen directory. https://docs.claude.com/en/docs/about-claude/pricing#tool-use-pricing.' not found in available commands
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - Available commands: /clear, /compact, /help
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - Added instance: analyze-repository - Reads and understands the required portion of the repository
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - Starting Claude Code instance orchestration
+
+2025-09-18 15:00:09,659 - zen_orchestrator - INFO - Starting 1 instances with 5.0s delay between launches (timeout: 10000s each)
+
+2025-09-18 15:00:09,659 - zen_orchestrator - INFO - Now starting instance 'analyze-repository' (after 0.0s delay)
+
+2025-09-18 15:00:09,659 - zen_orchestrator - INFO - Starting instance: analyze-repository
+
+2025-09-18 15:00:09,665 - zen_orchestrator - INFO - Command: claude.CMD -p /analyze-repository; Spawn three subagents to understand how the information at this website is used in the zen directory. https://docs.claude.com/en/docs/about-claude/pricing#tool-use-pricing. --output-format=stream-json --permission-mode=bypassPermissions --verbose
+
+2025-09-18 15:00:09,738 - zen_orchestrator - INFO - Permission mode: bypassPermissions (Platform: Windows)
+2025-09-18 15:00:09,746 - zen_orchestrator - INFO - Instance analyze-repository started with PID 672
+
++=== STATUS REPORT [15:00:14] ===+
+| Total: 1 instances
+| Running: 1, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 0 total, 0 cached | Median: 0 | Tools: 0
+| 💰 Cost: $0.0000 total, $0.0000 avg/instance | Pricing: Claude compliant
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repository             opus4      5.1s       0        0        0        0        0      -
++================================+
+
+
++=== STATUS REPORT [15:00:19] ===+
+| Total: 1 instances
+| Running: 1, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 14.7K total, 14.7K cached | Median: 14.7K | Tools: 0
+| 💰 Cost: $0.0798 total, $0.0798 avg/instance | Pricing: Claude compliant
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repository             opus4      10.1s      14.7K    6        3.3K     11.4K    0      -
++================================+
+
+```
+
 
 ## Inspiration and background
 While developing Netra Apex (commercial product)
@@ -304,7 +504,7 @@ yields:
 usage: zen [-h] [--workspace WORKSPACE] [--config CONFIG] [--dry-run] [--list-commands] [--inspect-command INSPECT_COMMAND]
            [--output-format {json,stream-json}] [--timeout TIMEOUT] [--max-console-lines MAX_CONSOLE_LINES] [--quiet]
            [--startup-delay STARTUP_DELAY] [--max-line-length MAX_LINE_LENGTH] [--status-report-interval STATUS_REPORT_INTERVAL]
-           [--start-at START_AT] [--use-cloud-sql] [--overall-token-budget OVERALL_TOKEN_BUDGET] [--command-budget COMMAND_BUDGET]
+           [--start-at START_AT] [--overall-token-budget OVERALL_TOKEN_BUDGET] [--command-budget COMMAND_BUDGET]
            [--budget-enforcement-mode {warn,block}] [--disable-budget-visuals]
 
 Claude Code Instance Orchestrator

{netra_zen-1.0.0 → netra_zen-1.0.1}/README.md

@@ -33,10 +33,210 @@ Example portion of status report:
 ║  ⏳        quality-synthesizer    queued    0K
 ╚════════════════════════════════════════════╝
 ```
-Here you can see we are running 5 instances of claude.
-- 2 have completed
-- 2 are running
-- 1 is scheduled
+
+## Example Start
+```
+zen
+```
+
+```
++=== STATUS REPORT [14:47:39] ===+
+| Total: 2 instances
+| Running: 2, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 0 total, 0 cached | Median: 0 | Tools: 0
+| 💰 Cost: $0.0000 total, $0.0000 avg/instance | Pricing: Claude compliant
+|
+| TOKEN BUDGET STATUS |
+| Overall: [--------------------] 0% 0/10.0K
+| Command Budgets:
+|                        /analyze-repository  [--------------------] 0% 0/5.0K
+|                        /README              [--------------------] 0% 0/1.0K
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repo                   opus4      5.1s       0        0        0        0        0      0/5.0K
+|  🏃        help-overview                  sonnet4    0.0s       0        0        0        0        0      0/1.0K
++================================+
+```
+
+## Budget Warning Only
+```
+zen --overall-token-budget 10000
+```
+```
++=== STATUS REPORT [14:47:44] ===+
+| Total: 2 instances
+| Running: 2, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 32.2K total, 32.2K cached | Median: 32.2K | Tools: 1
+| 💰 Cost: $0.0818 total, $0.0409 avg/instance | Pricing: Claude compliant
+|
+| TOKEN BUDGET STATUS |
+| Overall: [####################] 100% 32.2K/10.0K
+| Command Budgets:
+|                        /analyze-repository  [####################] 100% 32.2K/5.0K
+|                        /README              [--------------------] 0% 0/1.0K
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repo                   35sonnet   10.1s      32.2K    5        20.9K    11.4K    1      32.2K/5.0K
+|  🏃        help-overview                  opus4      5.0s       0        0        0        0        0      0/1.0K
++================================+
+
++=== TOOL USAGE DETAILS ===+
+| Tool Name            Uses     Tokens     Cost ($)   Used By
+| -------------------- -------- ---------- ---------- -----------------------------------
+| Bash                 1        33         0.0001     analyze-repo(1 uses, 33 tok)
+| -------------------- -------- ---------- ---------- -----------------------------------
+| TOTAL                1        33         0.0001
++===============================================================================================+
+```
+
+## Budget Block
+```
+zen --overall-token-budget 10000 --budget-enforcement-mode block
+```
+```
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - 💰 BUDGET UPDATE [analyze-repo]: Recording 32240 tokens for command '/analyze-repository'
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - 📊 BUDGET STATE [analyze-repo]: /analyze-repository now at 32240/5000 tokens (644.8%)
+2025-09-18 14:50:42,050 - zen_orchestrator - ERROR - 🚫 🔴 RUNTIME TERMINATION: Runtime budget violation for analyze-repo: Overall budget exceeded: 32240/10000 tokens
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - Terminating instance analyze-repo (PID: 88916): Terminated due to budget violation - Overall budget exceeded: 32240/10000 tokens
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - Sent SIGTERM to analyze-repo (PID: 88916)
+```
+
+```
++=== FINAL STATUS [14:50:57] ===+
+| Total: 2 instances
+| Running: 0, Completed: 0, Failed: 2, Pending: 0
+| Tokens: 85.6K total, 85.2K cached | Median: 42.8K | Tools: 1
+| 💰 Cost: $0.0889 total, $0.0444 avg/instance | Pricing: Claude compliant
+|
+| TOKEN BUDGET STATUS |
+| Overall: [####################] 100% 85.6K/10.0K
+| Command Budgets:
+|                        /analyze-repository  [####################] 100% 48.4K/5.0K
+|                        /README              [####################] 100% 37.2K/1.0K
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  ❌        analyze-repo                   sonnet4    22.5s      48.4K    31       16.1K    32.2K    1      48.4K/5.0K
+|  ❌        help-overview                  35sonnet   16.2s      37.2K    422      0        36.8K    0      37.2K/1.0K
++===============================+
+
++=== TOOL USAGE DETAILS ===+
+| Tool Name            Uses     Tokens     Cost ($)   Used By
+| -------------------- -------- ---------- ---------- -----------------------------------
+| Task                 1        348        0.0010     analyze-repo(1 uses, 348 tok)
+| -------------------- -------- ---------- ---------- -----------------------------------
+| TOTAL                1        348        0.0010
++===============================================================================================+
+```
+
+# Example Start At
+```
+zen --start-at "2am"
+```
+
+```
+...
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Added instance: analyze-repo - Analyze the repository structure and codebase
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Added instance: help-overview - Show project README and overview information
+
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Orchestration scheduled to start at: 2025-09-19 02:00:00
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Waiting 39930.1 seconds (11.1 hours) until start time...
+```
+
+# Example Command
+** Assumes you have a claude command \runtests **
+```
+zen "/runtests"
+```
+```
+...
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Added instance: direct-runtests-3337c2c5 - Direct execution of /runtests
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Starting Claude Code instance orchestration
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Starting 1 instances with 5.0s delay between launches (timeout: 10000s each)
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Now starting instance 'direct-runtests-3337c2c5' (after 0.0s delay)
+
+```
+# Example Config (Recommended Usage)
+
+Your JSON file as `path\my_config.json`
+```JSON
+{
+  "instances": [
+    {
+      "name": "analyze-repository",
+      "command": "/analyze-repository; Spawn three subagents to understand how the information at this website is used in the zen directory. https://docs.claude.com/en/docs/about-claude/pricing#tool-use-pricing.",
+      "description": "Reads and understands the required portion of the repository",
+      "permission_mode": "bypassPermissions",
+      "output_format": "stream-json",
+      "max_tokens_per_command": 5000
+    }
+  ]
+}
+```
+```
+zen --config path\my_config.json
+```
+
+```
+...
+
+2025-09-18 15:00:09,645 - zen_orchestrator - INFO - Loading config from config_example.json
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - 🎯 Token transparency pricing engine enabled - Claude pricing compliance active
+
+2025-09-18 15:00:09,657 - zen_orchestrator - WARNING - Command '/analyze-repository; Spawn three subagents to understand how the information at this website is used in the zen directory. https://docs.claude.com/en/docs/about-claude/pricing#tool-use-pricing.' not found in available commands
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - Available commands: /clear, /compact, /help
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - Added instance: analyze-repository - Reads and understands the required portion of the repository
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - Starting Claude Code instance orchestration
+
+2025-09-18 15:00:09,659 - zen_orchestrator - INFO - Starting 1 instances with 5.0s delay between launches (timeout: 10000s each)
+
+2025-09-18 15:00:09,659 - zen_orchestrator - INFO - Now starting instance 'analyze-repository' (after 0.0s delay)
+
+2025-09-18 15:00:09,659 - zen_orchestrator - INFO - Starting instance: analyze-repository
+
+2025-09-18 15:00:09,665 - zen_orchestrator - INFO - Command: claude.CMD -p /analyze-repository; Spawn three subagents to understand how the information at this website is used in the zen directory. https://docs.claude.com/en/docs/about-claude/pricing#tool-use-pricing. --output-format=stream-json --permission-mode=bypassPermissions --verbose
+
+2025-09-18 15:00:09,738 - zen_orchestrator - INFO - Permission mode: bypassPermissions (Platform: Windows)
+2025-09-18 15:00:09,746 - zen_orchestrator - INFO - Instance analyze-repository started with PID 672
+
++=== STATUS REPORT [15:00:14] ===+
+| Total: 1 instances
+| Running: 1, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 0 total, 0 cached | Median: 0 | Tools: 0
+| 💰 Cost: $0.0000 total, $0.0000 avg/instance | Pricing: Claude compliant
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repository             opus4      5.1s       0        0        0        0        0      -
++================================+
+
+
++=== STATUS REPORT [15:00:19] ===+
+| Total: 1 instances
+| Running: 1, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 14.7K total, 14.7K cached | Median: 14.7K | Tools: 0
+| 💰 Cost: $0.0798 total, $0.0798 avg/instance | Pricing: Claude compliant
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repository             opus4      10.1s      14.7K    6        3.3K     11.4K    0      -
++================================+
+
+```
+
 
 ## Inspiration and background
 While developing Netra Apex (commercial product)
@@ -258,7 +458,7 @@ yields:
 usage: zen [-h] [--workspace WORKSPACE] [--config CONFIG] [--dry-run] [--list-commands] [--inspect-command INSPECT_COMMAND]
            [--output-format {json,stream-json}] [--timeout TIMEOUT] [--max-console-lines MAX_CONSOLE_LINES] [--quiet]
            [--startup-delay STARTUP_DELAY] [--max-line-length MAX_LINE_LENGTH] [--status-report-interval STATUS_REPORT_INTERVAL]
-           [--start-at START_AT] [--use-cloud-sql] [--overall-token-budget OVERALL_TOKEN_BUDGET] [--command-budget COMMAND_BUDGET]
+           [--start-at START_AT] [--overall-token-budget OVERALL_TOKEN_BUDGET] [--command-budget COMMAND_BUDGET]
            [--budget-enforcement-mode {warn,block}] [--disable-budget-visuals]
 
 Claude Code Instance Orchestrator

netra_zen-1.0.1/config_example.json

@@ -0,0 +1,12 @@
+{
+  "instances": [
+    {
+      "name": "analyze-repository",
+      "command": "/analyze-repository; Spawn three subagents to understand how the information at this website is used in the zen directory. https://docs.claude.com/en/docs/about-claude/pricing#tool-use-pricing.",
+      "description": "Reads and understands the required portion of the repository",
+      "permission_mode": "bypassPermissions",
+      "output_format": "stream-json",
+      "max_tokens_per_command": 5000
+    }
+  ]
+}

{netra_zen-1.0.0 → netra_zen-1.0.1}/docs/Cost_allocation.md

@@ -361,7 +361,6 @@ status.cached_tokens = status.cache_read_tokens + status.cache_creation_tokens
 - Custom pricing override capabilities
 
 ### Integration Roadmap
-- Enhanced CloudSQL metrics persistence
 - Advanced reporting dashboards
 - Cost forecasting and predictions
 - Team and project cost allocation

{netra_zen-1.0.0 → netra_zen-1.0.1/netra_zen.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: netra-zen
-Version: 1.0.0
+Version: 1.0.1
 Summary: Multi-instance Claude orchestrator for parallel task execution
 Home-page: https://github.com/netra-systems/zen
 Author:  Systems
@@ -79,10 +79,210 @@ Example portion of status report:
 ║  ⏳        quality-synthesizer    queued    0K
 ╚════════════════════════════════════════════╝
 ```
-Here you can see we are running 5 instances of claude.
-- 2 have completed
-- 2 are running
-- 1 is scheduled
+
+## Example Start
+```
+zen
+```
+
+```
++=== STATUS REPORT [14:47:39] ===+
+| Total: 2 instances
+| Running: 2, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 0 total, 0 cached | Median: 0 | Tools: 0
+| 💰 Cost: $0.0000 total, $0.0000 avg/instance | Pricing: Claude compliant
+|
+| TOKEN BUDGET STATUS |
+| Overall: [--------------------] 0% 0/10.0K
+| Command Budgets:
+|                        /analyze-repository  [--------------------] 0% 0/5.0K
+|                        /README              [--------------------] 0% 0/1.0K
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repo                   opus4      5.1s       0        0        0        0        0      0/5.0K
+|  🏃        help-overview                  sonnet4    0.0s       0        0        0        0        0      0/1.0K
++================================+
+```
+
+## Budget Warning Only
+```
+zen --overall-token-budget 10000
+```
+```
++=== STATUS REPORT [14:47:44] ===+
+| Total: 2 instances
+| Running: 2, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 32.2K total, 32.2K cached | Median: 32.2K | Tools: 1
+| 💰 Cost: $0.0818 total, $0.0409 avg/instance | Pricing: Claude compliant
+|
+| TOKEN BUDGET STATUS |
+| Overall: [####################] 100% 32.2K/10.0K
+| Command Budgets:
+|                        /analyze-repository  [####################] 100% 32.2K/5.0K
+|                        /README              [--------------------] 0% 0/1.0K
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repo                   35sonnet   10.1s      32.2K    5        20.9K    11.4K    1      32.2K/5.0K
+|  🏃        help-overview                  opus4      5.0s       0        0        0        0        0      0/1.0K
++================================+
+
++=== TOOL USAGE DETAILS ===+
+| Tool Name            Uses     Tokens     Cost ($)   Used By
+| -------------------- -------- ---------- ---------- -----------------------------------
+| Bash                 1        33         0.0001     analyze-repo(1 uses, 33 tok)
+| -------------------- -------- ---------- ---------- -----------------------------------
+| TOTAL                1        33         0.0001
++===============================================================================================+
+```
+
+## Budget Block
+```
+zen --overall-token-budget 10000 --budget-enforcement-mode block
+```
+```
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - 💰 BUDGET UPDATE [analyze-repo]: Recording 32240 tokens for command '/analyze-repository'
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - 📊 BUDGET STATE [analyze-repo]: /analyze-repository now at 32240/5000 tokens (644.8%)
+2025-09-18 14:50:42,050 - zen_orchestrator - ERROR - 🚫 🔴 RUNTIME TERMINATION: Runtime budget violation for analyze-repo: Overall budget exceeded: 32240/10000 tokens
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - Terminating instance analyze-repo (PID: 88916): Terminated due to budget violation - Overall budget exceeded: 32240/10000 tokens
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - Sent SIGTERM to analyze-repo (PID: 88916)
+```
+
+```
++=== FINAL STATUS [14:50:57] ===+
+| Total: 2 instances
+| Running: 0, Completed: 0, Failed: 2, Pending: 0
+| Tokens: 85.6K total, 85.2K cached | Median: 42.8K | Tools: 1
+| 💰 Cost: $0.0889 total, $0.0444 avg/instance | Pricing: Claude compliant
+|
+| TOKEN BUDGET STATUS |
+| Overall: [####################] 100% 85.6K/10.0K
+| Command Budgets:
+|                        /analyze-repository  [####################] 100% 48.4K/5.0K
+|                        /README              [####################] 100% 37.2K/1.0K
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  ❌        analyze-repo                   sonnet4    22.5s      48.4K    31       16.1K    32.2K    1      48.4K/5.0K
+|  ❌        help-overview                  35sonnet   16.2s      37.2K    422      0        36.8K    0      37.2K/1.0K
++===============================+
+
++=== TOOL USAGE DETAILS ===+
+| Tool Name            Uses     Tokens     Cost ($)   Used By
+| -------------------- -------- ---------- ---------- -----------------------------------
+| Task                 1        348        0.0010     analyze-repo(1 uses, 348 tok)
+| -------------------- -------- ---------- ---------- -----------------------------------
+| TOTAL                1        348        0.0010
++===============================================================================================+
+```
+
+# Example Start At
+```
+zen --start-at "2am"
+```
+
+```
+...
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Added instance: analyze-repo - Analyze the repository structure and codebase
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Added instance: help-overview - Show project README and overview information
+
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Orchestration scheduled to start at: 2025-09-19 02:00:00
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Waiting 39930.1 seconds (11.1 hours) until start time...
+```
+
+# Example Command
+** Assumes you have a claude command \runtests **
+```
+zen "/runtests"
+```
+```
+...
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Added instance: direct-runtests-3337c2c5 - Direct execution of /runtests
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Starting Claude Code instance orchestration
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Starting 1 instances with 5.0s delay between launches (timeout: 10000s each)
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Now starting instance 'direct-runtests-3337c2c5' (after 0.0s delay)
+
+```
+# Example Config (Recommended Usage)
+
+Your JSON file as `path\my_config.json`
+```JSON
+{
+  "instances": [
+    {
+      "name": "analyze-repository",
+      "command": "/analyze-repository; Spawn three subagents to understand how the information at this website is used in the zen directory. https://docs.claude.com/en/docs/about-claude/pricing#tool-use-pricing.",
+      "description": "Reads and understands the required portion of the repository",
+      "permission_mode": "bypassPermissions",
+      "output_format": "stream-json",
+      "max_tokens_per_command": 5000
+    }
+  ]
+}
+```
+```
+zen --config path\my_config.json
+```
+
+```
+...
+
+2025-09-18 15:00:09,645 - zen_orchestrator - INFO - Loading config from config_example.json
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - 🎯 Token transparency pricing engine enabled - Claude pricing compliance active
+
+2025-09-18 15:00:09,657 - zen_orchestrator - WARNING - Command '/analyze-repository; Spawn three subagents to understand how the information at this website is used in the zen directory. https://docs.claude.com/en/docs/about-claude/pricing#tool-use-pricing.' not found in available commands
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - Available commands: /clear, /compact, /help
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - Added instance: analyze-repository - Reads and understands the required portion of the repository
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - Starting Claude Code instance orchestration
+
+2025-09-18 15:00:09,659 - zen_orchestrator - INFO - Starting 1 instances with 5.0s delay between launches (timeout: 10000s each)
+
+2025-09-18 15:00:09,659 - zen_orchestrator - INFO - Now starting instance 'analyze-repository' (after 0.0s delay)
+
+2025-09-18 15:00:09,659 - zen_orchestrator - INFO - Starting instance: analyze-repository
+
+2025-09-18 15:00:09,665 - zen_orchestrator - INFO - Command: claude.CMD -p /analyze-repository; Spawn three subagents to understand how the information at this website is used in the zen directory. https://docs.claude.com/en/docs/about-claude/pricing#tool-use-pricing. --output-format=stream-json --permission-mode=bypassPermissions --verbose
+
+2025-09-18 15:00:09,738 - zen_orchestrator - INFO - Permission mode: bypassPermissions (Platform: Windows)
+2025-09-18 15:00:09,746 - zen_orchestrator - INFO - Instance analyze-repository started with PID 672
+
++=== STATUS REPORT [15:00:14] ===+
+| Total: 1 instances
+| Running: 1, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 0 total, 0 cached | Median: 0 | Tools: 0
+| 💰 Cost: $0.0000 total, $0.0000 avg/instance | Pricing: Claude compliant
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repository             opus4      5.1s       0        0        0        0        0      -
++================================+
+
+
++=== STATUS REPORT [15:00:19] ===+
+| Total: 1 instances
+| Running: 1, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 14.7K total, 14.7K cached | Median: 14.7K | Tools: 0
+| 💰 Cost: $0.0798 total, $0.0798 avg/instance | Pricing: Claude compliant
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repository             opus4      10.1s      14.7K    6        3.3K     11.4K    0      -
++================================+
+
+```
+
 
 ## Inspiration and background
 While developing Netra Apex (commercial product)
@@ -304,7 +504,7 @@ yields:
 usage: zen [-h] [--workspace WORKSPACE] [--config CONFIG] [--dry-run] [--list-commands] [--inspect-command INSPECT_COMMAND]
            [--output-format {json,stream-json}] [--timeout TIMEOUT] [--max-console-lines MAX_CONSOLE_LINES] [--quiet]
            [--startup-delay STARTUP_DELAY] [--max-line-length MAX_LINE_LENGTH] [--status-report-interval STATUS_REPORT_INTERVAL]
-           [--start-at START_AT] [--use-cloud-sql] [--overall-token-budget OVERALL_TOKEN_BUDGET] [--command-budget COMMAND_BUDGET]
+           [--start-at START_AT] [--overall-token-budget OVERALL_TOKEN_BUDGET] [--command-budget COMMAND_BUDGET]
            [--budget-enforcement-mode {warn,block}] [--disable-budget-visuals]
 
 Claude Code Instance Orchestrator

{netra_zen-1.0.0 → netra_zen-1.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "netra-zen"
-version = "1.0.0"
+version = "1.0.1"
 description = "Multi-instance Claude orchestrator for parallel task execution"
 readme = "README.md"
 authors = [

{netra_zen-1.0.0 → netra_zen-1.0.1}/setup.py

@@ -8,7 +8,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="netra-zen",
-    version="1.0.0",
+    version="1.0.1",
     author=" Systems",
     author_email="pypi@netrasystems.ai",
     description="Multi-instance Claude orchestrator for parallel task execution",

{netra_zen-1.0.0 → netra_zen-1.0.1}/tests/test_zen_unit.py

@@ -346,7 +346,6 @@ class TestClaudeInstanceOrchestratorInit:
         assert orchestrator.startup_delay == 1.0
         assert orchestrator.max_line_length == 500
         assert orchestrator.status_report_interval == 30
-        assert orchestrator.use_cloud_sql is False
         assert orchestrator.quiet is False
         assert orchestrator.batch_id is not None
         assert len(orchestrator.batch_id) == 36  # UUID length
@@ -359,7 +358,6 @@ class TestClaudeInstanceOrchestratorInit:
             startup_delay=2.5,
             max_line_length=1000,
             status_report_interval=60,
-            use_cloud_sql=True,
             quiet=True
         )
 
@@ -368,24 +366,8 @@ class TestClaudeInstanceOrchestratorInit:
         assert orchestrator.startup_delay == 2.5
         assert orchestrator.max_line_length == 1000
         assert orchestrator.status_report_interval == 60
-        assert orchestrator.use_cloud_sql is True
         assert orchestrator.quiet is True
 
-    def test_orchestrator_cloud_sql_disabled(self):
-        """Test that CloudSQL configuration is disabled for security"""
-        with patch.dict(os.environ, {}, clear=True):
-            orchestrator = ClaudeInstanceOrchestrator(
-                workspace_dir=self.workspace,
-                use_cloud_sql=True
-            )
-
-            # CloudSQL functionality disabled for security
-            assert orchestrator.use_cloud_sql is True  # Flag preserved for backward compatibility
-            # But no environment variables should be set for security
-            assert os.environ.get('POSTGRES_PORT') is None
-            assert os.environ.get('POSTGRES_HOST') is None
-            assert os.environ.get('POSTGRES_DB') is None
-            assert os.environ.get('POSTGRES_USER') is None
 
     def test_add_instance(self):
         """Test adding instances to orchestrator"""

{netra_zen-1.0.0 → netra_zen-1.0.1}/zen_orchestrator.py

@@ -180,7 +180,7 @@ class ClaudeInstanceOrchestrator:
 
     def __init__(self, workspace_dir: Path, max_console_lines: int = 5, startup_delay: float = 1.0,
                  max_line_length: int = 500, status_report_interval: int = 30,
-                 use_cloud_sql: bool = False, quiet: bool = False,
+                 quiet: bool = False,
                  overall_token_budget: Optional[int] = None,
                  overall_cost_budget: Optional[float] = None,
                  budget_type: str = "tokens",
@@ -199,7 +199,6 @@ class ClaudeInstanceOrchestrator:
         self.status_report_interval = status_report_interval  # Seconds between status reports
         self.last_status_report = time.time()
         self.status_report_task = None  # For the rolling status report task
-        self.use_cloud_sql = use_cloud_sql
         self.quiet = quiet
         self.log_level = log_level
         self.batch_id = str(uuid4())  # Generate batch ID for this orchestration run
@@ -243,11 +242,6 @@ class ClaudeInstanceOrchestrator:
         else:
             logger.debug("Token budget tracking disabled (no budget specified)")
 
-        # Configure CloudSQL if requested
-        # CloudSQL functionality available with Netra Apex
-        if use_cloud_sql:
-            logger.warning("CloudSQL functionality has been disabled. Token metrics will be displayed locally only.")
-            logger.info("For data persistence, consider upgrading to Netra Apex.")
 
     def log_at_level(self, level: LogLevel, message: str, log_func=None):
         """Log message only if current log level permits."""
@@ -2498,7 +2492,6 @@ async def main():
         startup_delay=args.startup_delay,
         max_line_length=args.max_line_length,
         status_report_interval=args.status_report_interval,
-        use_cloud_sql=args.use_cloud_sql,
         quiet=args.quiet,
         overall_token_budget=final_overall_budget,
         overall_cost_budget=final_overall_cost_budget,
@@ -2726,9 +2719,6 @@ async def main():
 
     # Run all instances
     logger.info("Starting Claude Code instance orchestration")
-    if args.use_cloud_sql:
-        logger.info(f"Batch ID: {orchestrator.batch_id}")
-        logger.info("Metrics will be saved to CloudSQL")
     start_time = time.time()
 
     results = await orchestrator.run_all_instances(args.timeout)
@@ -2867,12 +2857,6 @@ async def main():
     print("🌐 Learn more: https://netrasystems.ai/")
     print("="*80)
 
-    # Show CloudSQL info if enabled
-    if args.use_cloud_sql:
-        print(f"\n📊 Local metrics displayed above")
-        print(f"   Batch ID: {orchestrator.batch_id}")
-        print(f"   Database persistence disabled for security")
-
     # Exit with appropriate code
     sys.exit(0 if summary['failed'] == 0 else 1)
 

netra_zen-1.0.0/config_example.json

@@ -1,12 +0,0 @@
-{
-    "instances": [
-      {
-        "name": "analyze-repository",
-        "command": "/analyze-repository; Spawn three subagents to understand how the information at this website is used in the zen directory. https://docs.claude.com/en/docs/about-claude/pricing#tool-use-pricing.",
-        "description": "Reads and understands the required portion of the repository",
-        "permission_mode": "bypassPermissions",
-        "output_format": "stream-json",
-        "max_tokens_per_command": 5000
-      }
-    ]
-  }