app.doql.less

// LESS format — define @variables here as needed

app {
  name: pyqual;
  version: 0.1.149;
  description: "Declarative quality gate loops for AI-assisted development";
  license: Apache-2.0;
  authors: "Tom Sapletta <tom@sapletta.com>";
  keywords: "AI, CI/CD, quality-gates, LLM, pipeline, devtools";
}

dependencies {
  runtime: "pyyaml>=6.0, typer>=0.12, rich>=13.0, litellm>=1.0, python-dotenv>=1.0, nfo>=0.2.13";
  analysis: "code2llm, vallm, redup";
  costs: costs;
  dev: "pytest>=8.0, pytest-cov>=5.0, goal>=2.1.218, costs>=0.1.20, pfix>=0.1.60, tox>=4.0.0";
  llx: llx>=0.1.75;
  mcp: "llx>=0.1.75, mcp>=1.0, uvicorn>=0.29";
  all: "llx>=0.1.75, code2llm, vallm, redup, costs";
}

interface[type="api"] {
  type: rest;
  framework: fastapi;
}

interface[type="cli"] {
  framework: argparse;
}
interface[type="cli"] page[name="pyqual"] {
  entry: pyqual.cli:app;
}

workflow[name="install"] {
  trigger: manual;
  step-1: run cmd=pip3 install -e .;
}

workflow[name="install-dev"] {
  trigger: manual;
  step-1: run cmd=pip3 install -e ".[dev]";
}

workflow[name="test"] {
  trigger: manual;
  step-1: run cmd=python3 -m pytest;
}

workflow[name="lint"] {
  trigger: manual;
  step-1: run cmd=ruff check .;
  step-2: run cmd=mypy pyqual;
}

workflow[name="format"] {
  trigger: manual;
  step-1: run cmd=ruff format .;
}

workflow[name="clean"] {
  trigger: manual;
  step-1: run cmd=rm -rf build/;
  step-2: run cmd=rm -rf dist/;
  step-3: run cmd=rm -rf *.egg-info/;
  step-4: run cmd=find . -type d -name __pycache__ -not -path "./.venv/*" -exec rm -rf {} + 2>/dev/null || true;
  step-5: run cmd=find . -type f -name "*.pyc" -not -path "./.venv/*" -delete;
}

workflow[name="build"] {
  trigger: manual;
  step-1: run cmd=python3 -m build;
}

workflow[name="bump-patch"] {
  trigger: manual;
  step-1: run cmd=echo "Bumping patch version...";
  step-2: run cmd=CURRENT=$$(cat VERSION); \;
  step-3: run cmd=MAJOR=$$(echo $$CURRENT | cut -d. -f1); \;
  step-4: run cmd=MINOR=$$(echo $$CURRENT | cut -d. -f2); \;
  step-5: run cmd=PATCH=$$(echo $$CURRENT | cut -d. -f3); \;
  step-6: run cmd=NEW_PATCH=$$((PATCH + 1)); \;
  step-7: run cmd=NEW_VERSION="$$MAJOR.$$MINOR.$$NEW_PATCH"; \;
  step-8: run cmd=echo "$$NEW_VERSION" > VERSION; \;
  step-9: run cmd=sed -i "s/version = \"$$CURRENT\"/version = \"$$NEW_VERSION\"/" pyproject.toml; \;
  step-10: run cmd=echo "Version bumped: $$CURRENT -> $$NEW_VERSION";
}

workflow[name="bump-minor"] {
  trigger: manual;
  step-1: run cmd=echo "Bumping minor version...";
  step-2: run cmd=CURRENT=$$(cat VERSION); \;
  step-3: run cmd=MAJOR=$$(echo $$CURRENT | cut -d. -f1); \;
  step-4: run cmd=MINOR=$$(echo $$CURRENT | cut -d. -f2); \;
  step-5: run cmd=NEW_MINOR=$$((MINOR + 1)); \;
  step-6: run cmd=NEW_VERSION="$$MAJOR.$$NEW_MINOR.0"; \;
  step-7: run cmd=echo "$$NEW_VERSION" > VERSION; \;
  step-8: run cmd=sed -i "s/version = \"$$CURRENT\"/version = \"$$NEW_VERSION\"/" pyproject.toml; \;
  step-9: run cmd=echo "Version bumped: $$CURRENT -> $$NEW_VERSION";
}

workflow[name="publish"] {
  trigger: manual;
  step-1: run cmd=python3 -m twine upload dist/* --skip-existing;
}

workflow[name="upload"] {
  trigger: manual;
  step-1: depend target=publish;
}

workflow[name="fmt"] {
  trigger: manual;
  step-1: run cmd=ruff format .;
}

workflow[name="help"] {
  trigger: manual;
  step-1: run cmd=echo "Available targets:";
  step-2: run cmd=echo "  install      Install the package";
  step-3: run cmd=echo "  install-dev  Install the package with dev dependencies";
  step-4: run cmd=echo "  test         Run tests";
  step-5: run cmd=echo "  lint         Run linting";
  step-6: run cmd=echo "  format       Format code";
  step-7: run cmd=echo "  clean        Clean build artifacts";
  step-8: run cmd=echo "  build        Build the package";
  step-9: run cmd=echo "  bump-patch   Bump patch version (0.1.2 -> 0.1.3)";
  step-10: run cmd=echo "  bump-minor   Bump minor version (0.1.2 -> 0.2.0)";
  step-11: run cmd=echo "  publish      Bump version, build and publish to PyPI";
  step-12: run cmd=echo "  upload       Upload to PyPI (alias for publish)";
}

workflow[name="health"] {
  trigger: manual;
  step-1: run cmd=docker compose ps;
  step-2: run cmd=docker compose exec app echo "Health check passed";
}

workflow[name="import-makefile-hint"] {
  trigger: manual;
  step-1: run cmd=echo 'Run: taskfile import Makefile to import existing targets.';
}

workflow[name="all"] {
  trigger: manual;
  step-1: run cmd=taskfile run install;
  step-2: run cmd=taskfile run lint;
  step-3: run cmd=taskfile run test;
}

workflow[name="sumd"] {
  trigger: manual;
  step-1: run cmd=echo "# $(basename $(pwd))" > SUMD.md
echo "" >> SUMD.md
echo "$(python3 -c "import tomllib; f=open('pyproject.toml','rb'); d=tomllib.load(f); print(d.get('project',{}).get('description','Project description'))" 2>/dev/null || echo 'Project description')" >> SUMD.md
echo "" >> SUMD.md
echo "## Contents" >> SUMD.md
echo "" >> SUMD.md
echo "- [Metadata](#metadata)" >> SUMD.md
echo "- [Architecture](#architecture)" >> SUMD.md
echo "- [Dependencies](#dependencies)" >> SUMD.md
echo "- [Source Map](#source-map)" >> SUMD.md
echo "- [Intent](#intent)" >> SUMD.md
echo "" >> SUMD.md
echo "## Metadata" >> SUMD.md
echo "" >> SUMD.md
echo "- **name**: \`$(basename $(pwd))\`" >> SUMD.md
echo "- **version**: \`$(python3 -c "import tomllib; f=open('pyproject.toml','rb'); d=tomllib.load(f); print(d.get('project',{}).get('version','unknown'))" 2>/dev/null || echo 'unknown')\`" >> SUMD.md
echo "- **python_requires**: \`>=$(python3 --version 2>/dev/null | cut -d' ' -f2 | cut -d. -f1,2)\`" >> SUMD.md
echo "- **license**: $(python3 -c "import tomllib; f=open('pyproject.toml','rb'); d=tomllib.load(f); print(d.get('project',{}).get('license',{}).get('text','MIT'))" 2>/dev/null || echo 'MIT')" >> SUMD.md
echo "- **ecosystem**: SUMD + DOQL + testql + taskfile" >> SUMD.md
echo "- **generated_from**: pyproject.toml, Taskfile.yml, Makefile, src/" >> SUMD.md
echo "" >> SUMD.md
echo "## Architecture" >> SUMD.md
echo "" >> SUMD.md
echo '```' >> SUMD.md
echo "SUMD (description) → DOQL/source (code) → taskfile (automation) → testql (verification)" >> SUMD.md
echo '```' >> SUMD.md
echo "" >> SUMD.md
echo "## Source Map" >> SUMD.md
echo "" >> SUMD.md
find . -name '*.py' -not -path './.venv/*' -not -path './venv/*' -not -path './__pycache__/*' -not -path './.git/*' | head -50 | sed 's|^./||' | sed 's|^|- |' >> SUMD.md
echo "Generated SUMD.md";
  step-2: run cmd=python3 -c "
import json, os, subprocess
from pathlib import Path
project_name = Path.cwd().name
py_files = list(Path('.').rglob('*.py'))
py_files = [f for f in py_files if not any(x in str(f) for x in ['.venv', 'venv', '__pycache__', '.git'])]
data = {
    'project_name': project_name,
    'description': 'SUMD - Structured Unified Markdown Descriptor for AI-aware project refactorization',
    'files': [{'path': str(f), 'type': 'python'} for f in py_files[:100]]
}
with open('sumd.json', 'w') as f:
    json.dump(data, f, indent=2)
print('Generated sumd.json')
" 2>/dev/null || echo 'Python generation failed, using fallback';
}

workflow[name="sumr"] {
  trigger: manual;
  step-1: run cmd=echo "# $(basename $(pwd)) - Summary Report" > SUMR.md
echo "" >> SUMR.md
echo "SUMR - Summary Report for project analysis" >> SUMR.md
echo "" >> SUMR.md
echo "## Contents" >> SUMR.md
echo "" >> SUMR.md
echo "- [Metadata](#metadata)" >> SUMR.md
echo "- [Quality Status](#quality-status)" >> SUMR.md
echo "- [Metrics](#metrics)" >> SUMR.md
echo "- [Refactoring Analysis](#refactoring-analysis)" >> SUMR.md
echo "- [Intent](#intent)" >> SUMR.md
echo "" >> SUMR.md
echo "## Metadata" >> SUMR.md
echo "" >> SUMR.md
echo "- **name**: \`$(basename $(pwd))\`" >> SUMR.md
echo "- **version**: \`$(python3 -c "import tomllib; f=open('pyproject.toml','rb'); d=tomllib.load(f); print(d.get('project',{}).get('version','unknown'))" 2>/dev/null || echo 'unknown')\`" >> SUMR.md
echo "- **generated_at**: \`$(date -Iseconds)\`" >> SUMR.md
echo "" >> SUMR.md
echo "## Quality Status" >> SUMR.md
echo "" >> SUMR.md
if [ -f pyqual.yaml ]; then
  echo "- **pyqual_config**: ✅ Present" >> SUMR.md
  echo "- **last_run**: $(stat -c %y .pyqual/pipeline.db 2>/dev/null | cut -d' ' -f1 || echo 'N/A')" >> SUMR.md
else
  echo "- **pyqual_config**: ❌ Missing" >> SUMR.md
fi
echo "" >> SUMR.md
echo "## Metrics" >> SUMR.md
echo "" >> SUMR.md
py_files=$(find . -name '*.py' -not -path './.venv/*' -not -path './venv/*' | wc -l)
echo "- **python_files**: $py_files" >> SUMR.md
lines=$(find . -name '*.py' -not -path './.venv/*' -not -path './venv/*' -exec cat {} \; 2>/dev/null | wc -l)
echo "- **total_lines**: $lines" >> SUMR.md
echo "" >> SUMR.md
echo "## Refactoring Analysis" >> SUMR.md
echo "" >> SUMR.md
echo "Run \`code2llm ./ -f evolution\` for detailed refactoring queue." >> SUMR.md
echo "Generated SUMR.md";
  step-2: run cmd=python3 -c "
import json, os, subprocess
from pathlib import Path
from datetime import datetime
project_name = Path.cwd().name
py_files = len([f for f in Path('.').rglob('*.py') if not any(x in str(f) for x in ['.venv', 'venv', '__pycache__', '.git'])])
data = {
    'project_name': project_name,
    'report_type': 'SUMR',
    'generated_at': datetime.now().isoformat(),
    'metrics': {
        'python_files': py_files,
        'has_pyqual_config': Path('pyqual.yaml').exists()
    }
}
with open('SUMR.json', 'w') as f:
    json.dump(data, f, indent=2)
print('Generated SUMR.json')
" 2>/dev/null || echo 'Python generation failed, using fallback';
}

tests {
  import: testql-scenarios/**/*.testql.toon.yaml;
}

env_vars {
  keys: OPENROUTER_API_KEY, LLM_MODEL, PFIX_MODEL, PFIX_AUTO_APPLY, PFIX_AUTO_INSTALL_DEPS, PFIX_AUTO_RESTART, PFIX_MAX_RETRIES, PFIX_DRY_RUN, PFIX_ENABLED, PFIX_GIT_COMMIT, PFIX_GIT_PREFIX, PFIX_CREATE_BACKUPS;
}

deploy {
  target: docker;
}

environment[name="local"] {
  runtime: docker-compose;
  env_file: .env;
  template_file: .env.example;
  python_version: >=3.9;
  vars: LLM_MODEL, OPENROUTER_API_KEY, PFIX_AUTO_APPLY, PFIX_AUTO_INSTALL_DEPS, PFIX_AUTO_RESTART, PFIX_CREATE_BACKUPS, PFIX_DRY_RUN, PFIX_ENABLED, PFIX_GIT_COMMIT, PFIX_GIT_PREFIX, PFIX_MAX_RETRIES, PFIX_MODEL;
  runtime_llm: OPENROUTER_API_KEY;
  runtime_pfix: PFIX_AUTO_APPLY, PFIX_AUTO_INSTALL_DEPS, PFIX_AUTO_RESTART, PFIX_CREATE_BACKUPS, PFIX_DRY_RUN, PFIX_ENABLED, PFIX_GIT_COMMIT, PFIX_GIT_PREFIX, PFIX_MAX_RETRIES, PFIX_MODEL;
}