dddlint 0.1.2__tar.gz

dddlint-0.1.2/.github/actions/smallsteps/action.yaml

@@ -0,0 +1,20 @@
+name: 'Smallsteps Ratchet Evaluation'
+description: 'Evaluates your quality goals'
+inputs:
+  SMALLSTEPS_PYTEST_COVERAGE:
+    description: "Current live performance value for 'Pytest Coverage'"
+    required: true
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Install uv
+      uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+      with:
+        enable-cache: true
+
+    - name: Run Smallsteps Guardrail Validation
+      shell: bash
+      run: uvx smallsteps check
+      env:
+        SMALLSTEPS_PYTEST_COVERAGE: ${{ inputs.SMALLSTEPS_PYTEST_COVERAGE }}

dddlint-0.1.2/.github/workflows/workflow.yaml

@@ -0,0 +1,123 @@
+name: CI and Publish
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-extras --frozen
+
+      - name: Lint with ruff
+        run: uv run ruff check .
+
+      - name: Format check with ruff
+        run: uv run ruff format --check .
+
+      - name: Type check with basedpyright
+        run: uv run basedpyright
+
+      - name: Run unit tests (parallel)
+        run: uv run pytest -m unit -n auto --cov=dddlint --cov-report=term-missing --cov-report=json
+
+      - name: Compute coverage
+        id: cov
+        run: echo "value=$(uv run python -c 'import json; print(json.load(open("coverage.json"))["totals"]["percent_covered"])')" >> "$GITHUB_OUTPUT"
+
+      - name: Enforce coverage ratchet
+        uses: ./.github/actions/smallsteps
+        with:
+          SMALLSTEPS_PYTEST_COVERAGE: ${{ steps.cov.outputs.value }}
+
+  publish:
+    needs: test
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/dddlint
+    permissions:
+      id-token: write
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-extras --frozen
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Bump version
+        run: uv run bump-my-version bump patch
+
+      - name: Push version bump
+        run: git push --follow-tags
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  docs:
+    needs: test
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-extras --frozen
+
+      - name: Build docs
+        run: uv run zensical build
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

dddlint-0.1.2/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

dddlint-0.1.2/.pre-commit-config.yaml

@@ -0,0 +1,94 @@
+default_language_version:
+  python: python3
+default_stages: [pre-commit]
+repos:
+  - 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: mixed-line-ending
+        args: [--fix=lf]
+      - id: check-yaml
+        args: [--unsafe]
+      - id: check-json
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: check-case-conflict
+      - id: check-ast
+      - id: check-docstring-first
+      - id: debug-statements
+      - id: name-tests-test
+        args: [--pytest-test-first]
+      - id: detect-private-key
+      - id: check-added-large-files
+        args: [--maxkb=1000]
+
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.47.0
+    hooks:
+      - id: markdownlint
+        args: [--fix, --disable, MD013, MD024, MD033, MD036, MD040, MD041, MD060, --]
+
+  - repo: https://github.com/commitizen-tools/commitizen
+    rev: v4.12.1
+    hooks:
+      - id: commitizen
+        stages: [commit-msg]
+
+  - repo: https://github.com/benomahony/nasa-lsp
+    rev: v0.1.7
+    hooks:
+      - id: nasa-lsp
+        exclude: ^(tests|examples)/
+
+  - repo: local
+    hooks:
+      - id: ruff-format
+        name: ruff-format
+        entry: uv run ruff format
+        language: system
+        types_or: [python, pyi]
+        require_serial: true
+      - id: ruff
+        name: ruff
+        entry: uv run ruff check --fix --exit-non-zero-on-fix
+        language: system
+        types_or: [python, pyi]
+        require_serial: true
+      - id: basedpyright
+        name: basedpyright
+        entry: uv run basedpyright
+        language: system
+        types: [python]
+        pass_filenames: true
+        require_serial: true
+      - id: vulture
+        name: vulture
+        entry: uv run vulture src/dddlint/ --min-confidence 80
+        language: system
+        types: [python]
+        files: ^src/dddlint/
+        pass_filenames: false
+        require_serial: true
+      - id: bandit
+        name: bandit
+        entry: uv run bandit -c pyproject.toml -r src/dddlint/
+        language: system
+        files: ^src/dddlint/
+        exclude: ^tests/
+        pass_filenames: false
+      - id: cliqa
+        name: cliqa
+        entry: uv run cliqa analyze dddlint
+        language: system
+        files: ^(pyproject\.toml|src/.*\.py)$
+        pass_filenames: false
+        require_serial: true
+      - id: deptry
+        name: deptry
+        entry: uv run deptry . --extend-exclude "\.venv|tests"
+        language: system
+        pass_filenames: false
+        require_serial: true

dddlint-0.1.2/.python-version

@@ -0,0 +1 @@
+3.12

dddlint-0.1.2/.skills/dddlint/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: dddlint
+description: Help users work with dddlint. Use when the user asks about dddlint features, usage, or wants to implement functionality using this project.
+---
+
+# dddlint Skill
+
+This skill helps you work with dddlint.
+
+## When to Use This Skill
+
+Use this skill when:
+
+- User asks about dddlint features or capabilities
+- User wants to use dddlint in their code
+- User needs help with dddlint API or CLI
+- User wants examples of dddlint usage
+
+## Project Information
+
+- **Description**: Polyglot ubiquitous language linter for codebases and coding agents
+- **Author**: benomahony
+- **Documentation**: See docs/index.md for full documentation
+- **Source**: src/dddlint/
+
+## Quick Reference
+
+### CLI Usage
+
+```bash
+dddlint --help
+```
+
+### Library Usage
+
+```python
+from dddlint.core import example_function
+
+result = example_function("World")
+```
+
+## Resources
+
+- Check docs/index.md for comprehensive documentation
+- Check llms.txt for LLM-friendly documentation summary
+- Check src/dddlint/ for implementation details

dddlint-0.1.2/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: dddlint
+Version: 0.1.2
+Summary: Polyglot ubiquitous language linter for codebases and coding agents
+Project-URL: Repository, https://github.com/benomahony/dddlint
+Author: benomahony
+Requires-Python: >=3.12
+Requires-Dist: lsprotocol>=2025.0.0
+Requires-Dist: mcp>=1.28.1
+Requires-Dist: pydantic>=2.13.4
+Requires-Dist: pygls>=2.1.1
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: rich>=15.0.0
+Requires-Dist: tree-sitter-language-pack>=1.8.1
+Requires-Dist: typer>=0.26.2
+Description-Content-Type: text/markdown
+
+# dddlint
+
+Polyglot ubiquitous language linter. Reads class, function, method, and type names across **306 languages** and enforces them against a domain vocabulary — banned terms, non-canonical synonyms, and one concept spelled multiple ways.
+
+Works with any language tree-sitter recognises, without per-language queries. Slots into pre-commit hooks, CI pipelines, and coding agent loops via a non-zero exit code on findings. Ships with an LSP server for inline editor diagnostics and rename code actions.
+
+## Install
+
+```sh
+uv add dddlint
+```
+
+## Quick start
+
+```sh
+# lint current directory (looks for dddlint.yaml)
+dddlint lint
+
+# lint a specific path
+dddlint lint src/
+
+# open an interactive language graph in the browser
+dddlint html
+
+# start the LSP server (stdio)
+dddlint lsp
+```
+
+## Config
+
+Place `dddlint.yaml` at the project root. When a path is passed to `lint` or `html`, the config is looked up in that directory first, then falls back to the current working directory.
+
+```yaml
+similarity_threshold: 0.85   # Jaccard threshold for drift detection
+enforce_canonical: true       # flag alias terms in addition to forbidden ones
+
+# terms that must never appear in a definition name
+forbidden:
+  - util
+  - helper
+  - manager
+
+# canonical terms and their aliases
+synonyms:
+  - canonical: customer
+    aliases: [client, user, accountholder]
+  - canonical: order
+    aliases: [purchase, transaction]
+
+# high-level business domains
+domains:
+  - name: commerce
+    include: ["**/commerce/**"]
+    synonyms:
+      - canonical: order
+        aliases: [purchase]
+
+# bounded contexts — same structure as domains, applied after (context wins on conflict)
+contexts:
+  - name: billing
+    include: ["**/billing/**"]
+    forbidden: [discount]
+    synonyms:
+      - canonical: invoice
+        aliases: [bill, statement]
+
+# register file extensions for languages not auto-detected
+languages:
+  svelte:
+    extensions: [".svelte"]
+```
+
+Global rules apply everywhere. Domain rules apply to matching paths. Context rules apply after domains, so a context can override a domain synonym.
+
+## Rules
+
+| Rule | Severity | Description |
+|---|---|---|
+| `forbidden` | error | A definition name contains a banned term |
+| `alias` | warning | A definition uses a non-canonical synonym — includes a rename suggestion |
+| `drift` | info | The same concept is spelled multiple ways across the codebase |
+| `config:forbidden-canonical-clash` | error | A term is both forbidden and a canonical synonym |
+| `config:alias-conflict` | warning | The same alias maps to different canonicals in different scopes |
+| `config:duplicate-name` | info | Two domains or contexts have suspiciously similar names |
+
+Config rules are checked against `dddlint.yaml` itself on every run.
+
+## LSP
+
+The LSP server publishes diagnostics on file open and save, scanning the entire workspace each time so cross-file drift is always caught. Alias findings include a code action to rename the identifier to the canonical term with case preserved (`ClientRepo` → `CustomerRepo`, `get_client` → `get_customer`).
+
+**Neovim** — add to `init.lua`:
+
+```lua
+vim.api.nvim_create_autocmd("BufReadPost", {
+  callback = function(args)
+    local root = vim.fs.root(args.buf, { "dddlint.yaml" })
+    if root then
+      vim.lsp.start({
+        name = "dddlint",
+        cmd = { "dddlint", "lsp" },
+        root_dir = root,
+      }, { bufnr = args.buf })
+    end
+  end,
+})
+```
+
+The autocmd fires on every buffer, attaches only when `dddlint.yaml` is found, and is language-agnostic — no filetype list required.
+
+**VS Code** — via a generic LSP client extension:
+
+```json
+{
+  "lsp.servers": {
+    "dddlint": {
+      "command": ["uvx", "dddlint", "lsp"],
+      "filetypes": ["*"]
+    }
+  }
+}
+```
+
+**Helix** — `.helix/languages.toml`:
+
+```toml
+[language-server.dddlint]
+command = "dddlint"
+args = ["lsp"]
+```
+
+## Language support
+
+Extraction is powered by [`tree-sitter-language-pack`](https://github.com/Goldziher/tree-sitter-language-pack), which covers 306 languages including:
+
+Ada · Agda · Arduino · Bash · C · C++ · C# · Clojure · COBOL · Crystal · CSS · D · Dart · Dockerfile · Elixir · Elm · Erlang · F# · Fortran · GDScript · GLSL · Go · GraphQL · Groovy · Hack · Haskell · HCL · HTML · Java · JavaScript · Julia · Kotlin · Lean · Lua · MATLAB · Mojo · Nix · OCaml · Odin · Pascal · Perl · PHP · PowerShell · Prolog · Python · R · Racket · Ruby · Rust · Scala · Scheme · Solidity · SQL · Svelte · Swift · Terraform · TLA+ · TOML · TypeScript · V · VHDL · Vim · Vue · WebAssembly · XML · YAML · Zig — and [243 more](https://github.com/Goldziher/tree-sitter-language-pack).
+
+## CI
+
+```yaml
+# .github/workflows/dddlint.yml
+- run: uvx dddlint lint
+```
+
+Exit code is `0` when clean, `1` when findings exist.
+
+## Pre-commit
+
+```yaml
+# .pre-commit-config.yaml
+repos:
+  - repo: local
+    hooks:
+      - id: dddlint
+        name: dddlint
+        entry: dddlint lint
+        language: python
+        pass_filenames: false
+```
+
+## Offline use
+
+The language pack downloads parsers on first use. For CI or air-gapped runs, warm the cache in the image:
+
+```sh
+python -c "import tree_sitter_language_pack as t; t.download_all()"
+```

dddlint-0.1.2/README.md

@@ -0,0 +1,167 @@
+# dddlint
+
+Polyglot ubiquitous language linter. Reads class, function, method, and type names across **306 languages** and enforces them against a domain vocabulary — banned terms, non-canonical synonyms, and one concept spelled multiple ways.
+
+Works with any language tree-sitter recognises, without per-language queries. Slots into pre-commit hooks, CI pipelines, and coding agent loops via a non-zero exit code on findings. Ships with an LSP server for inline editor diagnostics and rename code actions.
+
+## Install
+
+```sh
+uv add dddlint
+```
+
+## Quick start
+
+```sh
+# lint current directory (looks for dddlint.yaml)
+dddlint lint
+
+# lint a specific path
+dddlint lint src/
+
+# open an interactive language graph in the browser
+dddlint html
+
+# start the LSP server (stdio)
+dddlint lsp
+```
+
+## Config
+
+Place `dddlint.yaml` at the project root. When a path is passed to `lint` or `html`, the config is looked up in that directory first, then falls back to the current working directory.
+
+```yaml
+similarity_threshold: 0.85   # Jaccard threshold for drift detection
+enforce_canonical: true       # flag alias terms in addition to forbidden ones
+
+# terms that must never appear in a definition name
+forbidden:
+  - util
+  - helper
+  - manager
+
+# canonical terms and their aliases
+synonyms:
+  - canonical: customer
+    aliases: [client, user, accountholder]
+  - canonical: order
+    aliases: [purchase, transaction]
+
+# high-level business domains
+domains:
+  - name: commerce
+    include: ["**/commerce/**"]
+    synonyms:
+      - canonical: order
+        aliases: [purchase]
+
+# bounded contexts — same structure as domains, applied after (context wins on conflict)
+contexts:
+  - name: billing
+    include: ["**/billing/**"]
+    forbidden: [discount]
+    synonyms:
+      - canonical: invoice
+        aliases: [bill, statement]
+
+# register file extensions for languages not auto-detected
+languages:
+  svelte:
+    extensions: [".svelte"]
+```
+
+Global rules apply everywhere. Domain rules apply to matching paths. Context rules apply after domains, so a context can override a domain synonym.
+
+## Rules
+
+| Rule | Severity | Description |
+|---|---|---|
+| `forbidden` | error | A definition name contains a banned term |
+| `alias` | warning | A definition uses a non-canonical synonym — includes a rename suggestion |
+| `drift` | info | The same concept is spelled multiple ways across the codebase |
+| `config:forbidden-canonical-clash` | error | A term is both forbidden and a canonical synonym |
+| `config:alias-conflict` | warning | The same alias maps to different canonicals in different scopes |
+| `config:duplicate-name` | info | Two domains or contexts have suspiciously similar names |
+
+Config rules are checked against `dddlint.yaml` itself on every run.
+
+## LSP
+
+The LSP server publishes diagnostics on file open and save, scanning the entire workspace each time so cross-file drift is always caught. Alias findings include a code action to rename the identifier to the canonical term with case preserved (`ClientRepo` → `CustomerRepo`, `get_client` → `get_customer`).
+
+**Neovim** — add to `init.lua`:
+
+```lua
+vim.api.nvim_create_autocmd("BufReadPost", {
+  callback = function(args)
+    local root = vim.fs.root(args.buf, { "dddlint.yaml" })
+    if root then
+      vim.lsp.start({
+        name = "dddlint",
+        cmd = { "dddlint", "lsp" },
+        root_dir = root,
+      }, { bufnr = args.buf })
+    end
+  end,
+})
+```
+
+The autocmd fires on every buffer, attaches only when `dddlint.yaml` is found, and is language-agnostic — no filetype list required.
+
+**VS Code** — via a generic LSP client extension:
+
+```json
+{
+  "lsp.servers": {
+    "dddlint": {
+      "command": ["uvx", "dddlint", "lsp"],
+      "filetypes": ["*"]
+    }
+  }
+}
+```
+
+**Helix** — `.helix/languages.toml`:
+
+```toml
+[language-server.dddlint]
+command = "dddlint"
+args = ["lsp"]
+```
+
+## Language support
+
+Extraction is powered by [`tree-sitter-language-pack`](https://github.com/Goldziher/tree-sitter-language-pack), which covers 306 languages including:
+
+Ada · Agda · Arduino · Bash · C · C++ · C# · Clojure · COBOL · Crystal · CSS · D · Dart · Dockerfile · Elixir · Elm · Erlang · F# · Fortran · GDScript · GLSL · Go · GraphQL · Groovy · Hack · Haskell · HCL · HTML · Java · JavaScript · Julia · Kotlin · Lean · Lua · MATLAB · Mojo · Nix · OCaml · Odin · Pascal · Perl · PHP · PowerShell · Prolog · Python · R · Racket · Ruby · Rust · Scala · Scheme · Solidity · SQL · Svelte · Swift · Terraform · TLA+ · TOML · TypeScript · V · VHDL · Vim · Vue · WebAssembly · XML · YAML · Zig — and [243 more](https://github.com/Goldziher/tree-sitter-language-pack).
+
+## CI
+
+```yaml
+# .github/workflows/dddlint.yml
+- run: uvx dddlint lint
+```
+
+Exit code is `0` when clean, `1` when findings exist.
+
+## Pre-commit
+
+```yaml
+# .pre-commit-config.yaml
+repos:
+  - repo: local
+    hooks:
+      - id: dddlint
+        name: dddlint
+        entry: dddlint lint
+        language: python
+        pass_filenames: false
+```
+
+## Offline use
+
+The language pack downloads parsers on first use. For CI or air-gapped runs, warm the cache in the image:
+
+```sh
+python -c "import tree_sitter_language_pack as t; t.download_all()"
+```