gator-command 1.1.0__tar.gz → 1.1.2__tar.gz

gator_command-1.1.2/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: gator-command
+Version: 1.1.2
+Summary: Git-native governance for AI-assisted engineering
+Author-email: Cumberland Laboratories <support@cumberlandlaboratories.com>
+License: MIT
+Project-URL: Homepage, https://github.com/cumberland-laboratories/gator
+Project-URL: Repository, https://github.com/cumberland-laboratories/gator
+Keywords: governance,ai,git,charters,audit,compliance
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Gator Command
+
+**Git-native governance for AI-assisted engineering.**
+
+Gator turns your repo into an intelligence surface. The AI agent builds structured maps of your codebase (charters), a strategic operations brief (pulse), and project assessments — all committed to Git. A deterministic pre-commit gate blocks commits when the agent changes code without updating the map.
+
+Local-first. Git-native. Works with Claude Code, Codex, Gemini CLI. MIT licensed.
+
+## Install
+
+```bash
+pip install pipx        # if you don't have pipx yet
+pipx ensurepath         # add to PATH (restart terminal after)
+
+pipx install gator-command
+```
+
+## Quick Start
+
+```bash
+cd /path/to/your/repo
+
+gator gatorize .        # install governance into this repo
+gator init              # start a governed session
+gator dashboard         # open the intelligence console
+```
+
+The agent reads the governance layer and orients to your project. Your first `git commit` fires the hooks.
+
+## Upgrade
+
+```bash
+pipx upgrade gator-command
+
+cd /path/to/your/repo
+gator gatorize .        # refresh templates and hooks
+```
+
+Your content is always preserved. Only templates and scripts refresh.
+
+## Commands
+
+| Command | What it does |
+|---------|-------------|
+| `gator gatorize <path>` | Install or upgrade governance in a repo |
+| `gator init` | Start a governed session (repairs hooks if needed) |
+| `gator dashboard` | Open the intelligence console |
+| `gator pulse` | Generate the strategic operations brief |
+| `gator audit` | Run governance audit |
+| `gator version` | Show installed version |
+
+## What Gator Provides
+
+- **Repo intelligence** — charters map code structure, pulse summarizes momentum, assessments provide AI-generated evaluation. All committed to Git.
+- **Governance enforcement** — a deterministic pre-commit hook that blocks commits when code changes without charter updates. No LLM in the gate. Configurable: strict, warn, or off.
+- **Dashboard** — a local web console for browsing your governance layer, session history, and project state. Full file history with git version navigation.
+- **Session persistence** — the governance layer carries project context across sessions and across models. Switch from Claude to Codex mid-project without losing architectural understanding.
+
+## How It Works
+
+1. `gator gatorize .` installs a `.gator/` folder into your repo with governance scaffolding
+2. AI agents read the constitution and charters to understand your codebase
+3. Every `git commit` runs a deterministic hook that validates charter-alongside-code
+4. Session snippets capture what context produced each commit
+5. `gator dashboard` makes it all browsable in a local web UI
+
+## Links
+
+- [Source code](https://github.com/cumberland-laboratories/gator)
+- [MIT License](https://github.com/cumberland-laboratories/gator/blob/main/LICENSE)
+
+---
+
+Built by [Cumberland Laboratories](https://github.com/cumberland-laboratories)

gator_command-1.1.2/PYPI_README.md

@@ -0,0 +1,74 @@
+# Gator Command
+
+**Git-native governance for AI-assisted engineering.**
+
+Gator turns your repo into an intelligence surface. The AI agent builds structured maps of your codebase (charters), a strategic operations brief (pulse), and project assessments — all committed to Git. A deterministic pre-commit gate blocks commits when the agent changes code without updating the map.
+
+Local-first. Git-native. Works with Claude Code, Codex, Gemini CLI. MIT licensed.
+
+## Install
+
+```bash
+pip install pipx        # if you don't have pipx yet
+pipx ensurepath         # add to PATH (restart terminal after)
+
+pipx install gator-command
+```
+
+## Quick Start
+
+```bash
+cd /path/to/your/repo
+
+gator gatorize .        # install governance into this repo
+gator init              # start a governed session
+gator dashboard         # open the intelligence console
+```
+
+The agent reads the governance layer and orients to your project. Your first `git commit` fires the hooks.
+
+## Upgrade
+
+```bash
+pipx upgrade gator-command
+
+cd /path/to/your/repo
+gator gatorize .        # refresh templates and hooks
+```
+
+Your content is always preserved. Only templates and scripts refresh.
+
+## Commands
+
+| Command | What it does |
+|---------|-------------|
+| `gator gatorize <path>` | Install or upgrade governance in a repo |
+| `gator init` | Start a governed session (repairs hooks if needed) |
+| `gator dashboard` | Open the intelligence console |
+| `gator pulse` | Generate the strategic operations brief |
+| `gator audit` | Run governance audit |
+| `gator version` | Show installed version |
+
+## What Gator Provides
+
+- **Repo intelligence** — charters map code structure, pulse summarizes momentum, assessments provide AI-generated evaluation. All committed to Git.
+- **Governance enforcement** — a deterministic pre-commit hook that blocks commits when code changes without charter updates. No LLM in the gate. Configurable: strict, warn, or off.
+- **Dashboard** — a local web console for browsing your governance layer, session history, and project state. Full file history with git version navigation.
+- **Session persistence** — the governance layer carries project context across sessions and across models. Switch from Claude to Codex mid-project without losing architectural understanding.
+
+## How It Works
+
+1. `gator gatorize .` installs a `.gator/` folder into your repo with governance scaffolding
+2. AI agents read the constitution and charters to understand your codebase
+3. Every `git commit` runs a deterministic hook that validates charter-alongside-code
+4. Session snippets capture what context produced each commit
+5. `gator dashboard` makes it all browsable in a local web UI
+
+## Links
+
+- [Source code](https://github.com/cumberland-laboratories/gator)
+- [MIT License](https://github.com/cumberland-laboratories/gator/blob/main/LICENSE)
+
+---
+
+Built by [Cumberland Laboratories](https://github.com/cumberland-laboratories)

{gator_command-1.1.0 → gator_command-1.1.2}/pyproject.toml

@@ -4,9 +4,9 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gator-command"
-version = "1.1.0"
+version = "1.1.2"
 description = "Git-native governance for AI-assisted engineering"
-readme = "README.md"
+readme = "PYPI_README.md"
 license = {text = "MIT"}
 requires-python = ">=3.9"
 authors = [

{gator_command-1.1.0 → gator_command-1.1.2}/src/gator_command/__init__.py

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

{gator_command-1.1.0 → gator_command-1.1.2}/src/gator_command/scripts/dashboard/dashboard.js

@@ -405,6 +405,13 @@
 
     state.standalone = !!(state.data && state.data.standalone);
 
+    // Hide Audit tab in standalone mode (no data model without command post)
+    if (state.standalone) {
+      document.querySelectorAll('.sidebar-item[data-view="audit"]').forEach(el => {
+        el.style.display = "none";
+      });
+    }
+
     // Check for ?repo= query param
     const params = new URLSearchParams(window.location.search);
     const preloadRepo = params.get("repo");

{gator_command-1.1.0 → gator_command-1.1.2}/src/gator_command/scripts/dashboard/views/fleet.js

@@ -126,7 +126,7 @@
     let html = `
       <div class="view-header">
         <span class="view-title">Fleet</span>
-        <span class="view-subtitle">${repos.length} registered</span>
+        <span class="view-subtitle">${repos.length} repo${repos.length !== 1 ? "s" : ""} registered (standalone)</span>
       </div>
 
       <div class="section">
@@ -134,7 +134,10 @@
           <thead>
             <tr>
               <th>Repo</th>
-              <th>Path</th>
+              <th>Branch</th>
+              <th>Charters</th>
+              <th>Hooks</th>
+              <th>Enforcement</th>
               <th>Status</th>
             </tr>
           </thead>
@@ -143,6 +146,14 @@
 
     for (const repo of repos) {
       const accIcon = repo.accessible ? "" : ' <span title="Not accessible" class="muted">!</span>';
+      const branch = repo.branch ? escHtml(repo.branch) : '<span class="muted">-</span>';
+      const charters = repo.charters != null ? repo.charters : '<span class="muted">-</span>';
+      const hooks = repo.hook_status === "ok" ? '<span style="color:var(--color-healthy)">ok</span>'
+        : repo.hook_status ? '<span style="color:var(--color-drifted)">' + escHtml(repo.hook_status) + '</span>'
+        : '<span class="muted">-</span>';
+      const enforcement = repo.config && repo.config.enforcement_level
+        ? escHtml(repo.config.enforcement_level)
+        : '<span class="muted">strict</span>';
       const statusCell = `<td class="status-cell"><button class="update-btn" data-repo="${escHtml(repo.name)}" ${repo.accessible ? "" : "disabled"}>Check Status</button><span class="status-result"></span></td>`;
 
       html += `
@@ -151,14 +162,21 @@
             <button class="link-btn" onclick="window.gatorNavToRepo('${escHtml(repo.name)}')">${escHtml(repo.name)}</button>
             ${accIcon}
           </td>
-          <td class="mono" style="font-size:12px;max-width:300px;overflow:hidden;text-overflow:ellipsis">${escHtml(repo.path || "-")}</td>
+          <td>${branch}</td>
+          <td>${charters}</td>
+          <td>${hooks}</td>
+          <td>${enforcement}</td>
           ${statusCell}
         </tr>
       `;
     }
 
     if (repos.length === 0) {
-      html += `<tr><td colspan="3" class="muted" style="text-align:center;padding:24px">No repos registered. Run gatorize.sh on a repo to get started.</td></tr>`;
+      html += `<tr><td colspan="6" class="muted" style="text-align:center;padding:24px">
+        No repos registered yet.<br><br>
+        <code style="font-size:12px;">gator gatorize /path/to/repo</code> — install governance + register<br>
+        <code style="font-size:12px;">gator dashboard --add-repo /path/to/repo</code> — register an existing gatorized repo
+      </td></tr>`;
     }
 
     html += `</tbody></table></div>`;

{gator_command-1.1.0 → gator_command-1.1.2}/src/gator_command/scripts/gator-dashboard.py

@@ -47,12 +47,20 @@ from gator_core import get_version, find_command_post, parse_registry  # noqa: E
 
 
 def _load_registry_repos():
-    """Load repo list from the fleet registry file. Works without command post."""
+    """Load repo list from fleet registry or machine-local dashboard registry."""
     cp = find_command_post()
     if cp:
         repos = parse_registry(cp)
         return repos
-    # No command post — try to find registry.md near this script
+    # No command post — try machine-local dashboard registry
+    try:
+        from gator_core import read_dashboard_registry
+        local_repos = read_dashboard_registry()
+        if local_repos:
+            return local_repos
+    except ImportError:
+        pass
+    # Legacy fallback: registry.md near this script
     registry_path = COMMAND_POST_ROOT / "gator-command" / "registry.md"
     if not registry_path.exists():
         return []
@@ -328,20 +336,36 @@ def collect_fast_data():
 
 
 def collect_standalone_data():
-    """Standalone startup: minimal payload from registry only. No fleet-report/drift/audit."""
+    """Standalone startup: per-repo governance data from gator-repo-status."""
     global _REGISTRY_REPOS
     repos = []
     for r in _REGISTRY_REPOS:
         repo_path = r.get("path", "")
         accessible = bool(repo_path and Path(repo_path).is_dir())
-        repos.append({
+        repo_data = {
             "name": r.get("name", ""),
             "path": repo_path,
             "remote": r.get("remote", ""),
-            "registered": r.get("registered", ""),
+            "registered": r.get("registered", r.get("added_at", "")),
             "status": r.get("status", "current"),
             "accessible": accessible,
-        })
+        }
+        if accessible:
+            # Enrich with repo-status (gator-repo-status-v1 schema)
+            status = run_json("gator-repo-status", "--path", repo_path, timeout=15)
+            if status and not status.get("error"):
+                repo_data.update({
+                    "branch": status.get("branch", ""),
+                    "charters": status.get("charter_count", 0),
+                    "charter_coverage_pct": status.get("charter_coverage_pct", 0),
+                    "hook_status": status.get("hook_status", "unknown"),
+                    "config": status.get("config", {}),
+                    "topology": status.get("topology", "standalone"),
+                    "last_governed_commit": status.get("last_governed_commit"),
+                    "session_summary_count": status.get("session_summary_count", 0),
+                    "override_events": status.get("override_events", []),
+                })
+        repos.append(repo_data)
     return {
         "standalone": True,
         "generated_at": datetime.now(tz=timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
@@ -1206,6 +1230,8 @@ def main():
         help="Write self-contained HTML to stdout and exit",
     )
     parser.add_argument("--repo", help="Pre-load Repo view for this repo name on open")
+    parser.add_argument("--add-repo", metavar="PATH", help="Register a repo in the local dashboard")
+    parser.add_argument("--remove-repo", metavar="NAME", help="Remove a repo from the local dashboard")
     args = parser.parse_args()
 
     if args.snapshot:
@@ -1213,6 +1239,25 @@ def main():
         sys.stdout.buffer.write(build_snapshot().encode("utf-8"))
         return
 
+    # Registry management (no server needed)
+    if args.add_repo:
+        from gator_core import add_dashboard_repo
+        repo_path = Path(args.add_repo).resolve()
+        if not repo_path.is_dir():
+            print(f"  Error: directory not found: {args.add_repo}", file=sys.stderr)
+            sys.exit(1)
+        add_dashboard_repo(repo_path)
+        print(f"  Added to dashboard: {repo_path.name} ({repo_path})")
+        return
+
+    if args.remove_repo:
+        from gator_core import remove_dashboard_repo
+        if remove_dashboard_repo(args.remove_repo):
+            print(f"  Removed from dashboard: {args.remove_repo}")
+        else:
+            print(f"  Not found in dashboard: {args.remove_repo}")
+        return
+
     global _HAS_COMMAND_POST, _REGISTRY_REPOS
 
     version = get_version() or "unknown"

{gator_command-1.1.0 → gator_command-1.1.2}/src/gator_command/scripts/gator_core.py

@@ -340,6 +340,74 @@ def parse_registry(command_post):
     return repos
 
 
+# ---------------------------------------------------------------------------
+# Machine-local dashboard registry
+# ---------------------------------------------------------------------------
+
+DASHBOARD_REGISTRY = Path.home() / ".gator" / "dashboard-repos.json"
+
+
+def read_dashboard_registry():
+    """Read the machine-local dashboard repo registry.
+
+    Returns list of repo dicts [{name, path, added_at, source}, ...].
+    Returns empty list if the file doesn't exist or is invalid.
+    """
+    if not DASHBOARD_REGISTRY.exists():
+        return []
+    try:
+        data = json.loads(DASHBOARD_REGISTRY.read_text(encoding="utf-8"))
+        return data.get("repos", [])
+    except (json.JSONDecodeError, OSError):
+        return []
+
+
+def write_dashboard_registry(repos):
+    """Write the machine-local dashboard repo registry."""
+    DASHBOARD_REGISTRY.parent.mkdir(parents=True, exist_ok=True)
+    data = {
+        "schema": "gator-dashboard-registry-v1",
+        "repos": repos,
+    }
+    DASHBOARD_REGISTRY.write_text(
+        json.dumps(data, indent=2, default=str) + "\n",
+        encoding="utf-8",
+    )
+
+
+def add_dashboard_repo(repo_path):
+    """Add a repo to the local dashboard registry. Idempotent by path."""
+    repo_path = Path(repo_path).resolve()
+    repos = read_dashboard_registry()
+
+    # Check if already registered (by resolved path)
+    path_str = str(repo_path)
+    for r in repos:
+        if str(Path(r["path"]).resolve()) == path_str:
+            return  # already registered
+
+    from datetime import datetime, timezone
+    repos.append({
+        "name": repo_path.name,
+        "path": path_str,
+        "added_at": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
+        "source": "gatorize",
+    })
+    write_dashboard_registry(repos)
+
+
+def remove_dashboard_repo(name_or_path):
+    """Remove a repo from the local dashboard registry by name or path."""
+    repos = read_dashboard_registry()
+    filtered = [r for r in repos
+                if r.get("name") != name_or_path
+                and str(Path(r.get("path", "")).resolve()) != str(Path(name_or_path).resolve())]
+    if len(filtered) < len(repos):
+        write_dashboard_registry(filtered)
+        return True
+    return False
+
+
 # ---------------------------------------------------------------------------
 # Git helpers
 # ---------------------------------------------------------------------------

{gator_command-1.1.0 → gator_command-1.1.2}/src/gator_command/scripts/gatorize.py

@@ -749,7 +749,15 @@ def action_install_product_source(target):
 
 
 def action_register(target):
-    """Add repo to registry.md."""
+    """Add repo to registries (command-post and local dashboard)."""
+    # Always register in machine-local dashboard registry
+    try:
+        from gator_core import add_dashboard_repo
+        add_dashboard_repo(target)
+    except Exception:
+        pass  # non-critical — dashboard registry is a convenience
+
+    # Command-post registry (only if command post exists)
     registry = COMMAND_POST / "gator-command" / "registry.md"
     repo_name = target.name
 

gator_command-1.1.2/src/gator_command.egg-info/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: gator-command
+Version: 1.1.2
+Summary: Git-native governance for AI-assisted engineering
+Author-email: Cumberland Laboratories <support@cumberlandlaboratories.com>
+License: MIT
+Project-URL: Homepage, https://github.com/cumberland-laboratories/gator
+Project-URL: Repository, https://github.com/cumberland-laboratories/gator
+Keywords: governance,ai,git,charters,audit,compliance
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Gator Command
+
+**Git-native governance for AI-assisted engineering.**
+
+Gator turns your repo into an intelligence surface. The AI agent builds structured maps of your codebase (charters), a strategic operations brief (pulse), and project assessments — all committed to Git. A deterministic pre-commit gate blocks commits when the agent changes code without updating the map.
+
+Local-first. Git-native. Works with Claude Code, Codex, Gemini CLI. MIT licensed.
+
+## Install
+
+```bash
+pip install pipx        # if you don't have pipx yet
+pipx ensurepath         # add to PATH (restart terminal after)
+
+pipx install gator-command
+```
+
+## Quick Start
+
+```bash
+cd /path/to/your/repo
+
+gator gatorize .        # install governance into this repo
+gator init              # start a governed session
+gator dashboard         # open the intelligence console
+```
+
+The agent reads the governance layer and orients to your project. Your first `git commit` fires the hooks.
+
+## Upgrade
+
+```bash
+pipx upgrade gator-command
+
+cd /path/to/your/repo
+gator gatorize .        # refresh templates and hooks
+```
+
+Your content is always preserved. Only templates and scripts refresh.
+
+## Commands
+
+| Command | What it does |
+|---------|-------------|
+| `gator gatorize <path>` | Install or upgrade governance in a repo |
+| `gator init` | Start a governed session (repairs hooks if needed) |
+| `gator dashboard` | Open the intelligence console |
+| `gator pulse` | Generate the strategic operations brief |
+| `gator audit` | Run governance audit |
+| `gator version` | Show installed version |
+
+## What Gator Provides
+
+- **Repo intelligence** — charters map code structure, pulse summarizes momentum, assessments provide AI-generated evaluation. All committed to Git.
+- **Governance enforcement** — a deterministic pre-commit hook that blocks commits when code changes without charter updates. No LLM in the gate. Configurable: strict, warn, or off.
+- **Dashboard** — a local web console for browsing your governance layer, session history, and project state. Full file history with git version navigation.
+- **Session persistence** — the governance layer carries project context across sessions and across models. Switch from Claude to Codex mid-project without losing architectural understanding.
+
+## How It Works
+
+1. `gator gatorize .` installs a `.gator/` folder into your repo with governance scaffolding
+2. AI agents read the constitution and charters to understand your codebase
+3. Every `git commit` runs a deterministic hook that validates charter-alongside-code
+4. Session snippets capture what context produced each commit
+5. `gator dashboard` makes it all browsable in a local web UI
+
+## Links
+
+- [Source code](https://github.com/cumberland-laboratories/gator)
+- [MIT License](https://github.com/cumberland-laboratories/gator/blob/main/LICENSE)
+
+---
+
+Built by [Cumberland Laboratories](https://github.com/cumberland-laboratories)

{gator_command-1.1.0 → gator_command-1.1.2}/src/gator_command.egg-info/SOURCES.txt

@@ -1,4 +1,5 @@
 LICENSE
+PYPI_README.md
 README.md
 pyproject.toml
 src/gator_command/__init__.py

{gator_command-1.1.0 → gator_command-1.1.2}/tests/test_packaging.py

@@ -33,7 +33,7 @@ class TestCLIDispatch:
             capture_output=True, text=True, timeout=10,
         )
         assert result.returncode == 0
-        assert "1.0.0" in result.stdout
+        assert "1." in result.stdout  # version starts with 1.x
 
     def test_scripts_dir_resolvable(self):
         """The CLI can find its scripts directory."""
@@ -162,7 +162,7 @@ class TestInstalledArtifact:
             capture_output=True, text=True, timeout=10,
         )
         assert result.returncode == 0
-        assert "1.0.0" in result.stdout
+        assert "1." in result.stdout  # version starts with 1.x
 
     def test_gator_help(self, installed_venv):
         """gator --help works via the real entry point."""