kolega-code 0.8.2__tar.gz → 0.8.4__tar.gz

kolega_code-0.8.4/.githooks/pre-commit

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+exec uv run pre-commit run --all-files --show-diff-on-failure

kolega_code-0.8.4/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,84 @@
+name: Bug report
+description: Report a reproducible problem with Kolega Code
+title: "bug: "
+labels: ["bug"]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What went wrong?
+      placeholder: "Kolega Code ..."
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: Kolega Code version
+      description: Run `kolega-code --version`.
+      placeholder: "kolega-code 0.8.3"
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: Operating system
+      placeholder: "macOS 15.5, Ubuntu 24.04, Fedora 42, etc."
+    validations:
+      required: true
+
+  - type: input
+    id: terminal
+    attributes:
+      label: Terminal
+      description: Include terminal app and shell if relevant.
+      placeholder: "Ghostty + zsh, Terminal.app + zsh, iTerm2 + fish, GNOME Terminal + bash"
+    validations:
+      required: true
+
+  - type: input
+    id: install-method
+    attributes:
+      label: Install method
+      placeholder: "install script, uv tool install, pipx, pip"
+    validations:
+      required: true
+
+  - type: textarea
+    id: repro
+    attributes:
+      label: Reproduction steps
+      description: Keep this as small and specific as possible.
+      placeholder: |
+        1. Run `kolega-code .`
+        2. ...
+        3. ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      placeholder: "I expected ..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+      placeholder: "Instead ..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs or screenshots
+      description: Paste relevant output. Please remove API keys, tokens, project-private code, and other secrets.
+      render: shell
+    validations:
+      required: false

kolega_code-0.8.4/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/kolega-ai/kolega-code/security/policy
+    about: Please report security issues privately.
+  - name: Documentation
+    url: https://kolega-ai.github.io/kolega-code/
+    about: Check the docs for setup, configuration, and usage guidance.

kolega_code-0.8.4/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,46 @@
+name: Feature request
+description: Suggest an improvement or new capability
+title: "feat: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What are you trying to do, and what makes it hard today?
+      placeholder: "I want to ..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: What would you like Kolega Code to do?
+      placeholder: "It would be useful if ..."
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: Operating system
+      placeholder: "macOS 15.5, Ubuntu 24.04, Fedora 42, etc."
+    validations:
+      required: false
+
+  - type: input
+    id: terminal
+    attributes:
+      label: Terminal
+      placeholder: "Ghostty + zsh, Terminal.app + zsh, iTerm2 + fish, GNOME Terminal + bash"
+    validations:
+      required: false
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Add examples, alternatives considered, screenshots, or links if useful.
+    validations:
+      required: false

kolega_code-0.8.4/.github/workflows/ci.yml

@@ -0,0 +1,131 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  tests:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Install dependencies
+        run: uv sync --extra dev --frozen
+
+      - name: Run pre-commit hooks
+        run: uv run pre-commit run --all-files --show-diff-on-failure
+
+      - name: Run fast tests with coverage
+        run: ./run_tests.sh --coverage
+
+      - name: Upload coverage report
+        uses: actions/upload-artifact@v6
+        with:
+          name: coverage-xml-python-${{ matrix.python-version }}
+          path: coverage.xml
+          if-no-files-found: error
+
+  coverage-badge:
+    name: Update coverage badge
+    needs: tests
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Install dependencies
+        run: uv sync --extra dev --frozen
+
+      - name: Download Python 3.11 coverage report
+        uses: actions/download-artifact@v6
+        with:
+          name: coverage-xml-python-3.11
+          path: coverage-artifact
+
+      - name: Generate coverage badge
+        run: |
+          uv run genbadge coverage -i coverage-artifact/coverage.xml -o docs/src/assets/coverage.svg
+          python - <<'PY'
+          from pathlib import Path
+
+          badge = Path("docs/src/assets/coverage.svg")
+          badge.write_text(badge.read_text().rstrip("\n") + "\n")
+          PY
+
+      - name: Commit coverage badge
+        run: |
+          if [ -z "$(git status --porcelain -- docs/src/assets/coverage.svg)" ]; then
+            echo "Coverage badge is already up to date."
+            exit 0
+          fi
+
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add docs/src/assets/coverage.svg
+          git commit -m "chore: update coverage badge [skip ci]"
+          git push
+
+  dependency-audit:
+    name: Dependency audit
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Audit locked dependencies
+        run: uv audit --locked

{kolega_code-0.8.2 → kolega_code-0.8.4}/.github/workflows/docs.yml

@@ -29,10 +29,10 @@ jobs:
         working-directory: docs
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Setup Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
           node-version: "22.12.0"
           cache: npm
@@ -46,9 +46,10 @@ jobs:
 
       - name: Upload Pages artifact
         if: github.event_name != 'pull_request'
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@v5
         with:
           path: docs/dist
+          include-hidden-files: true
 
   deploy:
     if: github.event_name != 'pull_request'
@@ -63,4 +64,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v5

kolega_code-0.8.4/.github/workflows/release.yml

@@ -0,0 +1,205 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build and test package
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      attestations: write
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Install dependencies
+        run: uv sync --extra dev --frozen
+
+      - name: Verify release version metadata
+        run: |
+          uv run python - <<'PY'
+          import ast
+          import os
+          import sys
+          import tomllib
+          from pathlib import Path
+
+          def module_version(path: str) -> str:
+              tree = ast.parse(Path(path).read_text(encoding="utf-8"), filename=path)
+              for node in tree.body:
+                  if isinstance(node, ast.Assign):
+                      for target in node.targets:
+                          if isinstance(target, ast.Name) and target.id == "__version__":
+                              if isinstance(node.value, ast.Constant) and isinstance(node.value.value, str):
+                                  return node.value.value
+              raise RuntimeError(f"Could not find string __version__ assignment in {path}")
+
+          tag = os.environ["GITHUB_REF_NAME"]
+          with open("pyproject.toml", "rb") as fh:
+              version = tomllib.load(fh)["project"]["version"]
+          expected_tag = f"v{version}"
+          if tag != expected_tag:
+              print(f"Release tag {tag!r} does not match pyproject.toml version {version!r}; expected {expected_tag!r}.")
+              sys.exit(1)
+
+          module_versions = {
+              "kolega_code/__init__.py": module_version("kolega_code/__init__.py"),
+              "kolega_code/agent/__init__.py": module_version("kolega_code/agent/__init__.py"),
+          }
+          mismatches = {path: value for path, value in module_versions.items() if value != version}
+          if mismatches:
+              print("Version metadata mismatch:")
+              print(f"  pyproject.toml: {version}")
+              for path, value in mismatches.items():
+                  print(f"  {path}: {value}")
+              sys.exit(1)
+          PY
+
+      - name: Run tests
+        run: uv run pytest -ra --durations=50 --import-mode=importlib -m "not slow"
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Check distributions
+        run: uv run twine check dist/*
+
+      - name: Prepare release asset directory
+        run: mkdir -p release-assets
+
+      - name: Generate SBOM
+        uses: anchore/sbom-action@v0
+        with:
+          path: .
+          format: spdx-json
+          output-file: release-assets/kolega-code-sbom.spdx.json
+          upload-artifact: false
+
+      - name: Attest release artifacts
+        uses: actions/attest-build-provenance@v3
+        with:
+          subject-path: "dist/*"
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v6
+        with:
+          name: python-distributions
+          path: dist/
+          if-no-files-found: error
+
+      - name: Upload SBOM
+        uses: actions/upload-artifact@v6
+        with:
+          name: release-sbom
+          path: release-assets/kolega-code-sbom.spdx.json
+          if-no-files-found: error
+
+  smoke:
+    name: Smoke-test artifacts on Python ${{ matrix.python-version }}
+    needs: build
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Download distributions
+        uses: actions/download-artifact@v7
+        with:
+          name: python-distributions
+          path: dist/
+
+      - name: Smoke-test wheel
+        run: |
+          python -m venv /tmp/kolega-code-wheel-smoke
+          /tmp/kolega-code-wheel-smoke/bin/python -m pip install --upgrade pip
+          /tmp/kolega-code-wheel-smoke/bin/python -m pip install dist/*.whl
+          /tmp/kolega-code-wheel-smoke/bin/kolega-code --version
+
+      - name: Smoke-test sdist
+        run: |
+          python -m venv /tmp/kolega-code-sdist-smoke
+          /tmp/kolega-code-sdist-smoke/bin/python -m pip install --upgrade pip
+          /tmp/kolega-code-sdist-smoke/bin/python -m pip install dist/*.tar.gz
+          /tmp/kolega-code-sdist-smoke/bin/kolega-code --version
+
+  publish:
+    name: Publish to PyPI
+    needs: [build, smoke]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/kolega-code
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v7
+        with:
+          name: python-distributions
+          path: dist/
+
+      - name: Publish distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+          skip-existing: false
+
+  github-release:
+    name: Create GitHub Release
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    env:
+      GH_TOKEN: ${{ github.token }}
+    steps:
+      - name: Create release
+        run: |
+          if gh release view "$GITHUB_REF_NAME" --repo "$GITHUB_REPOSITORY" >/dev/null 2>&1; then
+            echo "GitHub Release $GITHUB_REF_NAME already exists."
+            exit 0
+          fi
+
+          version="${GITHUB_REF_NAME#v}"
+          prelude=$(printf '%s\n\n%s\n\n%s\n%s\n%s\n\n%s\n' \
+            "PyPI: https://pypi.org/project/kolega-code/${version}/" \
+            "Update with:" \
+            '```bash' \
+            'uv tool install --force kolega-code' \
+            '```' \
+            "PyPI is the canonical package distribution. GitHub provides source archives for this release."
+          )
+
+          gh release create "$GITHUB_REF_NAME" \
+            --repo "$GITHUB_REPOSITORY" \
+            --verify-tag \
+            --title "$GITHUB_REF_NAME" \
+            --latest \
+            --generate-notes \
+            --notes "$prelude"

{kolega_code-0.8.2 → kolega_code-0.8.4}/.gitignore

@@ -11,3 +11,6 @@ __pycache__/
 dist/
 build/
 *.egg-info/
+.coverage
+coverage.xml
+htmlcov/

kolega_code-0.8.4/.pre-commit-config.yaml

@@ -0,0 +1,17 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.12
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+        args: [--markdown-linebreak-ext=md]
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: debug-statements
+      - id: detect-private-key

kolega_code-0.8.4/CHANGELOG.md

@@ -0,0 +1,77 @@
+# Changelog
+
+All notable changes to Kolega Code are documented here.
+
+This project uses GitHub Releases for detailed generated release notes. This file provides a concise, human-maintained summary of user-visible changes.
+
+## Unreleased
+
+## 0.8.4 - 2026-06-24
+
+### Added
+
+- Added minimal GitHub issue templates for bug reports and feature requests.
+- Added project links (homepage, documentation, changelog, security) to package metadata.
+- Added pre-commit configuration and a repository coverage badge.
+- Added Ruff lint/formatting checks and dependency vulnerability auditing to CI.
+- Added coverage reporting and SBOM/provenance attestation to the release workflow.
+
+### Changed
+
+- Hardened local state file permissions for settings, sessions, and project permission files.
+- Hardened the release workflow with lockfile-backed installs, version parity checks, and artifact smoke tests.
+- Split and reformatted oversized test modules to keep the suite maintainable.
+- Reduced the Logs and Terminal TUI scrollback caps to 2000 lines for better performance.
+- Updated GitHub Actions to Node 24-compatible versions.
+
+### Fixed
+
+- Fixed the chat composer to auto-grow as text wraps across multiple lines.
+- Fixed `ctrl-u` so it clears multiline composer drafts.
+- Fixed composer select-all shortcuts.
+- Fixed prompt-option focus handoff so focus returns from the composer correctly.
+- Fixed chat focus restoration after the app resumes or a turn is cancelled.
+- Fixed runtime output clearing when a planning thread is reset.
+- Optimized planning sidebar markdown rendering to reduce lag.
+
+## 0.8.3 - 2026-06-23
+
+### Fixed
+
+- Persisted TUI permission mode across sessions.
+- Updated the `idna` dependency to a patched version.
+
+### Changed
+
+- Externalized the TUI stylesheet.
+- Moved tests into the top-level `tests/` directory.
+
+## 0.8.2 - 2026-06-22
+
+### Added
+
+- Improved gigacode workflow transcript artifacts.
+- Documented branch and pull request naming guidance.
+- Documented the optional logs sidebar flag.
+
+### Fixed
+
+- Fixed long TUI approval prompt layout.
+- Fixed transcript jump-to-bottom locking.
+
+### Changed
+
+- Optimized sidebar terminal/log rendering and streaming render updates.
+- Moved TUI session persistence off the event loop.
+- Refactored the CLI TUI package layout and controller mixins.
+
+## 0.8.1 - 2026-06-21
+
+### Added
+
+- Added an optional agent iteration cap.
+
+### Changed
+
+- Migrated the API-key OpenAI provider to the Responses API.
+- Preserved OpenAI Responses reasoning continuity.

{kolega_code-0.8.2 → kolega_code-0.8.4}/CONTRIBUTING.md

@@ -4,12 +4,25 @@
 
 Kolega Code requires Python 3.11 or newer.
 
-Install the CLI and development dependencies with `uv`:
+Install the CLI, development dependencies, and the tracked Git hooks with the setup script:
+
+```bash
+./scripts/setup-dev.sh
+```
+
+If you prefer to run the steps manually:
 
 ```bash
 uv sync --extra cli --extra dev
+git config core.hooksPath .githooks
+uv run pre-commit install-hooks
+uv run pre-commit run --all-files --show-diff-on-failure
 ```
 
+Installing the `pre-commit` Python package is not enough. This repository uses a tracked
+`.githooks/pre-commit` wrapper that runs the exact same all-files command as CI. Run
+`./scripts/setup-dev.sh` or `git config core.hooksPath .githooks` once per clone.
+
 If you prefer `pip`, install the package in editable mode:
 
 ```bash
@@ -29,7 +42,34 @@ environment file only when you need those tests, and never commit real secrets:
 cp .env.example .env
 ```
 
-## Tests
+## Tests and quality checks
+
+Verify that Git is configured to use the tracked hooks:
+
+```bash
+./scripts/check-dev-hooks.sh
+```
+
+Local commits run the same all-files pre-commit command as CI when `core.hooksPath` points
+to `.githooks`:
+
+```bash
+uv run pre-commit run --all-files --show-diff-on-failure
+```
+
+CI runs Ruff through pre-commit. You can also run Ruff directly for one-off linting and
+formatting checks:
+
+```bash
+uv run ruff check .
+uv run ruff format --check .
+```
+
+To apply formatting locally:
+
+```bash
+uv run ruff format .
+```
 
 Run the fast test suite before opening a pull request:
 
@@ -46,7 +86,7 @@ Run slow and integration tests only when you have the required credentials:
 You can pass additional pytest arguments through the wrapper:
 
 ```bash
-./run_tests.sh kolega_code/agent/tests/llm/test_client.py -ra
+./run_tests.sh tests/agent/llm/test_client.py -ra
 ```
 
 ## Documentation