agentlinter 0.1.1__tar.gz

agentlinter-0.1.1/.github/dependabot.yml

@@ -0,0 +1,28 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "python"
+    commit-message:
+      prefix: "deps"
+    groups:
+      python-minor:
+        update-types:
+          - "minor"
+          - "patch"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "ci"
+    commit-message:
+      prefix: "ci"

agentlinter-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+      - run: pip install ruff
+      - run: ruff check src/ tests/
+      - run: ruff format --check src/ tests/
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: pytest tests/ -v

agentlinter-0.1.1/.github/workflows/codeql.yml

@@ -0,0 +1,24 @@
+name: CodeQL Security Scan
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: '0 6 * * 1'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      security-events: write
+      contents: read
+      actions: read
+    steps:
+      - uses: actions/checkout@v6
+      - uses: github/codeql-action/init@v4
+        with:
+          languages: python
+      - uses: github/codeql-action/analyze@v4

agentlinter-0.1.1/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+.venv/
+venv/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+*.so
+.coverage
+htmlcov/
+.env
+*.log

agentlinter-0.1.1/CLAUDE.md

@@ -0,0 +1,77 @@
+# CLAUDE.md — agent-lint
+
+## Project Overview
+CLI tool that analyzes agent workflow YAML configs for cost estimation, anti-pattern detection (linting), and multi-provider comparison. Supports Gorgon/Forge, CrewAI, LangChain/LangGraph, and generic YAML formats.
+
+## Quick Start
+```bash
+cd /home/arete/projects/agent-lint
+source .venv/bin/activate
+pip install -e ".[dev]"
+pytest tests/ -v
+ruff check src/ tests/ && ruff format --check src/ tests/
+```
+
+## Architecture
+- **src layout**: `src/agent_lint/` with 15 modules across 4 packages
+- **Entry point**: `agent-lint = "agent_lint.cli:app"` (Typer)
+- **Models**: Pydantic v2 (`models.py`)
+- **Parsers**: Strategy pattern — `detect_format()` dispatches to format-specific parser
+- **Estimator**: 3-tier token resolution (declared → archetype → default), bundled pricing YAML
+- **Linter**: `@lint_rule` decorator registry, 17 rules across 4 categories
+- **Licensing**: HMAC-checksum keys, prefix `ALNT`, salt `agent-lint-v1`
+
+## Key Commands
+```bash
+agent-lint estimate workflow.yaml                    # Cost estimate (table)
+agent-lint estimate workflow.yaml --json             # JSON output
+agent-lint estimate workflow.yaml --format markdown  # Markdown output
+agent-lint estimate workflow.yaml --provider ollama  # Override provider
+agent-lint lint workflow.yaml                        # Lint for anti-patterns
+agent-lint lint workflow.yaml --category budget      # Filter by category
+agent-lint lint workflow.yaml --fail-under 80        # CI mode (exit 1 if below)
+agent-lint compare workflow.yaml                     # Multi-provider comparison (Pro)
+agent-lint status                                    # Show license tier
+```
+
+## Workflow Formats
+| Format | Detection | Key Structure |
+|--------|-----------|---------------|
+| Gorgon | `steps[].type` in known set | claude_code, openai, shell, parallel, etc. |
+| CrewAI | `agents` + `tasks` top-level | Agent definitions + task assignments |
+| LangChain | `nodes` or `edges` | Graph-based node definitions |
+| Generic | Fallback | Any YAML with step-like structures |
+
+## Lint Rules (17 total)
+| Category | Rules | IDs |
+|----------|-------|-----|
+| Budget | Missing budgets, over-budget | B001-B004 |
+| Resilience | Missing handlers, no retries | R001-R005 |
+| Efficiency | Parallelization, redundancy | E001-E004 |
+| Security | Injection, hardcoded paths | S001-S004 |
+
+## Token Estimation Strategy
+Resolution order per step:
+1. `estimated_tokens` from YAML → source: "declared"
+2. `ROLE_TOKEN_DEFAULTS[role]` → source: "archetype"
+3. `STEP_TYPE_TOKEN_DEFAULTS[step_type]` → source: "default"
+
+## Monetization
+| Feature | Free | Pro ($8/mo) |
+|---------|------|-------------|
+| estimate | Yes | Yes |
+| lint | Yes | Yes |
+| status | Yes | Yes |
+| compare | No | Yes |
+| markdown_export | No | Yes |
+| custom_pricing | No | Yes |
+
+## Testing
+- 193 tests, pytest
+- `tests/conftest.py` has sample workflow YAML fixtures
+- All parsers tested via fixture files
+
+## Conventions
+- Python 3.11+, `from __future__ import annotations` everywhere
+- Ruff lint + format (B008 suppressed for cli.py — Typer pattern)
+- Dependencies: typer, rich, pydantic, pyyaml

agentlinter-0.1.1/LICENSE

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

agentlinter-0.1.1/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: agentlinter
+Version: 0.1.1
+Summary: Estimate costs and lint agent workflow YAML files
+Author: AreteDriver
+License: MIT
+Project-URL: Homepage, https://github.com/AreteDriver/agent-lint
+Project-URL: Repository, https://github.com/AreteDriver/agent-lint
+Project-URL: Issues, https://github.com/AreteDriver/agent-lint/issues
+Keywords: ai,agents,workflow,cost,linter,claude,openai,ollama
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# agent-lint
+
+[![CI](https://github.com/AreteDriver/agent-lint/actions/workflows/ci.yml/badge.svg)](https://github.com/AreteDriver/agent-lint/actions/workflows/ci.yml)
+[![CodeQL](https://github.com/AreteDriver/agent-lint/actions/workflows/codeql.yml/badge.svg)](https://github.com/AreteDriver/agent-lint/actions/workflows/codeql.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+**Catch expensive agent pipelines before they run.**
+
+`agent-lint` is the eslint of agent workflows. It reads your YAML configs, flags structural problems, and tells you what a run will cost — before you press enter.
+
+```
+$ agent-lint lint workflow.yaml
+
+  3 steps validated
+  [warn] step 2: model=claude-opus-4-6 — consider claude-sonnet-4-6 (~$0.18 -> ~$0.02 per run)
+  [warn] step 3: no max_tokens set — cost unbounded
+  [fail] step 1: missing fallback handler — silent failure risk
+
+  Score: 62/100
+
+$ agent-lint estimate workflow.yaml
+
+  Step 1  researcher    claude-sonnet-4-6    ~4,200 tokens    $0.02
+  Step 2  writer        claude-opus-4-6      ~8,800 tokens    $0.18
+  Step 3  reviewer      claude-sonnet-4-6    ~3,100 tokens    $0.01
+  ──────────────────────────────────────────────────────────────────
+  Total                                     ~16,100 tokens    $0.21
+  Monthly (3x/day)                                           ~$19
+```
+
+No proxies. No SDK integration. Just point it at your workflow file.
+
+## Install
+
+```bash
+pip install agent-lint
+```
+
+## Why
+
+Every agent framework lets you *run* workflows. None of them tell you what it will cost before you do. You find out three days later when the invoice arrives.
+
+`agent-lint` catches the problems that don't show up in testing:
+
+- The step using Opus when Sonnet would do
+- The loop with no max_tokens that could run up a $200 bill
+- The missing error handler that silently retries (and silently bills)
+- The hardcoded path that works on your machine and nowhere else
+
+## Usage
+
+```bash
+# Estimate costs for a workflow
+agent-lint estimate workflow.yaml
+agent-lint estimate workflow.yaml --provider openai
+agent-lint estimate workflow.yaml --json
+
+# Lint for anti-patterns
+agent-lint lint workflow.yaml
+agent-lint lint workflow.yaml --fail-under 80   # CI gate
+
+# Compare providers side-by-side (Pro)
+agent-lint compare workflow.yaml
+
+# Check license status
+agent-lint status
+```
+
+## Supported Formats
+
+| Format | Detection |
+|--------|-----------|
+| Gorgon/Forge | `steps[].type` matches known step types |
+| CrewAI | `agents` + `tasks` top-level keys |
+| LangChain/LangGraph | `nodes` or `edges` structure |
+| Generic | Any YAML with step-like structures |
+
+## Lint Rules
+
+17 rules across 4 categories:
+
+| Category | What it catches | IDs |
+|----------|----------------|-----|
+| **Budget** | Missing budgets, unbounded costs, over-budget steps | B001-B004 |
+| **Resilience** | Missing error handlers, no retries, no timeouts | R001-R005 |
+| **Efficiency** | Missed parallelization, redundant steps | E001-E004 |
+| **Security** | Prompt injection risk, hardcoded paths/secrets | S001-S004 |
+
+## How It Compares
+
+| | Pre-run cost estimate | Workflow linting | No proxy required | CLI-native |
+|---|:---:|:---:|:---:|:---:|
+| **agent-lint** | Yes | Yes | Yes | Yes |
+| Langfuse | No (post-run) | No | No (SDK required) | No |
+| Datadog LLM Observability | No (post-run) | No | No (agent required) | No |
+| Manual review | No | No | Yes | -- |
+
+## CI Integration
+
+```yaml
+# .github/workflows/agent-lint.yml
+- name: Lint agent workflows
+  run: agent-lint lint workflows/ --fail-under 80
+```
+
+Exits non-zero when the health score drops below your threshold.
+
+## Free vs Pro
+
+| Feature | Free | Pro |
+|---------|:---:|:---:|
+| Cost estimation | Yes | Yes |
+| Lint (17 rules) | Yes | Yes |
+| JSON output | Yes | Yes |
+| Multi-provider comparison | -- | Yes |
+| Markdown export | -- | Yes |
+| Custom pricing tables | -- | Yes |
+
+## License
+
+MIT

agentlinter-0.1.1/README.md

@@ -0,0 +1,122 @@
+# agent-lint
+
+[![CI](https://github.com/AreteDriver/agent-lint/actions/workflows/ci.yml/badge.svg)](https://github.com/AreteDriver/agent-lint/actions/workflows/ci.yml)
+[![CodeQL](https://github.com/AreteDriver/agent-lint/actions/workflows/codeql.yml/badge.svg)](https://github.com/AreteDriver/agent-lint/actions/workflows/codeql.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+**Catch expensive agent pipelines before they run.**
+
+`agent-lint` is the eslint of agent workflows. It reads your YAML configs, flags structural problems, and tells you what a run will cost — before you press enter.
+
+```
+$ agent-lint lint workflow.yaml
+
+  3 steps validated
+  [warn] step 2: model=claude-opus-4-6 — consider claude-sonnet-4-6 (~$0.18 -> ~$0.02 per run)
+  [warn] step 3: no max_tokens set — cost unbounded
+  [fail] step 1: missing fallback handler — silent failure risk
+
+  Score: 62/100
+
+$ agent-lint estimate workflow.yaml
+
+  Step 1  researcher    claude-sonnet-4-6    ~4,200 tokens    $0.02
+  Step 2  writer        claude-opus-4-6      ~8,800 tokens    $0.18
+  Step 3  reviewer      claude-sonnet-4-6    ~3,100 tokens    $0.01
+  ──────────────────────────────────────────────────────────────────
+  Total                                     ~16,100 tokens    $0.21
+  Monthly (3x/day)                                           ~$19
+```
+
+No proxies. No SDK integration. Just point it at your workflow file.
+
+## Install
+
+```bash
+pip install agent-lint
+```
+
+## Why
+
+Every agent framework lets you *run* workflows. None of them tell you what it will cost before you do. You find out three days later when the invoice arrives.
+
+`agent-lint` catches the problems that don't show up in testing:
+
+- The step using Opus when Sonnet would do
+- The loop with no max_tokens that could run up a $200 bill
+- The missing error handler that silently retries (and silently bills)
+- The hardcoded path that works on your machine and nowhere else
+
+## Usage
+
+```bash
+# Estimate costs for a workflow
+agent-lint estimate workflow.yaml
+agent-lint estimate workflow.yaml --provider openai
+agent-lint estimate workflow.yaml --json
+
+# Lint for anti-patterns
+agent-lint lint workflow.yaml
+agent-lint lint workflow.yaml --fail-under 80   # CI gate
+
+# Compare providers side-by-side (Pro)
+agent-lint compare workflow.yaml
+
+# Check license status
+agent-lint status
+```
+
+## Supported Formats
+
+| Format | Detection |
+|--------|-----------|
+| Gorgon/Forge | `steps[].type` matches known step types |
+| CrewAI | `agents` + `tasks` top-level keys |
+| LangChain/LangGraph | `nodes` or `edges` structure |
+| Generic | Any YAML with step-like structures |
+
+## Lint Rules
+
+17 rules across 4 categories:
+
+| Category | What it catches | IDs |
+|----------|----------------|-----|
+| **Budget** | Missing budgets, unbounded costs, over-budget steps | B001-B004 |
+| **Resilience** | Missing error handlers, no retries, no timeouts | R001-R005 |
+| **Efficiency** | Missed parallelization, redundant steps | E001-E004 |
+| **Security** | Prompt injection risk, hardcoded paths/secrets | S001-S004 |
+
+## How It Compares
+
+| | Pre-run cost estimate | Workflow linting | No proxy required | CLI-native |
+|---|:---:|:---:|:---:|:---:|
+| **agent-lint** | Yes | Yes | Yes | Yes |
+| Langfuse | No (post-run) | No | No (SDK required) | No |
+| Datadog LLM Observability | No (post-run) | No | No (agent required) | No |
+| Manual review | No | No | Yes | -- |
+
+## CI Integration
+
+```yaml
+# .github/workflows/agent-lint.yml
+- name: Lint agent workflows
+  run: agent-lint lint workflows/ --fail-under 80
+```
+
+Exits non-zero when the health score drops below your threshold.
+
+## Free vs Pro
+
+| Feature | Free | Pro |
+|---------|:---:|:---:|
+| Cost estimation | Yes | Yes |
+| Lint (17 rules) | Yes | Yes |
+| JSON output | Yes | Yes |
+| Multi-provider comparison | -- | Yes |
+| Markdown export | -- | Yes |
+| Custom pricing tables | -- | Yes |
+
+## License
+
+MIT

agentlinter-0.1.1/pyproject.toml

@@ -0,0 +1,69 @@
+[build-system]
+requires = ["setuptools>=68.0", "setuptools-scm>=8.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agentlinter"
+version = "0.1.1"
+description = "Estimate costs and lint agent workflow YAML files"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.11"
+authors = [{name = "AreteDriver"}]
+keywords = ["ai", "agents", "workflow", "cost", "linter", "claude", "openai", "ollama"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Build Tools",
+    "Typing :: Typed",
+]
+dependencies = [
+    "typer>=0.9.0",
+    "rich>=13.0",
+    "pydantic>=2.0",
+    "pyyaml>=6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "mypy>=1.0",
+    "ruff>=0.1.0",
+]
+
+[project.scripts]
+agent-lint = "agent_lint.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/AreteDriver/agent-lint"
+Repository = "https://github.com/AreteDriver/agent-lint"
+Issues = "https://github.com/AreteDriver/agent-lint/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+agent_lint = ["data/*.yaml"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "N", "UP", "B", "A", "SIM"]
+
+[tool.ruff.lint.per-file-ignores]
+"src/agent_lint/cli.py" = ["B008"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true

agentlinter-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

agentlinter-0.1.1/src/agent_lint/__init__.py

@@ -0,0 +1,4 @@
+"""agent-lint -- Estimate costs and lint agent workflow YAML files."""
+
+__version__ = "0.1.1"
+__all__ = ["__version__"]

agentlinter-0.1.1/src/agent_lint/__main__.py

@@ -0,0 +1,8 @@
+"""Allow running as ``python -m agent_lint``."""
+
+from __future__ import annotations
+
+from agent_lint.cli import app
+
+if __name__ == "__main__":
+    app()