gator-command 1.1.1__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.1 → gator_command-1.1.2}/pyproject.toml

@@ -4,9 +4,9 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gator-command"
-version = "1.1.1"
+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.1 → 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.1"
+__version__ = "1.1.2"

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.1 → 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.1/PKG-INFO

@@ -1,122 +0,0 @@
-Metadata-Version: 2.4
-Name: gator-command
-Version: 1.1.1
-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
-
-The command post for [Gator](https://github.com/cumberland-laboratories/gator) — AI-assisted engineering governance.
-
-## How to Use This Repo
-
-**Open it in an AI coding assistant.** Claude Code, Codex, Gemini CLI, Cursor — whichever you use. The agent reads the constitution and acts as your concierge: it knows the architecture, the configuration options, the procedures, and the fleet state. Ask it what you need.
-
-Gator is designed to be operated *with* an AI agent, not studied as documentation. The governance layer is markdown that agents read natively. The concierge layer routes your questions to the right procedures and reference material. The agent is the interface.
-
-```
-You: "gator init"
-You: "Gatorize my project at ~/code/my-app"
-You: "Set up an enforcer using GPT as the reviewer"
-You: "Check if the charters still match the code"
-You: "What's the status of the fleet?"
-```
-
-## What Gator Does
-
-Gator governs AI-assisted coding. It keeps human comprehension synchronized with AI-generated code through constitutions, module charters, deterministic commit gates, and cross-model enforcement.
-
-### Use Cases
-
-**Solo developer with one repo** — You want the AI agent to maintain a map of your codebase (charters), enforce that the map stays current (commit gate), and preserve session context across conversations (knowledge layer). Install Gator, bootstrap charters, and the loop runs from there.
-
-**Solo developer with multiple repos** — Same as above, plus: this command post becomes your cross-repo control plane. One org policy propagated to every repo. Fleet status, drift detection, and audit dashboards from one place.
-
-**Team with shared repos** — Gator's knowledge layer travels with the repo via git. When a teammate (human or AI) opens the repo, they get the full architectural context — mission, charters, threads, decisions. The enforcer provides independent review from a different model than the one writing code.
-
-**Compliance and audit** — Every commit carries `Gator-*` trailers (change type, significance, charter status, agent identity). Session summaries provide durable evidence of what was decided and who was supervising. Fleet-wide audit reports aggregate governance health across repos.
-
-### Configurations
-
-Gator is model-neutral and modular. The PI chooses the configuration that fits their stack:
-
-| Decision | Options |
-|----------|---------|
-| **Primary agent** | Claude Code, Codex CLI, Gemini CLI, Cursor, any markdown-aware AI tool |
-| **Enforcer model** | Anthropic Sonnet, OpenAI GPT, Google Gemini, local via Ollama, or none |
-| **Review cadence** | Light (lint only), Standard (lint + model review on significant changes), Rigorous (pre-code + post-code review) |
-| **Fleet scope** | Single repo (no command post needed), multi-repo (this command post), remote repos (bare cache scanning) |
-| **Session archaeology** | Off, local spool, committed summaries (git-tracked audit trail) |
-
-The concierge agent walks you through these choices. You don't need to read configuration docs — tell the agent what you want and it configures the system.
-
-## Quick Start
-
-```bash
-# Gatorize an existing project repo
-bash gator-command/scripts/gatorize.sh /path/to/your/project
-
-# Then open that project in your AI assistant — the concierge bootstrap begins
-```
-
-For fleet operations (from within this command post):
-```bash
-# Fleet status
-python gator-command/scripts/gator-fleet-report.py
-
-# Policy drift across all governed repos
-python gator-command/scripts/gator-drift.py
-
-# Audit dashboard
-python gator-command/scripts/gator-audit.py
-```
-
-## Architecture at a Glance
-
-```
-This repo (command post):
-  constitution.md          Governance rules for this command post
-  gator-command/           Knowledge graph + machinery + fleet tooling
-    scripts/               CLI tooling (gatorize, fleet-report, drift, audit)
-    templates/             Starter kit deployed to project repos
-    procedures/            Standards and workflows
-    reference-notes/       Concierge knowledge (the agent reads these)
-
-Each governed repo:
-  .gator/
-    constitution.md        Per-repo governance rules
-    charters/              Module maps (the intelligent codebase layer)
-    scripts/               Hooks + enforcer
-    field-guides/          Language pattern references (optional)
-    command-post.md        Thin link back to this command post
-```
-
-## Multi-Model Architecture
-
-The constitutions are the interface contract. Any model that reads markdown and follows instructions can operate the system.
-
-- **Primary agent**: Reads charters, writes code, updates the knowledge layer
-- **Enforcer**: Different model, read-only, audits the agent's work against charters
-- **The architecture outlives any individual model** — switch tools mid-project without losing context
-
-## License
-
-MIT — [Cumberland Laboratories](https://github.com/cumberland-laboratories)

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

@@ -1,122 +0,0 @@
-Metadata-Version: 2.4
-Name: gator-command
-Version: 1.1.1
-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
-
-The command post for [Gator](https://github.com/cumberland-laboratories/gator) — AI-assisted engineering governance.
-
-## How to Use This Repo
-
-**Open it in an AI coding assistant.** Claude Code, Codex, Gemini CLI, Cursor — whichever you use. The agent reads the constitution and acts as your concierge: it knows the architecture, the configuration options, the procedures, and the fleet state. Ask it what you need.
-
-Gator is designed to be operated *with* an AI agent, not studied as documentation. The governance layer is markdown that agents read natively. The concierge layer routes your questions to the right procedures and reference material. The agent is the interface.
-
-```
-You: "gator init"
-You: "Gatorize my project at ~/code/my-app"
-You: "Set up an enforcer using GPT as the reviewer"
-You: "Check if the charters still match the code"
-You: "What's the status of the fleet?"
-```
-
-## What Gator Does
-
-Gator governs AI-assisted coding. It keeps human comprehension synchronized with AI-generated code through constitutions, module charters, deterministic commit gates, and cross-model enforcement.
-
-### Use Cases
-
-**Solo developer with one repo** — You want the AI agent to maintain a map of your codebase (charters), enforce that the map stays current (commit gate), and preserve session context across conversations (knowledge layer). Install Gator, bootstrap charters, and the loop runs from there.
-
-**Solo developer with multiple repos** — Same as above, plus: this command post becomes your cross-repo control plane. One org policy propagated to every repo. Fleet status, drift detection, and audit dashboards from one place.
-
-**Team with shared repos** — Gator's knowledge layer travels with the repo via git. When a teammate (human or AI) opens the repo, they get the full architectural context — mission, charters, threads, decisions. The enforcer provides independent review from a different model than the one writing code.
-
-**Compliance and audit** — Every commit carries `Gator-*` trailers (change type, significance, charter status, agent identity). Session summaries provide durable evidence of what was decided and who was supervising. Fleet-wide audit reports aggregate governance health across repos.
-
-### Configurations
-
-Gator is model-neutral and modular. The PI chooses the configuration that fits their stack:
-
-| Decision | Options |
-|----------|---------|
-| **Primary agent** | Claude Code, Codex CLI, Gemini CLI, Cursor, any markdown-aware AI tool |
-| **Enforcer model** | Anthropic Sonnet, OpenAI GPT, Google Gemini, local via Ollama, or none |
-| **Review cadence** | Light (lint only), Standard (lint + model review on significant changes), Rigorous (pre-code + post-code review) |
-| **Fleet scope** | Single repo (no command post needed), multi-repo (this command post), remote repos (bare cache scanning) |
-| **Session archaeology** | Off, local spool, committed summaries (git-tracked audit trail) |
-
-The concierge agent walks you through these choices. You don't need to read configuration docs — tell the agent what you want and it configures the system.
-
-## Quick Start
-
-```bash
-# Gatorize an existing project repo
-bash gator-command/scripts/gatorize.sh /path/to/your/project
-
-# Then open that project in your AI assistant — the concierge bootstrap begins
-```
-
-For fleet operations (from within this command post):
-```bash
-# Fleet status
-python gator-command/scripts/gator-fleet-report.py
-
-# Policy drift across all governed repos
-python gator-command/scripts/gator-drift.py
-
-# Audit dashboard
-python gator-command/scripts/gator-audit.py
-```
-
-## Architecture at a Glance
-
-```
-This repo (command post):
-  constitution.md          Governance rules for this command post
-  gator-command/           Knowledge graph + machinery + fleet tooling
-    scripts/               CLI tooling (gatorize, fleet-report, drift, audit)
-    templates/             Starter kit deployed to project repos
-    procedures/            Standards and workflows
-    reference-notes/       Concierge knowledge (the agent reads these)
-
-Each governed repo:
-  .gator/
-    constitution.md        Per-repo governance rules
-    charters/              Module maps (the intelligent codebase layer)
-    scripts/               Hooks + enforcer
-    field-guides/          Language pattern references (optional)
-    command-post.md        Thin link back to this command post
-```
-
-## Multi-Model Architecture
-
-The constitutions are the interface contract. Any model that reads markdown and follows instructions can operate the system.
-
-- **Primary agent**: Reads charters, writes code, updates the knowledge layer
-- **Enforcer**: Different model, read-only, audits the agent's work against charters
-- **The architecture outlives any individual model** — switch tools mid-project without losing context
-
-## License
-
-MIT — [Cumberland Laboratories](https://github.com/cumberland-laboratories)