yaga-cli 0.1.0__tar.gz

yaga_cli-0.1.0/.gitattributes

@@ -0,0 +1,2 @@
+# Downloaded shell scripts must remain executable by POSIX shells from any checkout.
+docs/install.sh text eol=lf

yaga_cli-0.1.0/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly

yaga_cli-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,172 @@
+name: CI
+run-name: >-
+  ${{ github.event_name == 'pull_request' &&
+  format('YAGA CI {0} for #{1} at base {2}', github.event.action,
+  github.event.pull_request.number, github.event.pull_request.base.sha) ||
+  format('CI {0} on {1}', github.event_name, github.ref_name) }}
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    name: Check
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
+          fetch-depth: 0
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+        with:
+          enable-cache: true
+          version: "0.12.7"
+      - name: Cache Typos registry
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: ~/.cargo/registry
+          key: yaga-typos-${{ runner.os }}-1.49.0
+          restore-keys: yaga-typos-${{ runner.os }}-
+      - name: Install Typos CLI
+        run: cargo install typos-cli --version 1.49.0 --locked
+      - run: uv sync --frozen --group dev --python 3.12
+      - run: uv run --frozen --python 3.12 ruff check .
+      - run: uv run --frozen --python 3.12 ruff format --check .
+      - run: uv run --frozen --python 3.12 ty check
+      - run: uv run --frozen --python 3.12 yaga --help
+      - run: uv run --frozen --python 3.12 python -m yaga --help
+      - run: |
+          yaga_message="$(printf '%s\n\n%s' \
+            'feat(ci): exercise the installed CLI' \
+            'Keep the installed command path covered by this CI smoke test.')"
+          uv run --frozen --python 3.12 yaga commit check --message "$yaga_message"
+      - name: Check pull-request branch name
+        if: github.event_name == 'pull_request'
+        env:
+          YAGA_BRANCH_NAME: ${{ github.head_ref }}
+        run: >-
+          uv run --frozen --python 3.12 yaga branch check
+          --policy .yaga/branch-policy.toml
+          --name "$YAGA_BRANCH_NAME"
+          --format github
+      - name: Check pushed branch name
+        if: >-
+          github.event_name == 'push' &&
+          github.ref_type == 'branch' &&
+          github.event.deleted == false
+        env:
+          YAGA_BRANCH_NAME: ${{ github.ref_name }}
+        run: >-
+          uv run --frozen --python 3.12 yaga branch check
+          --policy .yaga/branch-policy.toml
+          --name "$YAGA_BRANCH_NAME"
+          --format github
+      - name: Exercise the pre-commit provider
+        run: |
+          printf '%s\n' 'not conventional' > "$RUNNER_TEMP/YAGA_COMMIT_EDITMSG"
+          YAGA_PRE_COMMIT_STATUS=0
+          uv run --frozen --python 3.12 pre-commit try-repo . yaga-commit-check \
+            --hook-stage commit-msg \
+            --commit-msg-filename "$RUNNER_TEMP/YAGA_COMMIT_EDITMSG" \
+            > "$RUNNER_TEMP/yaga-pre-commit.log" 2>&1 || YAGA_PRE_COMMIT_STATUS=$?
+          cat "$RUNNER_TEMP/yaga-pre-commit.log"
+          test "$YAGA_PRE_COMMIT_STATUS" -eq 1
+          grep -F -- 'hook id: yaga-commit-check' "$RUNNER_TEMP/yaga-pre-commit.log"
+          grep -F -- 'exit code: 1' "$RUNNER_TEMP/yaga-pre-commit.log"
+          grep -F -- '[syntax.header]' "$RUNNER_TEMP/yaga-pre-commit.log"
+      - name: Run aggregate repository checks
+        env:
+          YAGA_REPOSITORY_REVISION: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
+        run: >-
+          uv run --frozen --python 3.12 yaga repo check
+          --plan .yaga/checks/ci.toml
+          --commit "$YAGA_REPOSITORY_REVISION"
+          --revision "$YAGA_REPOSITORY_REVISION"
+          --format github
+      - name: Run changed-path policy
+        env:
+          YAGA_CHANGE_BASE: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.sha || github.event.before }}
+          YAGA_CHANGE_HEAD: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
+          YAGA_CHANGE_SEPARATOR: ${{ github.event_name == 'pull_request' && '...' || '..' }}
+        run: >-
+          uv run --frozen --python 3.12 yaga change check
+          --policy .yaga/change-policy.toml
+          --range "${YAGA_CHANGE_BASE}${YAGA_CHANGE_SEPARATOR}${YAGA_CHANGE_HEAD}"
+          --format github
+      - name: Exercise the cached actionlint integration
+        run: >-
+          uv run --frozen --python 3.12 pytest -q
+          tests/test_workflow_lint.py tests/test_workflow_lint_hardening.py
+      - run: bash -n scripts/composite_smoke_python
+      - run: uv run --frozen --python 3.12 python scripts/check_build.py
+      - name: Build documentation
+        run: |
+          uv run --frozen --python 3.12 zensical build --strict --clean
+          uv run --frozen --python 3.12 python scripts/check_docs.py
+      - name: Install the composite smoke interpreter
+        run: |
+          install -D --mode=0755 \
+            scripts/composite_smoke_python \
+            "$RUNNER_TEMP/yaga-smoke-bin/python"
+          echo "$RUNNER_TEMP/yaga-smoke-bin" >> "$GITHUB_PATH"
+      - name: Exercise the composite action manifest and wiring
+        id: action_smoke
+        uses: ./
+        with:
+          gate: agent-review
+          operation: invalidate
+          github-token: not-used
+          owner-id: "15094983"
+          job-timeout-minutes: 15
+      - name: Require the composite smoke outcome
+        env:
+          ACTION_OUTCOME: ${{ steps.action_smoke.outcome }}
+        run: |
+          test "$ACTION_OUTCOME" = success
+
+  test:
+    name: Python ${{ matrix.python-version }} on ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+        os: [ubuntu-latest]
+        include:
+          - python-version: "3.12"
+            os: windows-latest
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+        with:
+          enable-cache: true
+          version: "0.12.7"
+      - run: uv sync --frozen --group dev --python ${{ matrix.python-version }}
+      - run: uv run --frozen --python ${{ matrix.python-version }} pytest
+
+  gate:
+    name: CI Prerequisites
+    if: always()
+    needs: [check, test]
+    runs-on: ubuntu-latest
+    timeout-minutes: 1
+    steps:
+      - name: Require the complete blocking matrix
+        env:
+          CHECK_RESULT: ${{ needs.check.result }}
+          TEST_RESULT: ${{ needs.test.result }}
+        run: |
+          set -euo pipefail
+          [[ "$CHECK_RESULT" == success ]]
+          [[ "$TEST_RESULT" == success ]]

yaga_cli-0.1.0/.github/workflows/commit-policy.yml

@@ -0,0 +1,35 @@
+name: Commit Policy
+run-name: >-
+  Commit policy ${{ github.event.action }} for #${{ github.event.pull_request.number }}
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, edited, ready_for_review]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: yaga-commit-policy-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  commit-policy:
+    name: Commit Messages
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+          fetch-depth: 0
+          persist-credentials: false
+      - name: Cache Typos registry
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: ~/.cargo/registry
+          key: yaga-typos-${{ runner.os }}-1.49.0
+          restore-keys: yaga-typos-${{ runner.os }}-
+      - name: Install Typos CLI
+        run: cargo install typos-cli --version 1.49.0 --locked
+      - uses: ./actions/commit-check

yaga_cli-0.1.0/.github/workflows/commit-quality.yml

@@ -0,0 +1,98 @@
+name: Commit Quality
+run-name: >-
+  Commit quality ${{ github.event_name }} on ${{ github.ref_name }}
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: commit-quality-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+env:
+  HF_HOME: ${{ github.workspace }}/.yaga-huggingface
+  YAGA_QUALITY_TASK: classification
+  YAGA_QUALITY_MODEL_ID: saridormi/commit-message-quality-codebert
+  YAGA_QUALITY_MODEL_REVISION: 30c7895b3eb0270a3246ef3db7b43c837d8e553a
+  YAGA_QUALITY_BASE_SHA: ${{ github.event.pull_request.base.sha || '' }}
+  YAGA_QUALITY_HEAD_SHA: ${{ github.event.pull_request.head.sha || github.sha }}
+
+jobs:
+  quality:
+    name: Hugging Face commit quality
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
+          fetch-depth: 0
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+        with:
+          enable-cache: true
+          version: "0.12.7"
+      - id: model-cache
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: ${{ github.workspace }}/.yaga-huggingface
+          key: yaga-quality-${{ runner.os }}-python3.12-${{ env.YAGA_QUALITY_TASK }}-${{ env.YAGA_QUALITY_MODEL_ID }}-${{ env.YAGA_QUALITY_MODEL_REVISION }}
+      - run: uv sync --frozen --group dev --extra quality --python 3.12
+      - name: Populate cache and prove offline reuse
+        shell: bash
+        run: |
+          set -euo pipefail
+          if [[ "$GITHUB_EVENT_NAME" == pull_request ]]; then
+            source_arguments=(--range "$YAGA_QUALITY_BASE_SHA..$YAGA_QUALITY_HEAD_SHA")
+          else
+            source_arguments=(--commit "$YAGA_QUALITY_HEAD_SHA")
+          fi
+          online_status=0
+          online_report="$(uv run --frozen --python 3.12 yaga commit quality \
+            "${source_arguments[@]}" \
+            --provider huggingface \
+            --task "$YAGA_QUALITY_TASK" \
+            --model "$YAGA_QUALITY_MODEL_ID" \
+            --input-mode message \
+            --revision "$YAGA_QUALITY_MODEL_REVISION" \
+            --format github 2>&1)" || online_status=$?
+          printf '%s\n' "$online_report"
+          {
+            printf '%s\n' '### YAGA commit quality (online)'
+            printf '%s\n' 'Model cache hit: ${{ steps.model-cache.outputs.cache-hit }}'
+            printf '%s\n' '<pre>'
+            printf '%s\n' "$online_report" | sed 's/&/\&amp;/g; s/</\&lt;/g; s/>/\&gt;/g'
+            printf '%s\n' '</pre>'
+          } >> "$GITHUB_STEP_SUMMARY"
+          offline_status=0
+          offline_report="$(uv run --frozen --python 3.12 yaga commit quality \
+            "${source_arguments[@]}" \
+            --provider huggingface \
+            --task "$YAGA_QUALITY_TASK" \
+            --model "$YAGA_QUALITY_MODEL_ID" \
+            --input-mode message \
+            --revision "$YAGA_QUALITY_MODEL_REVISION" \
+            --offline \
+            --format github 2>&1)" || offline_status=$?
+          printf '%s\n' "$offline_report"
+          {
+            printf '%s\n' '### YAGA commit quality (offline replay)'
+            printf '%s\n' '<pre>'
+            printf '%s\n' "$offline_report" | sed 's/&/\&amp;/g; s/</\&lt;/g; s/>/\&gt;/g'
+            printf '%s\n' '</pre>'
+          } >> "$GITHUB_STEP_SUMMARY"
+          for status in "$online_status" "$offline_status"; do
+            case "$status" in
+              0|1) ;;
+              *) exit 2 ;;
+            esac
+          done
+          if [[ "$online_status" -eq 1 || "$offline_status" -eq 1 ]]; then
+            exit 1
+          fi
+          exit 0

yaga_cli-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,44 @@
+name: Documentation
+run-name: >-
+  Documentation ${{ github.event_name }} on ${{ github.ref_name }}
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    name: Publish
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6
+      - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+        with:
+          version: "0.12.7"
+      - run: uv sync --frozen --group dev --python 3.12
+      - run: uv run --frozen --python 3.12 zensical build --strict --clean
+      - run: uv run --frozen --python 3.12 python scripts/check_docs.py
+      - uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5
+        with:
+          path: site
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@368f82528645a54fb793d4d04e342629a3f51346 # v5

yaga_cli-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,72 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: yaga-release
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Validate and build
+    if: >-
+      github.event_name == 'push' ||
+      github.ref == format('refs/heads/{0}', github.event.repository.default_branch)
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+      - name: Require source on the default branch
+        env:
+          DEFAULT_BRANCH: ${{ github.event.repository.default_branch }}
+          EVENT_SHA: ${{ github.sha }}
+        run: |
+          test "$(git rev-parse HEAD)" = "$EVENT_SHA"
+          git merge-base --is-ancestor HEAD "refs/remotes/origin/$DEFAULT_BRANCH"
+      - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+        with:
+          version: "0.12.7"
+          enable-cache: false
+      - run: uv sync --frozen --group dev --python 3.12
+      - name: Validate production version and release notes
+        if: github.event_name == 'push'
+        env:
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: uv run --frozen python scripts/check_release.py "$RELEASE_TAG"
+      - name: Install pinned Typos CLI
+        run: cargo install typos-cli --version 1.49.0 --locked
+      - name: Run the full gate and retain its validated distributions
+        run: uv run --frozen make ci BUILD_ARGS="--output-dir dist"
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: distributions
+          path: dist/
+          if-no-files-found: error
+          retention-days: 7
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    environment:
+      name: pypi
+      url: https://pypi.org/p/yaga-cli
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: distributions
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2

yaga_cli-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+.pytest_cache/
+.ruff_cache/
+.venv/
+*.py[cod]
+.coverage
+*.egg-info/
+dist/
+htmlcov/
+site/

yaga_cli-0.1.0/.pre-commit-hooks.yaml

@@ -0,0 +1,8 @@
+- id: yaga-commit-check
+  name: YAGA commit check
+  description: Validate the pending commit message with repository-local YAGA policy.
+  entry: yaga commit check --file
+  language: python
+  stages: [commit-msg]
+  pass_filenames: true
+  minimum_pre_commit_version: "3.2.0"

yaga_cli-0.1.0/.yaga/branch-policy.toml

@@ -0,0 +1,7 @@
+branch-policy-version = 1
+allowed-patterns = [
+  "main",
+  "feat/*",
+  "fix/*",
+  "dependabot/*/**",
+]

yaga_cli-0.1.0/.yaga/change-policy.toml

@@ -0,0 +1,6 @@
+change-policy-version = 1
+
+[[rules]]
+name = "python-source-needs-tests"
+when-any = ["src/**/*.py"]
+require-any = ["tests/**/*.py"]

yaga_cli-0.1.0/.yaga/checks/ci.toml

@@ -0,0 +1,17 @@
+plan-version = 2
+checks = [
+  "commit",
+  "workflow",
+  "workflow-security",
+  "workflow-lint",
+  "mode",
+  "path",
+  "size",
+  "tree",
+]
+workflow-paths = [".github/workflows", "examples"]
+workflow-security-profile = "recommended-v3"
+mode-policy = ".yaga/mode-policy.toml"
+path-policy = ".yaga/path-policy.toml"
+size-policy = ".yaga/size-policy.toml"
+tree-policy = ".yaga/tree-policy.toml"

yaga_cli-0.1.0/.yaga/mode-policy.toml

@@ -0,0 +1,2 @@
+mode-policy-version = 1
+default-allowed-modes = ["regular"]

yaga_cli-0.1.0/.yaga/path-policy.toml

@@ -0,0 +1,2 @@
+path-policy-version = 1
+profile = "windows-compatible-v1"

yaga_cli-0.1.0/.yaga/size-policy.toml

@@ -0,0 +1,12 @@
+size-policy-version = 1
+default-max-blob-bytes = 131072
+max-total-blob-bytes = 8388608
+
+[[path-limits]]
+pattern = "uv.lock"
+max-blob-bytes = 1048576
+
+# Preserve original branding PNGs and the transparent web logo.
+[[path-limits]]
+pattern = "docs/assets/branding/*.png"
+max-blob-bytes = 2097152

yaga_cli-0.1.0/.yaga/tree-policy.toml

@@ -0,0 +1,27 @@
+tree-policy-version = 1
+required-paths = [
+  ".yaga/mode-policy.toml",
+  ".yaga/path-policy.toml",
+  ".yaga/size-policy.toml",
+  ".yaga/tree-policy.toml",
+  "LICENSE",
+  "README.md",
+  "SECURITY.md",
+  "pyproject.toml",
+  "uv.lock",
+]
+forbidden-patterns = [
+  "**/.env",
+  "**/__pycache__/**",
+  "**/.mypy_cache/**",
+  "**/.pytest_cache/**",
+  "**/.ruff_cache/**",
+  "**/.tox/**",
+  "**/.venv/**",
+  "**/*.pyc",
+  "**/*.pyo",
+  "build/**",
+  "dist/**",
+  "htmlcov/**",
+  "**/.coverage",
+]