chimera-run 0.7.0__tar.gz

chimera_run-0.7.0/.github/workflows/ci.yml

@@ -0,0 +1,154 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+permissions:
+  contents: write
+  pages: write
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev --extra anthropic --extra openai
+
+      - name: Lint
+        run: uv run ruff check chimera/
+
+      - name: Type-check
+        run: uv run mypy chimera/
+
+      - name: Run tests (excluding live)
+        # WHY: ``-m "not live"`` skips the opt-in CHIMERA_MINK_LIVE / Ollama
+        # tests; those run only in .github/workflows/mink-live.yml on
+        # workflow_dispatch or PRs labelled ``live``.
+        run: uv run pytest tests/ --ignore=tests/benchmarks -m "not live" --tb=line -q
+
+  otter-trademark-scrub:
+    # WHY: enforce the otter trademark policy
+    # (docs/otter/trademark-policy.md).  Runs the same script developers
+    # run locally; fast, no-deps job that exits 1 on a branded mention in
+    # live otter source/docs.  Filesystem-fact paths like
+    # ``~/.opencode/config.json`` are allowed.
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Run otter trademark scrub
+        run: bash scripts/otter_trademark_scrub.sh
+
+  mink-trademark-scrub:
+    # WHY: enforce the mink trademark policy (HANDOFF Pitfall #5 in
+    # research/mink/HANDOFF.md).  Runs the same script developers run
+    # locally; fast, no-deps job that exits 1 on a branded mention in
+    # live mink source/docs.  Filesystem-fact paths like
+    # ``~/.claude/settings.json`` are allowed; ``docs/benchmarks/``,
+    # ``docs/plans/``, and ``docs/superpowers/`` are intentionally
+    # out-of-scope (factual integration history).
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Run mink trademark scrub
+        run: bash scripts/mink_trademark_scrub.sh
+
+  ferret-trademark-scrub:
+    # WHY: enforce the ferret trademark policy.  Runs the same script
+    # developers run locally; fast, no-deps job that exits 1 on a
+    # branded mention in live ferret source/docs.  Filesystem-fact paths
+    # like ``~/.codex/config.toml`` are allowed.
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Run ferret trademark scrub
+        run: bash scripts/ferret_trademark_scrub.sh
+
+  weasel-trademark-scrub:
+    # WHY: enforce the weasel trademark policy.  Runs the same script
+    # developers run locally; fast, no-deps job that exits 1 on a
+    # branded mention in live weasel source/docs.  Filesystem-fact paths
+    # like ``~/.weasel/config.json`` are allowed.
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Run weasel trademark scrub
+        run: bash scripts/weasel_trademark_scrub.sh
+
+  shrew-trademark-scrub:
+    # WHY: enforce the shrew trademark policy.  Runs the same script
+    # developers run locally; fast, no-deps job that exits 1 on a
+    # branded mention in live shrew source/docs.  Filesystem-fact paths
+    # like ``~/.shrew/config.json`` are allowed.
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Run shrew trademark scrub
+        run: bash scripts/shrew_trademark_scrub.sh
+
+  docs-sync-check:
+    # WHY: docs/otter/ and docs/mink/ are canonical Markdown sources;
+    # site/src/content/docs/otter/ and site/src/content/docs/mink/ are
+    # the Astro/Starlight mirror.  Without a check, the two trees drift
+    # silently (wave-1 W7 flagged this as Risk #4 in W7-REPORT.md).
+    # ``scripts/sync_docs.sh --check`` exits 1 if any mirrored file is
+    # out of sync with its canonical source; developers fix locally by
+    # running ``bash scripts/sync_docs.sh`` (no flag) and committing.
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Run docs sync check
+        run: bash scripts/sync_docs.sh --check
+
+  docs:
+    runs-on: ubuntu-latest
+    needs: test
+    if: github.ref == 'refs/heads/master'
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Setup Node
+        uses: actions/setup-node@v5
+        with:
+          node-version: 22
+
+      - name: Install pnpm
+        run: npm install -g pnpm
+
+      - name: Install docs dependencies
+        run: cd site && pnpm install
+
+      - name: Build docs
+        run: cd site && pnpm run build
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./site/dist

chimera_run-0.7.0/.github/workflows/mink-live.yml

@@ -0,0 +1,93 @@
+name: Mink Live
+
+# Opt-in lane that drives the walking-skeleton end-to-end against a real
+# Ollama daemon (small CPU model — cloud models need real auth).  Triggered
+# manually via workflow_dispatch or by labelling a PR ``live``; never runs
+# on every push.
+on:
+  workflow_dispatch:
+  pull_request:
+    types: [labeled, synchronize, reopened]
+
+jobs:
+  mink-live:
+    # Skip on label events that aren't the ``live`` label.
+    if: >-
+      github.event_name == 'workflow_dispatch' ||
+      contains(github.event.pull_request.labels.*.name, 'live')
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    env:
+      CHIMERA_MINK_LIVE: "1"
+      OLLAMA_HOST: "http://localhost:11434"
+      # WHY: kimi-k2.6:cloud requires Ollama Cloud credentials we don't
+      # surface in CI; the CPU-friendly llama3.2:3b proves the wiring.
+      CHIMERA_MINK_MODEL: "llama3.2:3b"
+      CHIMERA_MINK_LIVE_MODEL: "llama3.2:3b"
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --extra dev --extra anthropic
+
+      - name: Install Ollama
+        id: install_ollama
+        # WHY: the runner may be in a network/policy posture that blocks
+        # the upstream installer.  Don't fail the workflow — emit a
+        # WORKFLOW_DISABLED notice and skip the live test.
+        run: |
+          set +e
+          curl -fsSL https://ollama.ai/install.sh | sh
+          rc=$?
+          if [ "$rc" -ne 0 ]; then
+            echo "::notice title=WORKFLOW_DISABLED::Ollama installer failed (exit $rc); skipping live mink test."
+            echo "ollama_ok=0" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          echo "ollama_ok=1" >> "$GITHUB_OUTPUT"
+
+      - name: Start Ollama daemon
+        if: steps.install_ollama.outputs.ollama_ok == '1'
+        id: start_ollama
+        run: |
+          set +e
+          nohup ollama serve > /tmp/ollama.log 2>&1 &
+          # Wait up to 30s for /api/tags to respond.
+          for i in $(seq 1 30); do
+            if curl -fsS http://localhost:11434/api/tags > /dev/null 2>&1; then
+              echo "ollama_up=1" >> "$GITHUB_OUTPUT"
+              echo "ollama up after ${i}s"
+              exit 0
+            fi
+            sleep 1
+          done
+          echo "::notice title=WORKFLOW_DISABLED::Ollama daemon never answered /api/tags; skipping live mink test."
+          echo "ollama_up=0" >> "$GITHUB_OUTPUT"
+          exit 0
+
+      - name: Pull llama3.2:3b
+        if: steps.start_ollama.outputs.ollama_up == '1'
+        id: pull_model
+        run: |
+          set +e
+          ollama pull llama3.2:3b
+          rc=$?
+          if [ "$rc" -ne 0 ]; then
+            echo "::notice title=WORKFLOW_DISABLED::ollama pull llama3.2:3b failed (exit $rc); skipping live mink test."
+            echo "model_ok=0" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          echo "model_ok=1" >> "$GITHUB_OUTPUT"
+
+      - name: Run live walking-skeleton test
+        if: steps.pull_model.outputs.model_ok == '1'
+        run: |
+          uv run pytest \
+            tests/integration/test_mink_capabilities.py::test_11_walking_skeleton_live_or_skip \
+            -v --tb=short

chimera_run-0.7.0/.github/workflows/publish.yml

@@ -0,0 +1,94 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+
+      - name: Verify tag matches pyproject.toml version
+        id: version
+        run: |
+          TAG_REF="${GITHUB_REF#refs/tags/}"
+          TAG_VERSION="${TAG_REF#v}"
+          PROJECT_VERSION=$(uv run python -c "import tomllib, pathlib; print(tomllib.loads(pathlib.Path('pyproject.toml').read_text())['project']['version'])")
+          echo "Tag version:     $TAG_VERSION"
+          echo "Project version: $PROJECT_VERSION"
+          if [ "$TAG_VERSION" != "$PROJECT_VERSION" ]; then
+            echo "::error::Tag $TAG_REF does not match pyproject.toml version $PROJECT_VERSION"
+            exit 1
+          fi
+          echo "version=$TAG_VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      - name: List build artifacts
+        run: ls -la dist/
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+          if-no-files-found: error
+
+  publish-pypi:
+    name: Publish to PyPI (Trusted Publishing)
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: release
+      url: https://pypi.org/p/chimera-run
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    name: Attach artifacts to GitHub Release
+    needs: [build, publish-pypi]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Create or update GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: ${{ github.ref_name }}
+          generate_release_notes: true
+          files: |
+            dist/*.whl
+            dist/*.tar.gz

chimera_run-0.7.0/.gitignore

@@ -0,0 +1,27 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+venv/
+.env
+.worktrees/
+.claude/
+# Starlight docs build output + deps
+site/dist/
+site/node_modules/
+site/.astro/
+runs/
+.chimera/
+.chimera_checkpoints/
+data/
+# research/ — uncommitted internal handoff, see research/POLICY.md
+research/*
+!research/POLICY.md

chimera_run-0.7.0/.python-version

@@ -0,0 +1 @@
+3.12