agentgov-cli 0.1.15__tar.gz → 0.1.16__tar.gz

{agentgov_cli-0.1.15 → agentgov_cli-0.1.16}/.gitignore

@@ -85,3 +85,12 @@ cli/agentgov_cli/client_assets/
 
 # Scratch dir used by tooling when the system temp dir is unavailable.
 .wf-tmp/
+
+# One-time scripts, patch drivers, debug output and generated diagrams, per the
+# root CLAUDE.md file-organization rules. These are working files by definition —
+# the repo-root CLAUDE.md sends them here precisely so they stay out of the tree,
+# and without this rule `git add -A` sweeps them into a commit. Ignored as a
+# directory rather than by pattern because the whole point of the directory is
+# that anything may land in it.
+temp/
+.gstack/

{agentgov_cli-0.1.15 → agentgov_cli-0.1.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agentgov-cli
-Version: 0.1.15
+Version: 0.1.16
 Summary: AgentGov CLI — wrap Claude Code, bind work items, check gateway health.
 Author: AgentGov Contributors
 License: Apache-2.0
@@ -29,7 +29,9 @@ Part of the AgentGov project — see [github.com/deepakahu/agentGov](https://git
 ## Install
 
 ```bash
-pip install agentgov agentgov-gateway
+# Both distributions, always together: the CLI and the gateway ship separately
+# and a version skew between them is not detectable from the CLI side.
+pip install -U agentgov-cli agentgov-gateway
 ```
 
 ## First-time setup

{agentgov_cli-0.1.15 → agentgov_cli-0.1.16}/README.md

@@ -9,7 +9,9 @@ Part of the AgentGov project — see [github.com/deepakahu/agentGov](https://git
 ## Install
 
 ```bash
-pip install agentgov agentgov-gateway
+# Both distributions, always together: the CLI and the gateway ship separately
+# and a version skew between them is not detectable from the CLI side.
+pip install -U agentgov-cli agentgov-gateway
 ```
 
 ## First-time setup

agentgov_cli-0.1.16/agentgov_cli/claude_env.py

@@ -0,0 +1,69 @@
+"""What AgentGov puts into Claude Code's environment to route it through the gateway.
+
+Two variables, always set together:
+
+    ANTHROPIC_BASE_URL                        points Claude Code at the gateway.
+    _CLAUDE_CODE_ASSUME_FIRST_PARTY_BASE_URL  tells Claude Code that whatever is at
+                                              that URL forwards to api.anthropic.com.
+
+WHY THE SECOND ONE IS NOT OPTIONAL
+----------------------------------
+Claude Code decides how large a model's context window is before it sends a
+request, and it only trusts a model's native 1M window when it believes it is
+talking to Anthropic directly. Its test for that is literal: `ANTHROPIC_BASE_URL`
+unset, or its host equal to `api.anthropic.com`. A base URL of `localhost:8000`
+fails the test, so a natively-1M model such as `claude-opus-5` is given a 200k
+window instead, and auto-compaction fires at roughly 165k tokens — five to six
+times as often as the same model ungoverned. Observed on a developer machine:
+four automatic compactions in seventy minutes, at 166k, 167k and 172k tokens, in
+a session that had earlier reached 541k without one. The gateway relayed every
+byte faithfully; the mistake was the client's belief about the window.
+
+The override is Claude Code's own escape hatch for exactly this shape — a proxy
+in front of the real API. Verified by reading the Claude Code 2.1.233 binary:
+its first-party check returns true when the variable is set and otherwise
+requires the `api.anthropic.com` host, and the context-window function falls
+through to 200000 whenever that check is false and the model string carries no
+explicit `[1m]` suffix. The name is internal to Claude Code and could change in
+a later release, so `agentgov doctor` and the SessionStart hook both report when
+it is missing, and the symptom to re-check after a Claude Code upgrade is the
+one above.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Mapping
+
+FIRST_PARTY_OVERRIDE = "_CLAUDE_CODE_ASSUME_FIRST_PARTY_BASE_URL"
+
+# The Claude Code release whose binary the behaviour above was read from.
+CLAUDE_CODE_VERIFIED = "2.1.233"
+
+
+def routing_env(gateway_url: str) -> dict[str, str]:
+    """The environment that routes Claude Code through `gateway_url`, complete."""
+    return {"ANTHROPIC_BASE_URL": gateway_url, FIRST_PARTY_OVERRIDE: "1"}
+
+
+def is_routed(env: Mapping[str, str]) -> bool:
+    return bool((env.get("ANTHROPIC_BASE_URL") or "").strip())
+
+
+def lacks_first_party_override(env: Mapping[str, str]) -> bool:
+    """True when Claude Code is routed through a proxy but never told it is first-party.
+
+    That is the configuration that shrinks the context window. An unrouted
+    environment is fine by definition, and so is one that carries the override.
+    """
+    return is_routed(env) and not (env.get(FIRST_PARTY_OVERRIDE) or "").strip()
+
+
+# One sentence, shared by `agentgov doctor` and the SessionStart hook (which
+# inlines a copy, because hooks run outside this package). A test keeps the
+# hook's copy identical.
+CONTEXT_WINDOW_WARNING = (
+    "Claude Code is routed through the gateway without "
+    f"{FIRST_PARTY_OVERRIDE}=1, so it assumes a 200k context window and "
+    "compacts early. Run `agentgov install` again to regenerate the routing "
+    "settings, or launch with `agentgov wrap claude`; then restart Claude Code."
+)