council-gate 1.2.2__tar.gz

council_gate-1.2.2/.claude-plugin/marketplace.json

@@ -0,0 +1,16 @@
+{
+  "name": "council-gate",
+  "owner": {
+    "name": "AdishAssain",
+    "url": "https://github.com/AdishAssain"
+  },
+  "plugins": [
+    {
+      "name": "council-gate",
+      "source": ".",
+      "description": "Cross-model adversarial review for docs, proposals, and PR diffs.",
+      "version": "1.2.1",
+      "category": "review"
+    }
+  ]
+}

council_gate-1.2.2/.claude-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "council-gate",
+  "version": "1.2.1",
+  "description": "Cross-model adversarial review of docs, proposals, and PR diffs. Runs your artifact past frontier LLMs from different providers, measures disagreement, and routes consensus vs disagreement to an explicit escalation channel.",
+  "author": {
+    "name": "council-gate contributors",
+    "url": "https://github.com/AdishAssain/council-gate"
+  },
+  "homepage": "https://github.com/AdishAssain/council-gate",
+  "repository": "https://github.com/AdishAssain/council-gate",
+  "license": "MIT",
+  "keywords": ["review", "llm", "ensemble", "evaluation", "proposal", "pr-review"]
+}

council_gate-1.2.2/.dockerignore

@@ -0,0 +1,19 @@
+.git
+.github
+.venv
+venv
+__pycache__
+*.pyc
+.pytest_cache
+.ruff_cache
+.mypy_cache
+dist
+build
+*.egg-info
+notes
+tests
+CLAUDE.md
+.claude
+.env
+.env.*
+council-gate-*.md

council_gate-1.2.2/.github/workflows/docker.yml

@@ -0,0 +1,47 @@
+name: docker
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+    paths: [Dockerfile, .dockerignore, .github/workflows/docker.yml]
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: docker/setup-buildx-action@v3
+
+      - uses: docker/login-action@v3
+        if: github.event_name != 'pull_request'
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: docker/metadata-action@v5
+        id: meta
+        with:
+          images: ghcr.io/${{ github.repository_owner }}/council-gate
+          tags: |
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

council_gate-1.2.2/.github/workflows/release-test.yml

@@ -0,0 +1,65 @@
+# Dry-run publish to TestPyPI. Manually triggered from the Actions tab.
+# Use this BEFORE tagging v* to catch metadata / OIDC / wheel issues without
+# burning a real PyPI version number.
+#
+# ONE-TIME SETUP (mirrors release.yml, but on test.pypi.org):
+#   1. https://test.pypi.org/manage/account/publishing/ → Add pending publisher:
+#        Project name:    council-gate
+#        Owner:           AdishAssain
+#        Repository:      council-gate
+#        Workflow name:   release-test.yml
+#        Environment:     testpypi          ← matches `environment:` below
+#   2. GitHub → Settings → Environments → New environment named `testpypi`
+#
+# Then to dry-run: Actions tab → "release-test" → "Run workflow" (button).
+# Verify install:
+#   uv pip install --index-url https://test.pypi.org/simple/ \
+#                  --extra-index-url https://pypi.org/simple/ \
+#                  council-gate==<version>
+#
+# Note: TestPyPI also rejects re-uploads of the same version. If you need to
+# re-test, bump the dev suffix in pyproject.toml (e.g. 1.2.2 → 1.2.2.dev1)
+# before re-running. The .devN suffix doesn't affect the eventual real release.
+
+name: release-test
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Build sdist + wheel
+        run: uv build
+      - name: Verify metadata
+        run: uvx twine check dist/*
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-testpypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/council-gate
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/

council_gate-1.2.2/.github/workflows/release.yml

@@ -0,0 +1,79 @@
+# Publishes council-gate to PyPI on every v* tag, via PyPI Trusted Publishing
+# (OIDC — no API tokens stored in GitHub).
+#
+# ONE-TIME SETUP (Adish, you must do this on pypi.org BEFORE the first tag):
+#
+#   1. Go to https://pypi.org/manage/account/publishing/
+#   2. Click "Add a new pending publisher" (yes, even before the project exists)
+#   3. Fill in:
+#        Project name:    council-gate
+#        Owner:           AdishAssain
+#        Repository:      council-gate
+#        Workflow name:   release.yml
+#        Environment:     pypi          ← must match `environment:` below
+#   4. In this GitHub repo: Settings → Environments → New environment named `pypi`
+#      (no protection rules needed for personal repos; add reviewers if you want
+#       a manual approval gate before each publish).
+#
+# Then to release: bump version in pyproject.toml + CHANGELOG, commit, then:
+#   git tag v1.2.2 && git push origin v1.2.2
+# This workflow takes over from there.
+
+name: release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Build sdist + wheel
+        run: uv build
+      - name: Verify metadata
+        run: uvx twine check dist/*
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/council-gate
+    permissions:
+      id-token: write   # required for PyPI Trusted Publishing OIDC
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    needs: publish-pypi
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true
+          body_path: CHANGELOG.md

council_gate-1.2.2/.github/workflows/test.yml

@@ -0,0 +1,40 @@
+name: tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Sync deps
+        run: uv sync --extra dev
+
+      - name: Lint
+        run: uv run ruff check .
+
+      - name: Type-check
+        run: uv run mypy src/ || true   # informational until strict-typed
+
+      - name: Test
+        run: uv run pytest -v
+
+      - name: Build wheel
+        run: uv build
+
+      - name: Sanity-check installed CLI resolves
+        run: |
+          uv pip install dist/*.whl
+          uv run council-gate --help

council_gate-1.2.2/.gitignore

@@ -0,0 +1,26 @@
+.env
+.env.*
+!.env.example
+
+.venv/
+venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+
+dist/
+build/
+
+.DS_Store
+.idea/
+.vscode/
+
+notes/
+dist/
+
+CLAUDE.md
+.claude/
+.smoke-venv/

council_gate-1.2.2/.pre-commit-config.yaml

@@ -0,0 +1,21 @@
+# Run on every commit. Install once: `uv run pre-commit install`
+# (pre-commit is in the dev extras: `uv sync --extra dev` already pulls it.)
+#
+# Mirrors what CI runs. Catching failures here prevents red-X commits.
+
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: local
+    hooks:
+      - id: pytest
+        name: pytest
+        entry: uv run pytest -q
+        language: system
+        pass_filenames: false
+        stages: [pre-commit]

council_gate-1.2.2/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+## Stability
+
+> **`council-gate` is pre-stable.** While the major version is `1.x` for ergonomics (the tool is functionally complete and shipping real reviews), the API surface — CLI flags, env var names, and report format — is **not frozen** until `2.0`. Minor versions may break things. Pin a version in CI / scripts.
+>
+> Until 2.0, treat version bumps as 0Ver-style: any release can change behaviour. Read the entry below before upgrading.
+
+## 1.2.2 — 2026-05-06
+
+PyPI-readiness housekeeping. No user-visible behavior change.
+
+- `pyproject.toml`: added `[project.authors]`, fixed `Operating System :: POSIX` → `OS Independent` (we ship Windows + Docker), added `Documentation` and `Changelog` to `[project.urls]`, added `Programming Language :: Python :: 3.13` classifier, bumped `Development Status :: 3 - Alpha` → `4 - Beta`.
+- `.github/workflows/release.yml`: PyPI publishing on `v*` tag via Trusted Publishing (OIDC, no API tokens). Also attaches wheels to a GitHub Release.
+- Verified: `uv build` produces clean sdist + wheel, `twine check` passes, wheel installs in a fresh venv with the entrypoint resolving.
+
+## 1.2.1 — 2026-05-06
+
+- One-line installer for macOS/Linux/WSL (`install.sh`) and Windows (`install.ps1`). Both auto-install `uv`, install `council-gate`, and update your shell PATH so the binary works in fresh terminals — fixes the "command not found after restart" friction.
+- Docker image published to `ghcr.io/adishassain/council-gate:latest` (and per-version tags). Hermetic, no Python required on host, ideal for CI.
+- `council-gate update` now also runs `uv tool update-shell` so existing users get the PATH fix on next upgrade.
+
+## 1.2.0 — 2026-05-06
+
+- Multi-format ingestion: `.docx`, `.pdf`, `.pptx`, `.xlsx`, `.odt`, `.rtf`, `.epub` are now first-class inputs alongside `.md`/`.diff`/source code. Office formats are converted via [MarkItDown](https://github.com/microsoft/markitdown) before review.
+- Smart `--mode` default: `.docx`/`.pdf`/`.odt` artifacts default to `proposal` review; everything else stays on `eng`. Override with `--mode` as before.
+- Friendly errors throughout: file-load failures, missing dependencies, and unexpected crashes now print plain-English messages instead of Python tracebacks. `--verbose` re-enables full tracebacks.
+- More resilient PATH setup: `council-gate init` now writes to both `.zshrc`+`.zprofile` (zsh) and `.bashrc`+`.bash_profile` (bash), so the binary survives a terminal restart on macOS where Terminal.app launches login shells.
+- `council-gate doctor` now reports the resolved `council-gate` binary path.
+- Helpful messages for unsupported Apple iWork formats (`.pages`, `.numbers`, `.keynote`, `.gdoc`) telling the user how to export.
+
+## 1.1.0
+
+- README review-modes table; version bump.
+
+## 1.0.0
+
+- Initial public release.

council_gate-1.2.2/Dockerfile

@@ -0,0 +1,25 @@
+# Hermetic council-gate image. ~150MB, no venv state, runs as non-root.
+# Usage:
+#   docker run --rm -v "$PWD:/work" -w /work \
+#       -e OPENROUTER_API_KEY=sk-or-... \
+#       ghcr.io/adishassain/council-gate review proposal.docx
+
+FROM python:3.12-slim
+
+# uv for the install — same toolchain as the host installer
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /usr/local/bin/
+
+WORKDIR /opt/council-gate
+COPY pyproject.toml README.md LICENSE ./
+COPY src ./src
+
+# System install (no venv) so the entrypoint resolves without activation
+RUN uv pip install --system --no-cache .
+
+# Non-root user — review jobs must not run as root inside the container
+RUN useradd --create-home --shell /bin/bash council
+USER council
+WORKDIR /work
+
+ENTRYPOINT ["council-gate"]
+CMD ["--help"]

council_gate-1.2.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 council-gate contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.