gator-command 1.0.0__py3-none-any.whl

gator_command/__init__.py

@@ -0,0 +1,2 @@
+"""Gator Command — Git-native governance for AI-assisted engineering."""
+__version__ = "1.0.0"

gator_command/cli.py

@@ -0,0 +1,137 @@
+"""
+gator — unified CLI for Gator Command.
+
+Dispatches to existing Gator scripts. This is the thin wrapper that makes
+`pipx install gator-command` → `gator <command>` work.
+
+For source-checkout and public-clone modes, scripts are resolved from the
+filesystem relative to gator_runtime.py. For installed-package mode,
+scripts are resolved from the package installation.
+"""
+
+import argparse
+import subprocess
+import sys
+from pathlib import Path
+
+
+# ---------------------------------------------------------------------------
+# Script resolution
+# ---------------------------------------------------------------------------
+
+def _find_scripts_dir():
+    """Find the Gator scripts directory.
+
+    Resolution order:
+    1. Package-bundled scripts (works for pip install and pipx install)
+    2. Source checkout: gator-command/scripts/ relative to repo root
+    3. Public clone: gator-engine/scripts/ relative to repo root
+    """
+    cli_dir = Path(__file__).resolve().parent
+
+    # Installed package: scripts bundled as package data
+    candidate = cli_dir / "scripts"
+    if candidate.is_dir() and (candidate / "gator_core.py").exists():
+        return candidate
+
+    # Source checkout: cli.py is at src/gator_command/cli.py → repo root is ../../
+    repo_root = cli_dir.parent.parent
+    candidate = repo_root / "gator-command" / "scripts"
+    if candidate.is_dir() and (candidate / "gator_core.py").exists():
+        return candidate
+
+    # Public clone: gator-engine/scripts/
+    candidate = repo_root / "gator-engine" / "scripts"
+    if candidate.is_dir() and (candidate / "gator_core.py").exists():
+        return candidate
+
+    return None
+
+
+def _run_script(scripts_dir, script_name, args):
+    """Run a Gator script by name, forwarding arguments."""
+    script_path = scripts_dir / script_name
+    if not script_path.exists():
+        print(f"  Error: script not found: {script_name}", file=sys.stderr)
+        print(f"  Looked in: {scripts_dir}", file=sys.stderr)
+        sys.exit(1)
+    result = subprocess.run(
+        [sys.executable, str(script_path)] + args,
+    )
+    sys.exit(result.returncode)
+
+
+# ---------------------------------------------------------------------------
+# Command definitions
+# ---------------------------------------------------------------------------
+
+COMMANDS = {
+    "version":    ("gator-version.py",       "Show Gator version"),
+    "init":       ("gator-init.py",          "Run session-opening procedure"),
+    "pulse":      ("gator-pulse.py",         "Generate strategic operations brief"),
+    "dashboard":  ("gator-dashboard.py",     "Start the governance dashboard"),
+    "audit":      ("gator-audit.py",         "Run governance audit"),
+    "drift":      ("gator-drift.py",         "Check fleet for governance drift"),
+    "fleet":      ("gator-fleet-report.py",  "Fleet status report"),
+}
+
+
+# ---------------------------------------------------------------------------
+# Entry point
+# ---------------------------------------------------------------------------
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="gator",
+        description="Gator — Git-native governance for AI-assisted engineering",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=(
+            "examples:\n"
+            "  gator version          Show installed version\n"
+            "  gator init             Start a governed session\n"
+            "  gator dashboard        Launch the governance dashboard\n"
+            "  gator pulse            Generate the strategic operations brief\n"
+        ),
+    )
+    parser.add_argument(
+        "--version", "-V",
+        action="version",
+        version=f"%(prog)s {_get_version()}",
+    )
+
+    sub = parser.add_subparsers(dest="command")
+    for cmd_name, (_, help_text) in COMMANDS.items():
+        sub.add_parser(cmd_name, help=help_text, add_help=False)
+
+    args, remaining = parser.parse_known_args()
+
+    if not args.command:
+        parser.print_help()
+        sys.exit(0)
+
+    scripts_dir = _find_scripts_dir()
+    if not scripts_dir:
+        print("  Error: Gator scripts directory not found.", file=sys.stderr)
+        print("  Run from a Gator checkout, or install with: pipx install gator-command", file=sys.stderr)
+        sys.exit(1)
+
+    script_name, _ = COMMANDS[args.command]
+    _run_script(scripts_dir, script_name, remaining)
+
+
+def _get_version():
+    """Get version from package metadata or VERSION file."""
+    try:
+        from gator_command import __version__
+        return __version__
+    except ImportError:
+        pass
+    # Fallback: read VERSION file
+    version_file = Path(__file__).resolve().parent.parent.parent / "VERSION"
+    if version_file.exists():
+        return version_file.read_text(encoding="utf-8").strip()
+    return "unknown"
+
+
+if __name__ == "__main__":
+    main()