codeyak 0.0.1__tar.gz

codeyak-0.0.1/.env.example

@@ -0,0 +1,14 @@
+# GitLab Configuration
+GITLAB_URL=https://gitlab.com
+GITLAB_TOKEN=
+
+# Azure OpenAI Configuration
+AZURE_OPENAI_API_KEY=
+AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com
+AZURE_OPENAI_API_VERSION=2024-02-15-preview
+AZURE_DEPLOYMENT_NAME=gpt-4o
+
+# Observability (Langfuse)
+LANGFUSE_SECRET_KEY=
+LANGFUSE_PUBLIC_KEY=
+LANGFUSE_HOST=https://cloud.langfuse.com

codeyak-0.0.1/.github/workflows/publish.yml

@@ -0,0 +1,26 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish

codeyak-0.0.1/.gitignore

@@ -0,0 +1,20 @@
+# Python
+__pycache__/
+*.pyc
+*.egg-info/
+
+# Environment
+.env
+.venv/
+
+# Testing & Coverage
+.coverage
+.coverage.*
+htmlcov/
+.pytest_cache/
+*.cover
+
+# Tools
+.idea/
+
+CODE_REVIEW.md

codeyak-0.0.1/.vscode/settings.json

@@ -0,0 +1,13 @@
+{
+  "python.testing.pytestEnabled": true,
+  "python.testing.unittestEnabled": false,
+  "python.testing.pytestArgs": [
+    "tests"
+  ],
+  "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
+  "python.testing.pytestPath": "uv",
+  "python.testing.pytestExtraArgs": [
+    "run",
+    "pytest"
+  ]
+}

codeyak-0.0.1/.vscode/tasks.json

@@ -0,0 +1,67 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Run All Tests",
+      "type": "shell",
+      "command": "uv run pytest",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "group": "test",
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated",
+        "focus": true
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "Run Tests with Coverage",
+      "type": "shell",
+      "command": "uv run pytest --cov=src/codeyak --cov-report=term-missing",
+      "group": "test",
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated"
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "Run Current File Tests",
+      "type": "shell",
+      "command": "uv run pytest ${file}",
+      "group": "test",
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated"
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "Run Tests (Verbose)",
+      "type": "shell",
+      "command": "uv run pytest -v",
+      "group": "test",
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated"
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "Run Tests (Fast Fail)",
+      "type": "shell",
+      "command": "uv run pytest -x",
+      "group": {
+        "kind": "test",
+        "isDefault": true
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated"
+      },
+      "problemMatcher": []
+    }
+  ]
+}

codeyak-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ray Martinez
+
+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.

codeyak-0.0.1/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.4
+Name: codeyak
+Version: 0.0.1
+Summary: A code review agent optimized for following strict guidelines
+Project-URL: Homepage, https://github.com/ai-rayven/codeyak
+Project-URL: Repository, https://github.com/ai-rayven/codeyak
+Project-URL: Bug Tracker, https://github.com/ai-rayven/codeyak/issues
+Author-email: Ray Martinez <raiselmartinez@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,automation,azure-openai,code-review,gitlab,linting,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.12
+Requires-Dist: click>=8.1.0
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: instructor>=1.14.1
+Requires-Dist: langfuse>=3.11.2
+Requires-Dist: openai>=2.15.0
+Requires-Dist: pydantic-settings>=2.12.0
+Requires-Dist: python-gitlab>=7.1.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: tomli-w>=1.0.0
+Provides-Extra: test
+Requires-Dist: pytest-cov>=6.0.0; extra == 'test'
+Requires-Dist: pytest-mock>=3.14.0; extra == 'test'
+Requires-Dist: pytest>=8.0.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# CodeYak 🐻 - Guard your codebase
+
+<p align="center">
+  <img src="images/codeyak-logo-circle.png" alt="CodeYak Logo" width="200"/>
+</p>
+
+![Python Version](https://img.shields.io/badge/python-3.12%2B-blue)
+![Platform](https://img.shields.io/badge/platform-GitLab-orange)
+![LLM](https://img.shields.io/badge/LLM-Azure%20OpenAI-green)
+
+
+**Built Strong:**
+- 🎯 **Territorial guidelines system** - Defend your code standards with built-in presets (security, style, balanced)
+- 🔍 **Multi-pass hunting** - Thorough, focused reviews that don't miss a thing
+- 🧠 **Smart deduplication** - Never repeats itself
+
+**Current Territory:** GitLab + Azure OpenAI (Expanding to GitHub, OpenAI, Anthropic)
+
+## Quick Start
+
+1. Configure CI/CD variables in GitLab (Settings → CI/CD → Variables):
+   - `GITLAB_TOKEN`, `AZURE_OPENAI_API_KEY`, `AZURE_OPENAI_ENDPOINT`, `AZURE_DEPLOYMENT_NAME`, `AGENT_REPO_URL`
+
+2. Add to `.gitlab-ci.yml`:
+   ```yaml
+   codeyak:
+     stage: review
+     image: python:3.12-slim
+     before_script:
+       - apt-get update && apt-get install -y git && pip install uv
+     script:
+       - git clone $AGENT_REPO_URL agent_code && cd agent_code
+       - uv sync --frozen
+       - uv run python -m codeyak $CI_MERGE_REQUEST_IID $CI_PROJECT_ID
+     rules:
+       - if: $CI_PIPELINE_SOURCE == 'merge_request_event'
+   ```
+
+3. **Watch it work** - Open a merge request and CodeYak automatically hunts for issues
+
+## Guidelines System
+
+Command CodeYak's behavior with YAML guideline files. The bear follows:
+- **Your project guidelines** (`.codeyak/*.yaml`) when marking territory
+- **Built-in `default` preset** when roaming free
+
+Each YAML file triggers a separate focused hunting pass.
+
+### Battle-Tested Presets
+
+**`default`** - Full-strength protection (32 guidelines)
+- Combines: `security` + `readability` + `maintainability`
+- Comprehensive coverage of code quality
+
+**`security`** - Fortress mode (15 guidelines)
+- Secrets management, injection prevention (SQL, XSS, command)
+- Authentication, authorization, session management
+- Strong cryptography, password hashing
+- Data encryption, safe error handling
+
+**`readability`** - Crystal clear code (7 guidelines)
+- Function length and clarity
+- Descriptive and intentional naming
+- Self-documenting code, meaningful comments
+
+**`maintainability`** - Built to last (10 guidelines)
+- Single Responsibility, low complexity
+- Logical organization, code proximity
+- DRY principle, no dead code
+- Proper exception handling
+
+### Custom Guidelines
+
+Train CodeYak with your own rules in `.codeyak/my-rules.yaml`:
+
+```yaml
+guidelines:
+  - label: rate-limiting
+    description: All API endpoints must include rate limiting.
+
+  - label: n-plus-one
+    description: Avoid N+1 queries by using eager loading.
+```
+
+Guidelines are automatically tagged based on filename and label:
+- File: `my-rules.yaml` → Prefix: `my-rules`
+- Label: `rate-limiting` → ID: `my-rules/rate-limiting`
+
+**ID format:** `prefix/label` (e.g., `security/sql-injection`, `custom/rate-limiting`)
+**Label requirements:** lowercase, alphanumeric, hyphens only
+
+### Combining Forces
+
+Stack built-in presets with your custom rules:
+
+```yaml
+includes:
+  - builtin:security
+  - builtin:readability
+
+guidelines:
+  - label: api-timeout
+    description: All external API calls must have timeout limits.
+```
+
+**Available reinforcements:** `builtin:default`, `builtin:security`, `builtin:readability`, `builtin:maintainability`
+
+### Multi-Pass Reviews
+
+```
+.codeyak/
+├── 01-security.yaml      # Security sweep
+├── 02-style.yaml         # Style enforcement
+└── 03-project-rules.yaml # Your custom rules
+```
+
+Each file can include built-in presets or define custom guidelines. CodeYak never misses.
+
+## Environment Variables
+
+**Required:**
+```bash
+GITLAB_URL=https://gitlab.com
+GITLAB_TOKEN=<your-token>
+AZURE_OPENAI_API_KEY=<your-key>
+AZURE_OPENAI_ENDPOINT=<your-endpoint>
+AZURE_OPENAI_API_VERSION=2024-02-15-preview
+AZURE_DEPLOYMENT_NAME=gpt-4o
+```
+
+**Optional:**
+```bash
+LANGFUSE_SECRET_KEY=<key>    # For observability
+LANGFUSE_PUBLIC_KEY=<key>
+LANGFUSE_HOST=https://cloud.langfuse.com
+```
+
+## Local Development
+
+```bash
+# Get the bear
+git clone <repo-url> && cd codeyak
+cp .env.example .env  # Fill in credentials
+uv sync
+
+# Release it on a merge request
+uv run python -m codeyak <MR_IID> <PROJECT_ID>
+
+# Test with custom guidelines
+mkdir -p .codeyak
+echo "includes:
+  - builtin:security" > .codeyak/security.yaml
+uv run python -m codeyak <MR_IID> <PROJECT_ID>
+```
+
+## How It Works
+
+1. Fetches MR diff and existing review comments
+2. Runs review pass(es) based on active guidelines
+4. Posts only new, unique findings as inline comments
+
+---
+
+**Built with fierce determination** 🐻 **using Python and AI**

codeyak-0.0.1/README.md

@@ -0,0 +1,164 @@
+# CodeYak 🐻 - Guard your codebase
+
+<p align="center">
+  <img src="images/codeyak-logo-circle.png" alt="CodeYak Logo" width="200"/>
+</p>
+
+![Python Version](https://img.shields.io/badge/python-3.12%2B-blue)
+![Platform](https://img.shields.io/badge/platform-GitLab-orange)
+![LLM](https://img.shields.io/badge/LLM-Azure%20OpenAI-green)
+
+
+**Built Strong:**
+- 🎯 **Territorial guidelines system** - Defend your code standards with built-in presets (security, style, balanced)
+- 🔍 **Multi-pass hunting** - Thorough, focused reviews that don't miss a thing
+- 🧠 **Smart deduplication** - Never repeats itself
+
+**Current Territory:** GitLab + Azure OpenAI (Expanding to GitHub, OpenAI, Anthropic)
+
+## Quick Start
+
+1. Configure CI/CD variables in GitLab (Settings → CI/CD → Variables):
+   - `GITLAB_TOKEN`, `AZURE_OPENAI_API_KEY`, `AZURE_OPENAI_ENDPOINT`, `AZURE_DEPLOYMENT_NAME`, `AGENT_REPO_URL`
+
+2. Add to `.gitlab-ci.yml`:
+   ```yaml
+   codeyak:
+     stage: review
+     image: python:3.12-slim
+     before_script:
+       - apt-get update && apt-get install -y git && pip install uv
+     script:
+       - git clone $AGENT_REPO_URL agent_code && cd agent_code
+       - uv sync --frozen
+       - uv run python -m codeyak $CI_MERGE_REQUEST_IID $CI_PROJECT_ID
+     rules:
+       - if: $CI_PIPELINE_SOURCE == 'merge_request_event'
+   ```
+
+3. **Watch it work** - Open a merge request and CodeYak automatically hunts for issues
+
+## Guidelines System
+
+Command CodeYak's behavior with YAML guideline files. The bear follows:
+- **Your project guidelines** (`.codeyak/*.yaml`) when marking territory
+- **Built-in `default` preset** when roaming free
+
+Each YAML file triggers a separate focused hunting pass.
+
+### Battle-Tested Presets
+
+**`default`** - Full-strength protection (32 guidelines)
+- Combines: `security` + `readability` + `maintainability`
+- Comprehensive coverage of code quality
+
+**`security`** - Fortress mode (15 guidelines)
+- Secrets management, injection prevention (SQL, XSS, command)
+- Authentication, authorization, session management
+- Strong cryptography, password hashing
+- Data encryption, safe error handling
+
+**`readability`** - Crystal clear code (7 guidelines)
+- Function length and clarity
+- Descriptive and intentional naming
+- Self-documenting code, meaningful comments
+
+**`maintainability`** - Built to last (10 guidelines)
+- Single Responsibility, low complexity
+- Logical organization, code proximity
+- DRY principle, no dead code
+- Proper exception handling
+
+### Custom Guidelines
+
+Train CodeYak with your own rules in `.codeyak/my-rules.yaml`:
+
+```yaml
+guidelines:
+  - label: rate-limiting
+    description: All API endpoints must include rate limiting.
+
+  - label: n-plus-one
+    description: Avoid N+1 queries by using eager loading.
+```
+
+Guidelines are automatically tagged based on filename and label:
+- File: `my-rules.yaml` → Prefix: `my-rules`
+- Label: `rate-limiting` → ID: `my-rules/rate-limiting`
+
+**ID format:** `prefix/label` (e.g., `security/sql-injection`, `custom/rate-limiting`)
+**Label requirements:** lowercase, alphanumeric, hyphens only
+
+### Combining Forces
+
+Stack built-in presets with your custom rules:
+
+```yaml
+includes:
+  - builtin:security
+  - builtin:readability
+
+guidelines:
+  - label: api-timeout
+    description: All external API calls must have timeout limits.
+```
+
+**Available reinforcements:** `builtin:default`, `builtin:security`, `builtin:readability`, `builtin:maintainability`
+
+### Multi-Pass Reviews
+
+```
+.codeyak/
+├── 01-security.yaml      # Security sweep
+├── 02-style.yaml         # Style enforcement
+└── 03-project-rules.yaml # Your custom rules
+```
+
+Each file can include built-in presets or define custom guidelines. CodeYak never misses.
+
+## Environment Variables
+
+**Required:**
+```bash
+GITLAB_URL=https://gitlab.com
+GITLAB_TOKEN=<your-token>
+AZURE_OPENAI_API_KEY=<your-key>
+AZURE_OPENAI_ENDPOINT=<your-endpoint>
+AZURE_OPENAI_API_VERSION=2024-02-15-preview
+AZURE_DEPLOYMENT_NAME=gpt-4o
+```
+
+**Optional:**
+```bash
+LANGFUSE_SECRET_KEY=<key>    # For observability
+LANGFUSE_PUBLIC_KEY=<key>
+LANGFUSE_HOST=https://cloud.langfuse.com
+```
+
+## Local Development
+
+```bash
+# Get the bear
+git clone <repo-url> && cd codeyak
+cp .env.example .env  # Fill in credentials
+uv sync
+
+# Release it on a merge request
+uv run python -m codeyak <MR_IID> <PROJECT_ID>
+
+# Test with custom guidelines
+mkdir -p .codeyak
+echo "includes:
+  - builtin:security" > .codeyak/security.yaml
+uv run python -m codeyak <MR_IID> <PROJECT_ID>
+```
+
+## How It Works
+
+1. Fetches MR diff and existing review comments
+2. Runs review pass(es) based on active guidelines
+4. Posts only new, unique findings as inline comments
+
+---
+
+**Built with fierce determination** 🐻 **using Python and AI**

codeyak-0.0.1/TODO.md

@@ -0,0 +1,10 @@
+
+TODO:
+- need to determine when a new lib is used or updated to add web search to get context around the lib and usage
+- handle multiple triggers to same MR what to do?
+    - model can change scope and review also, consistencny??
+
+- need some way to add context for each project?? or maybe just guidelines is good enough for now?
+    - think about what you are reviewing, is it SDK, microservice, API? etc
+
+

codeyak-0.0.1/pyproject.toml

@@ -0,0 +1,76 @@
+[project]
+name = "codeyak"
+version = "0.0.1"
+description = "A code review agent optimized for following strict guidelines"
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "Ray Martinez", email = "raiselmartinez@gmail.com" }
+]
+requires-python = ">=3.12"
+keywords = [
+    "code-review",
+    "ai",
+    "llm",
+    "gitlab",
+    "automation",
+    "linting",
+    "azure-openai",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Software Development :: Testing",
+]
+dependencies = [
+    "click>=8.1.0",
+    "gitpython>=3.1.0",
+    "instructor>=1.14.1",
+    "langfuse>=3.11.2",
+    "openai>=2.15.0",
+    "pydantic-settings>=2.12.0",
+    "python-gitlab>=7.1.0",
+    "pyyaml>=6.0.1",
+    "tomli-w>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/ai-rayven/codeyak"
+Repository = "https://github.com/ai-rayven/codeyak"
+"Bug Tracker" = "https://github.com/ai-rayven/codeyak/issues"
+
+[project.scripts]
+yak = "codeyak.apps.cli:main"
+
+[project.optional-dependencies]
+test = [
+    "pytest>=8.0.0",
+    "pytest-cov>=6.0.0",
+    "pytest-mock>=3.14.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/codeyak"]
+
+[tool.pytest.ini_options]
+minversion = "8.0"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "-ra",
+    "--strict-markers",
+    "--strict-config",
+    "--showlocals",
+]

codeyak-0.0.1/src/codeyak/__init__.py

@@ -0,0 +1,3 @@
+"""CodeYak - AI-powered code review tool."""
+
+__version__ = "0.0.1"

codeyak-0.0.1/src/codeyak/__main__.py

@@ -0,0 +1,27 @@
+"""
+Entry point for running codeyak as a module.
+
+Supports both the new CLI interface and backwards-compatible direct invocation:
+    python -m codeyak review              # New: local review
+    python -m codeyak mr <MR_ID> [PROJECT_ID]  # New: MR review
+    python -m codeyak <MR_ID> [PROJECT_ID]     # Legacy: MR review
+"""
+
+import sys
+
+
+def main():
+    """Entry point that handles both CLI and legacy invocation."""
+    # Check if using legacy invocation (first arg is a number = MR_ID)
+    if len(sys.argv) > 1 and sys.argv[1].isdigit():
+        # Legacy mode: convert to new CLI format
+        # python -m codeyak <MR_ID> [PROJECT_ID] -> yak mr <MR_ID> [PROJECT_ID]
+        sys.argv = [sys.argv[0], "mr"] + sys.argv[1:]
+
+    # Import and run CLI
+    from .apps.cli import main as cli_main
+    cli_main()
+
+
+if __name__ == "__main__":
+    main()

codeyak-0.0.1/src/codeyak/apps/__init__.py

@@ -0,0 +1,3 @@
+"""
+CodeYak applications.
+"""

codeyak-0.0.1/src/codeyak/apps/cli/__init__.py

@@ -0,0 +1,7 @@
+"""
+CLI application for CodeYak.
+"""
+
+from .main import main
+
+__all__ = ["main"]