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

{agentgov_cli-0.1.14 → 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.14 → agentgov_cli-0.1.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agentgov-cli
-Version: 0.1.14
+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.14 → 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/__init__.py

@@ -0,0 +1,19 @@
+"""AgentGov CLI. Developer-laptop tool: wrap · workitem · status · doctor."""
+
+from importlib.metadata import PackageNotFoundError
+from importlib.metadata import version as _pkg_version
+
+# ONE source of truth: pyproject.toml, read back through the installed package
+# metadata. This was a hand-maintained literal stuck at "0.1.0" while pyproject
+# said 0.1.14 — the same drift that was fixed in agentgov_gateway/__init__.py
+# and not carried across. Nothing reads it yet, which is precisely why it was
+# free to rot; the first `--version` flag anyone adds would have shipped a lie.
+#
+# The fallback covers running straight from a source checkout, where nothing is
+# installed and there is no metadata to read.
+try:
+    __version__ = _pkg_version("agentgov-cli")
+except PackageNotFoundError:  # pragma: no cover — source checkout only
+    __version__ = "0.0.0+source"
+
+__all__ = ["__version__"]

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."
+)

{agentgov_cli-0.1.14 → agentgov_cli-0.1.16}/agentgov_cli/client_assets/commands/workitem.md

@@ -1,5 +1,5 @@
 ---
-description: Bind this session to a work item — ticket id, URL, or any short label
+description: Bind without sending a prompt. Usually unnecessary — write [PROJ-1234] at the start of your prompt instead
 allowed-tools: Bash(agentgov workitem:*)
 argument-hint: <PROJ-1234 | https://tracker/issue/42 | any short label>
 ---
@@ -9,6 +9,11 @@ argument-hint: <PROJ-1234 | https://tracker/issue/42 | any short label>
 The command above has already run and its output is shown. Relay that output to
 the user verbatim — do not restate, reformat, or interpret it — and then stop.
 
+This command is the SECONDARY way to bind. The primary way is to open a prompt
+with the work item in square brackets — `[PROJ-1234] add the retry loop` — which
+binds and asks in one message. This command exists for binding without sending a
+prompt, and for the `accept` verb.
+
 If it reported a successful bind, simply acknowledge it and carry on with
 whatever the user was doing. If it reported a failure, show the message as-is;
 it already contains the remediation step.