refactoring

Author: tom-sapletta-com

.dockerignore

@@ -0,0 +1,18 @@
+.git
+.venv
+venv
+__pycache__
+*.pyc
+.pytest_cache
+.mypy_cache
+.ruff_cache
+.coverage
+htmlcov
+dist
+build
+*.egg-info
+.env
+.env.*
+! .env.example
+*.log
+profile.stats

.taskill/state.json

@@ -0,0 +1,13 @@
+{
+  "last_run_iso": "2026-04-25T18:22:34.274854+00:00",
+  "last_commit_sha": "2c593db97fdd03d3f1d9ae0804bb852c01e6526a",
+  "last_coverage_pct": null,
+  "last_failed_tests": null,
+  "last_sumd_hash": "4ead77e705653edc",
+  "last_todo_hash": "0ca9717777b64a6b",
+  "last_readme_hash": "85f1f3e604dd2c09",
+  "file_mtimes": {
+    "SUMD.md": 1777110970.3002408,
+    "SUMR.md": 1777110974.7123258
+  }
+}

CHANGELOG.md

@@ -106,6 +106,17 @@
 
 ## [Unreleased]
 
+
+- feat(pyqual): extract pipeline stages to reusable plugins in llx/pyqual_plugins
+- feat(pyqual): make publish idempotent with auto version bump
+- feat(config): deep code analysis engine with supporting modules
+- feat(config): new API capabilities
+- feat(goal): CLI interface improvements
+- test(pyqual): automate pyqual GitHub sync
+- fix(ci): address pyqual CI failures
+- chore(release): bump version for release and add build/publish stages
+- refactor(docs,examples,tests,llx): reorganize code analysis engine, configuration management, and quality metrics modules
+
 ## [0.1.60] - 2026-04-25
 
 ### Docs

Dockerfile

@@ -1,58 +1,35 @@
 # Multi-stage build for llx
 FROM python:3.11-slim AS builder
 
-# Set build arguments
-ARG BUILD_DATE
-ARG VERSION
-ARG VCS_REF
-
-# Labels
-LABEL maintainer="Tom Sapletta <tom@sapletta.org>"
-LABEL org.label-schema.build-date=$BUILD_DATE
-LABEL org.label-schema.name="llx"
-LABEL org.label-schema.description="Intelligent LLM model router driven by real code metrics"
-LABEL org.label-schema.url="https://github.com/wronai/llx"
-LABEL org.label-schema.vcs-ref=$VCS_REF
-LABEL org.label-schema.vcs-url="https://github.com/wronai/llx"
-LABEL org.label-schema.vendor="Tom Sapletta"
-LABEL org.label-schema.version=$VERSION
-
 # Set environment variables
 ENV PYTHONUNBUFFERED=1 \
     PYTHONDONTWRITEBYTECODE=1 \
-    PIP_NO_CACHE_DIR=1 \
+    PIP_NO_CACHE_DIR=0 \
     PIP_DISABLE_PIP_VERSION_CHECK=1
 
 # Install system dependencies
 RUN apt-get update && apt-get install -y \
     build-essential \
     curl \
     git \
-    jq \
-    netcat-openbsd \
-    ca-certificates \
     && rm -rf /var/lib/apt/lists/*
 
-# Create app user
-RUN groupadd -r llx && useradd -r -g llx llx
-
-# Set work directory
 WORKDIR /app
 
-# Copy requirements first for better caching
+# Copy pyproject.toml and requirements for caching
+COPY pyproject.toml .
 COPY requirements.txt .
-COPY requirements-dev.txt .
 
-# Install Python dependencies
-RUN pip install --upgrade pip && \
-    pip install -r requirements.txt && \
-    pip install -r requirements-dev.txt
+# Install dependencies with cache mount
+RUN --mount=type=cache,target=/root/.cache/pip \
+    pip install --upgrade pip && \
+    pip install -r requirements.txt
 
 # Copy application code
 COPY . .
 
-# Install llx in development mode
-RUN pip install -e .
+# Install llx (without dev deps for production-ready builder)
+RUN pip install .
 
 # Production stage
 FROM python:3.11-slim AS production
@@ -66,7 +43,6 @@ ENV PYTHONUNBUFFERED=1 \
 RUN apt-get update && apt-get install -y \
     curl \
     jq \
-    netcat-openbsd \
     ca-certificates \
     && rm -rf /var/lib/apt/lists/* && \
     apt-get clean
@@ -78,22 +54,20 @@ RUN groupadd -r llx && useradd -r -g llx llx
 RUN mkdir -p /app/logs /app/cache /app/data && \
     chown -R llx:llx /app
 
-# Copy from builder stage
-COPY --from=builder --chown=llx:llx /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
-COPY --from=builder --chown=llx:llx /usr/local/bin /usr/local/bin
-COPY --from=builder --chown=llx:llx /app /app
+# Copy from builder stage - only what's necessary
+COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
+COPY --from=builder /usr/local/bin /usr/local/bin
+COPY --from=builder --chown=llx:llx /app/llx /app/llx
+COPY --from=builder --chown=llx:llx /app/pyproject.toml /app/pyproject.toml
 
 # Switch to app user
 USER llx
-
-# Set work directory
 WORKDIR /app
 
 # Health check
 HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
     CMD curl -f http://localhost:4000/health || exit 1
 
-# Expose port
 EXPOSE 4000
 
 # Default command

Makefile

@@ -44,10 +44,15 @@ help:
 # Installation
 install:
 	@echo "📦 Installing llx..."
-	python -m venv .venv
-	.venv/bin/pip install --upgrade pip
-	.venv/bin/pip install -e .
-	.venv/bin/pip install -r requirements-dev.txt
+	@if command -v uv > /dev/null 2>&1; then \
+		uv venv; \
+		.venv/bin/pip install --upgrade pip; \
+		uv pip install -e ".[dev]"; \
+	else \
+		python -m venv .venv; \
+		.venv/bin/pip install --upgrade pip; \
+		.venv/bin/pip install -e ".[dev]"; \
+	fi
 	@echo "✅ Installation completed!"
 	@echo "Run 'source .venv/bin/activate' to activate the virtual environment"
 
@@ -93,15 +98,15 @@ test-docker:
 	docker run --rm llx-test .venv/bin/python -m pytest tests/ -v
 
 lint:
-	@echo "🔍 Running linting..."
-	.venv/bin/python -m flake8 llx/ --max-line-length=100 --ignore=E203,W503
+	@echo "🔍 Running linting with ruff..."
+	.venv/bin/python -m ruff check llx/
+	.venv/bin/python -m ruff check tests/
 	.venv/bin/python -m mypy llx/ --ignore-missing-imports
-	.venv/bin/python -m black --check llx/
 
 format:
-	@echo "📝 Formatting code..."
-	.venv/bin/python -m black llx/
-	.venv/bin/python -m isort llx/
+	@echo "📝 Formatting code with ruff..."
+	.venv/bin/python -m ruff format llx/
+	.venv/bin/python -m ruff format tests/
 
 # Docker commands
 docker-dev:
@@ -231,8 +236,8 @@ ci-test:
 	.venv/bin/python -m pytest tests/ -v --cov=llx --cov-report=xml --cov-report=html
 
 ci-lint:
-	@echo "🔍 CI linting..."
-	.venv/bin/python -m flake8 llx/ --max-line-length=100 --ignore=E203,W503 --output-format=github
+	@echo "🔍 CI linting with ruff..."
+	.venv/bin/python -m ruff check llx/ --format=github
 	.venv/bin/python -m mypy llx/ --ignore-missing-imports --junit-xml test-results.xml
 
 ci-build:

README.md

@@ -10,11 +10,11 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.60-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-26.9h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.31-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-28.4h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (73 commits)
-- 👤 **Human dev:** ~$2687 (26.9h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $7.5000 (74 commits)
+- 👤 **Human dev:** ~$2835 (28.4h @ $100/h, 30min dedup)
 
 Generated on 2026-04-25 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
@@ -266,6 +266,74 @@ llx init  # Creates llx.toml with defaults
 
 Environment variables: `LLX_LITELLM_URL`, `LLX_DEFAULT_TIER`, `LLX_PROXY_PORT`, `LLX_VERBOSE`.
 
+## Planfile Integration
+
+llx supports planfile.yaml format (redsl-generated) for sequential task execution:
+
+```python
+from llx.planfile import execute_strategy
+
+# Execute planfile.yaml (supports V1, V2, and redsl formats)
+results = execute_strategy(
+    "planfile.yaml",
+    project_path=".",
+    dry_run=True
+)
+
+# Process results
+for result in results:
+    print(f"{result.task_name}: {result.status}")
+```
+
+**CLI usage:**
+```bash
+# Proste lokalne wykonanie (nowa komenda)
+llx plan run .                          # Uruchom planfile.yaml
+llx plan run . --tier free               # Z konkretnym tierem modelu
+llx plan run . --sprint 1                # Tylko sprint 1
+llx plan run . --dry-run                 # Symulacja bez wykonywania
+
+# Generowanie i recenzja
+llx plan generate strategy.yaml --output generated/
+llx plan review strategy.yaml --project .
+
+# Tworzenie ticketów w GitHub (wymaga zewnętrznego planfile)
+llx plan execute strategy.yaml --project . --dry-run
+```
+
+**Supported formats:**
+- **V1**: Tasks defined separately in `task_patterns`
+- **V2**: Tasks embedded directly in sprints
+- **planfile.yaml**: Redsl-generated format with flat tasks list and sprint task_patterns
+
+See `llx/planfile/README_SIMPLIFIED.md` for details.
+
+## Testql Integration
+
+llx can execute tasks generated by testql audits:
+
+```bash
+# Generate planfile from testql audit
+testql audit --output .testql/dom-audit-planfile.json
+
+# Convert to planfile.yaml format (if needed)
+# Then execute with llx
+llx plan execute planfile.yaml --project . --dry-run
+```
+
+**Example workflow:**
+```bash
+# 1. Run testql audit
+testql audit --path ./my-project
+
+# 2. Generate planfile.yaml from audit results
+# (use redsl or manual conversion)
+
+# 3. Execute tasks with llx
+from llx.planfile import execute_strategy
+results = execute_strategy("planfile.yaml", project_path="./my-project")
+```
+
 ## Python API
 
 ```python
@@ -284,6 +352,8 @@ print(result.explain())   # Human-readable reasoning
 | [code2llm](https://github.com/wronai/code2llm) | Static analysis | CC, fan-out, cycles, hotspots |
 | [redup](https://github.com/semcod/redup) | Duplication detection | Groups, recoverable lines |
 | [vallm](https://github.com/semcod/vallm) | Code validation | Pass rate, issue count |
+| [planfile](https://github.com/semcod/planfile) | Strategy execution | Task execution, sprint management |
+| [testql](https://github.com/semcod/testql) | Quality testing | Audit integration, ticket generation |
 | **llx** | **Model routing + MCP server** | **Consumes all above** |
 
 ## Package structure
@@ -318,3 +388,20 @@ Full generated API inventory: `docs/README.md`.
 ## License
 
 Licensed under Apache-2.0.
+
+<!-- taskill:status:start -->
+
+## Status
+
+_Last updated by [taskill](https://github.com/oqlos/taskill) at 2026-04-25 18:22 UTC_
+
+| Metric | Value |
+|---|---|
+| HEAD | `2c593db` |
+| Coverage | — |
+| Failing tests | — |
+| Commits in last cycle | 0 |
+
+> No commits or file changes since the last taskill run.
+
+<!-- taskill:status:end -->