guard-cli 0.1.1__tar.gz → 0.1.3__tar.gz

{guard_cli-0.1.1 → guard_cli-0.1.3}/PKG-INFO

@@ -1,8 +1,12 @@
 Metadata-Version: 2.4
 Name: guard-cli
-Version: 0.1.1
+Version: 0.1.3
 Summary: Graph-powered safety layer for AI coding agents built on FalkorDB
 License-Expression: MIT
+Project-URL: Homepage, https://github.com/thisisvaishnav/guard
+Project-URL: Repository, https://github.com/thisisvaishnav/guard
+Project-URL: Bug Tracker, https://github.com/thisisvaishnav/guard/issues
+Project-URL: Changelog, https://github.com/thisisvaishnav/guard/blob/main/CHANGELOG.md
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -176,7 +180,13 @@ $$\text{Trust} = 0.5 \cdot \text{EvidenceRatio} + 0.3 \cdot \text{Freshness} + 0
 
 ## Claude Code & Agent Integration
 
-Guard integrates seamlessly into autonomous coding workflows:
+> **Experimental**: Both the Claude Code Stop hook and the Antigravity integration are
+> labeled **experimental**. The Antigravity `hooks.json` schema was verified against
+> [Antigravity's official hook documentation](https://antigravity.google/docs/hooks), but
+> both integrations have only been validated with simulated stdin/stdout input. A real
+> live session (Claude Code, Antigravity) has not yet confirmed end-to-end behavior.
+
+Guard integrates into autonomous coding workflows:
 
 - **Claude Code Stop Hook**: Installed via `guard hook install` into `.claude/settings.local.json`. Whenever Claude attempts to conclude a task, the Stop hook evaluates the diff. If tests fail, it blocks completion (Exit 2) and injects a concise $\le$ 30 line failure report.
 - **Idle-Turn Optimization**: Caches working-tree SHA-256 fingerprints and skips unchanged turns and non-Python diffs.
@@ -228,11 +238,11 @@ guard check [--repo /path/to/repo] [--json]
 ```
 
 ### `guard hook`
-Manages Claude Code and agent hook configurations:
+Manages Claude Code and agent hook configurations (experimental — see note above):
 ```bash
-guard hook install [--shared]
+guard hook install [--shared] [--antigravity]
 guard hook status
-guard hook uninstall
+guard hook uninstall [--antigravity]
 ```
 
 ### `guard feedback`

{guard_cli-0.1.1 → guard_cli-0.1.3}/README.md

@@ -155,7 +155,13 @@ $$\text{Trust} = 0.5 \cdot \text{EvidenceRatio} + 0.3 \cdot \text{Freshness} + 0
 
 ## Claude Code & Agent Integration
 
-Guard integrates seamlessly into autonomous coding workflows:
+> **Experimental**: Both the Claude Code Stop hook and the Antigravity integration are
+> labeled **experimental**. The Antigravity `hooks.json` schema was verified against
+> [Antigravity's official hook documentation](https://antigravity.google/docs/hooks), but
+> both integrations have only been validated with simulated stdin/stdout input. A real
+> live session (Claude Code, Antigravity) has not yet confirmed end-to-end behavior.
+
+Guard integrates into autonomous coding workflows:
 
 - **Claude Code Stop Hook**: Installed via `guard hook install` into `.claude/settings.local.json`. Whenever Claude attempts to conclude a task, the Stop hook evaluates the diff. If tests fail, it blocks completion (Exit 2) and injects a concise $\le$ 30 line failure report.
 - **Idle-Turn Optimization**: Caches working-tree SHA-256 fingerprints and skips unchanged turns and non-Python diffs.
@@ -207,11 +213,11 @@ guard check [--repo /path/to/repo] [--json]
 ```
 
 ### `guard hook`
-Manages Claude Code and agent hook configurations:
+Manages Claude Code and agent hook configurations (experimental — see note above):
 ```bash
-guard hook install [--shared]
+guard hook install [--shared] [--antigravity]
 guard hook status
-guard hook uninstall
+guard hook uninstall [--antigravity]
 ```
 
 ### `guard feedback`

{guard_cli-0.1.1 → guard_cli-0.1.3}/guard_cli/__init__.py

@@ -4,4 +4,4 @@ from importlib.metadata import version, PackageNotFoundError
 try:
     __version__ = version("guard-cli")
 except PackageNotFoundError:
-    __version__ = "0.1.1"
+    __version__ = "0.1.2"

{guard_cli-0.1.1 → guard_cli-0.1.3}/guard_cli/api.py

@@ -227,6 +227,49 @@ def run(
             "fail_open": True,
         }, 0
 
+    # Fail-open short-circuit: if check() could not evaluate the diff (database/graph
+    # unavailable), do not attempt the full-suite fallback. Running the whole suite on an
+    # unknown diff is itself unreliable (e.g. Guard's own tests require FalkorDB), so we
+    # allow the stop with a loud warning and record a fail_open event, matching Guard's
+    # documented fail-open behavior instead of blocking the agent.
+    if check_dict.get("fail_open") or check_dict.get("policy") == "fail_open":
+        reason = (
+            check_dict.get("fallback_reason")
+            or check_dict.get("error")
+            or "Guard database/graph unavailable"
+        )
+        if strict:
+            raise RuntimeError(f"Guard fail-open suppressed by strict mode: {reason}")
+        sys.stderr.write(
+            f"Guard warning (fail-open): {reason}. "
+            "Skipping safety check and allowing stop without running tests.\n"
+        )
+        log_event(
+            event="fail_open",
+            session_id=session_id,
+            repo_path=repo,
+            details={"op": "run", "error": reason},
+        )
+        return {
+            "version": SCHEMA_VERSION,
+            "status": "passed",
+            "policy": "fail_open",
+            "trust": 0.0,
+            "overrides_triggered": check_dict.get("overrides_triggered", ["fail_open_error"]),
+            "selected_tests": [],
+            "failures": [],
+            "reasons": check_dict.get("reasons", {}),
+            "tests_run": [],
+            "tests_run_count": 0,
+            "tests_passed": True,
+            "forced_full": False,
+            "fallback_reason": reason,
+            "duration_s": 0.0,
+            "exit_code": 0,
+            "output_summary": f"Guard bypassed fail-open: {reason}",
+            "fail_open": True,
+        }, 0
+
     forced_full = check_dict.get("is_fallback", False) or (check_dict.get("status") == "run-all")
     if forced_full:
         tests_to_run = ["tests"]

{guard_cli-0.1.1 → guard_cli-0.1.3}/guard_cli/cli.py

@@ -171,23 +171,42 @@ def cmd_hook_stop(args) -> int:
     )
 
 
+def cmd_hook_session_start(args) -> int:
+    from guard_cli.hook import run_session_start_hook
+    return run_session_start_hook(repo_override=args.repo)
+
+
 def cmd_hook_install(args) -> int:
-    from guard_cli.integrations import claude
-    ok, msg = claude.install(repo_path=args.repo, shared=args.shared)
+    if getattr(args, "antigravity", False):
+        from guard_cli.integrations import antigravity
+        ok, msg = antigravity.install(repo_path=args.repo)
+    else:
+        from guard_cli.integrations import claude
+        ok, msg = claude.install(repo_path=args.repo, shared=args.shared)
     print(msg)
     return 0 if ok else 1
 
 
 def cmd_hook_uninstall(args) -> int:
-    from guard_cli.integrations import claude
-    ok, msg = claude.uninstall(repo_path=args.repo, shared=args.shared)
+    if getattr(args, "antigravity", False):
+        from guard_cli.integrations import antigravity
+        ok, msg = antigravity.uninstall(repo_path=args.repo)
+    else:
+        from guard_cli.integrations import claude
+        ok, msg = claude.uninstall(repo_path=args.repo, shared=args.shared)
     print(msg)
     return 0 if ok else 1
 
 
 def cmd_hook_status(args) -> int:
-    from guard_cli.integrations import claude
-    stat = claude.status(repo_path=args.repo, shared=args.shared)
+    from guard_cli.integrations import claude, antigravity
+    if getattr(args, "antigravity", False):
+        stat = {"antigravity": antigravity.status(repo_path=args.repo)}
+    else:
+        stat = {
+            "claude": claude.status(repo_path=args.repo, shared=getattr(args, "shared", False)),
+            "antigravity": antigravity.status(repo_path=args.repo),
+        }
     print(json.dumps(stat, indent=2))
     return 0
 
@@ -260,19 +279,26 @@ def main(argv=None) -> int:
     hk_stop.add_argument("--strict", action="store_true", help="fail closed on error")
     hk_stop.set_defaults(fn=cmd_hook_stop)
 
-    hk_inst = hk_sub.add_parser("install", help="Install Stop hook into Claude Code settings")
+    hk_start = hk_sub.add_parser("session-start", help="Record baseline SHA at session start (Claude Code SessionStart / Antigravity PreInvocation)")
+    hk_start.add_argument("--repo", default=None, help="path to repo root")
+    hk_start.set_defaults(fn=cmd_hook_session_start)
+
+    hk_inst = hk_sub.add_parser("install", help="Install Stop hook into agent settings (Claude Code by default, Antigravity with --antigravity)")
     hk_inst.add_argument("--repo", default=None, help="path to repo root")
     hk_inst.add_argument("--shared", action="store_true", help="install to settings.json instead of settings.local.json")
+    hk_inst.add_argument("--antigravity", action="store_true", help="install to Antigravity .agents/hooks.json instead of Claude Code settings")
     hk_inst.set_defaults(fn=cmd_hook_install)
 
-    hk_uninst = hk_sub.add_parser("uninstall", help="Uninstall Stop hook from Claude Code settings")
+    hk_uninst = hk_sub.add_parser("uninstall", help="Uninstall Stop hook from agent settings (Claude Code by default, Antigravity with --antigravity)")
     hk_uninst.add_argument("--repo", default=None, help="path to repo root")
     hk_uninst.add_argument("--shared", action="store_true", help="uninstall from settings.json instead of settings.local.json")
+    hk_uninst.add_argument("--antigravity", action="store_true", help="uninstall from Antigravity .agents/hooks.json instead of Claude Code settings")
     hk_uninst.set_defaults(fn=cmd_hook_uninstall)
 
-    hk_stat = hk_sub.add_parser("status", help="Check Claude Code hook installation status")
+    hk_stat = hk_sub.add_parser("status", help="Check hook installation status (Claude Code by default, Antigravity with --antigravity)")
     hk_stat.add_argument("--repo", default=None, help="path to repo root")
     hk_stat.add_argument("--shared", action="store_true", help="check settings.json instead of settings.local.json")
+    hk_stat.add_argument("--antigravity", action="store_true", help="check Antigravity .agents/hooks.json instead of Claude Code settings")
     hk_stat.set_defaults(fn=cmd_hook_status)
 
     fb = sub.add_parser("feedback")
@@ -313,6 +339,9 @@ def main(argv=None) -> int:
     cov.set_defaults(fn=cmd_covering_tests)
 
     args = p.parse_args(argv)
+    if not hasattr(args, "fn"):
+        p.print_help()
+        return 1
     return args.fn(args)
 
 

{guard_cli-0.1.1 → guard_cli-0.1.3}/guard_cli/doctor_cmd.py

@@ -316,6 +316,14 @@ def check_integrations(repo_path: Path) -> CheckResult:
     agy_info = antigravity.status(repo_path)
     if not claude_info["installed"] and not agy_info["installed"]:
         missing.append("hook in .agents/hooks.json or .claude/settings.json")
+    elif agy_info.get("installed") and not agy_info.get("executable_exists", True):
+        exe = agy_info.get("executable_path")
+        return CheckResult(
+            name="integrations",
+            status="fail",
+            message=f"Guard executable configured in .agents/hooks.json does not exist: {exe}.",
+            fix="Run 'guard init' or 'guard hook install --antigravity' to update executable path.",
+        )
 
     # 3. Check AGENTS.md or CLAUDE.md marked block
     agents_doc = repo_path / "AGENTS.md"