diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index 2dae22c7e..9c99533db 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -1,7 +1,7 @@ --- name: Bug report about: Something in ycli (CLI / MCP / SDK / plugin) doesn't work as expected -labels: bug +labels: type:bug --- **Surface:** CLI / MCP server / Python SDK / Claude Code plugin diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md index e1df44e01..6035ade83 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.md +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -1,7 +1,7 @@ --- name: Feature request about: Suggest a service, endpoint, or improvement -labels: enhancement +labels: type:feature --- **Service / endpoint** diff --git a/.github/labels.yml b/.github/labels.yml new file mode 100644 index 000000000..abb71f062 --- /dev/null +++ b/.github/labels.yml @@ -0,0 +1,118 @@ +# from_name renames a label in place, so every issue keeps it. + +# What the owner has to do. +- name: "needs:decision" + color: "#e99695" + description: "Waiting for an owner decision" + from_name: "needs-decision" +- name: "needs:attention" + color: "#0e8a16" + description: "For the owner to read: defaults chosen, work done, risks; answer only to disagree" +- name: "needs:action" + color: "#fbca04" + description: "The owner has to do something outside the repository" + +# When. +- name: "priority:now" + color: "#b60205" + description: "Do now" +- name: "priority:next" + color: "#d93f0b" + description: "Do after the current work" +- name: "priority:later" + color: "#c5def5" + description: "Later, when there is room" + +# What kind of work. +- name: "type:bug" + color: "#d73a4a" + description: "Something isn't working" + from_name: "bug" +- name: "type:feature" + color: "#a2eeef" + description: "New feature or request" + from_name: "enhancement" +- name: "type:debt" + color: "#d4c5f9" + description: "Restructure or pay back debt without behaviour change" + from_name: "refactor" +- name: "type:security" + color: "#b60205" + description: "Secrets, credentials, personal data, release access" + from_name: "security" +- name: "type:docs" + color: "#0075ca" + description: "Improvements or additions to documentation" + from_name: "documentation" +- name: "type:research" + color: "#1d76db" + description: "An investigation whose result is a finding" + +# Which part of ycli. +- name: "scope:core" + color: "#1d76db" + description: "HTTP core, transport, auth, settings" + from_name: "area:core" +- name: "scope:cli" + color: "#5319e7" + description: "Typer CLI surface" + from_name: "area:cli" +- name: "scope:mcp" + color: "#0e8a16" + description: "MCP server surface" + from_name: "area:mcp" +- name: "scope:coverage" + color: "#fbca04" + description: "Wrapping Yandex API endpoints" + from_name: "area:coverage" +- name: "scope:ci" + color: "#c5def5" + description: "CI/CD and release automation" + from_name: "area:ci" +- name: "scope:distribution" + color: "#f9d0c4" + description: "Harness integrations and publishing" + from_name: "area:distribution" + +# A wayfinder map and its decision tickets. +- name: "wayfinder:map" + color: "#0e8a16" + description: "Wayfinder map: the route to one destination" +- name: "wayfinder:research" + color: "#1d76db" + description: "Wayfinder ticket: a fact a decision waits on" +- name: "wayfinder:grilling" + color: "#d93f0b" + description: "Wayfinder ticket: a decision settled in conversation with the owner" +- name: "wayfinder:prototype" + color: "#5319e7" + description: "Wayfinder ticket: a rough artefact to react to" +- name: "wayfinder:task" + color: "#fbca04" + description: "Wayfinder ticket: work that unblocks a decision" + +# Kept as they are: automation and GitHub's defaults. +- name: "api-drift" + color: "#d93f0b" + description: "Yandex changed an API that ycli wraps" +- name: "new-service" + color: "#bfd4f2" + description: "Adds a new Yandex business service" +- name: "duplicate" + color: "#cfd3d7" + description: "This issue or pull request already exists" +- name: "good first issue" + color: "#7057ff" + description: "Good for newcomers" +- name: "help wanted" + color: "#008672" + description: "Extra attention is needed" +- name: "invalid" + color: "#e4e669" + description: "This doesn't seem right" +- name: "question" + color: "#d876e3" + description: "Further information is requested" +- name: "wontfix" + color: "#ffffff" + description: "This will not be worked on" diff --git a/.github/workflows/labels.yml b/.github/workflows/labels.yml new file mode 100644 index 000000000..1b9029111 --- /dev/null +++ b/.github/workflows/labels.yml @@ -0,0 +1,34 @@ +name: labels + +# A pull request gets a dry run; labels missing from the file are left alone. +on: + push: + branches: [main] + paths: [".github/labels.yml", ".github/workflows/labels.yml"] + pull_request: + paths: [".github/labels.yml", ".github/workflows/labels.yml"] + workflow_dispatch: + +permissions: + contents: read + +concurrency: + group: labels-${{ github.ref }} + cancel-in-progress: true + +jobs: + sync: + runs-on: ubuntu-latest + timeout-minutes: 5 + permissions: + contents: read + issues: write + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + persist-credentials: false + - name: Apply .github/labels.yml + uses: crazy-max/ghaction-github-labeler@548a7c3603594ec17c819e1239f281a3b801ab4d # v6.0.0 + with: + skip-delete: true + dry-run: ${{ github.event_name == 'pull_request' }} diff --git a/.rulesync/rules/overview.md b/.rulesync/rules/overview.md index 25544d900..805977b6a 100644 --- a/.rulesync/rules/overview.md +++ b/.rulesync/rules/overview.md @@ -119,6 +119,7 @@ Claude Code **plugin** under `plugins/yandex-360/`. Published on PyPI as `yandex ## Working notes - **Drift log:** when a session reveals a convention the codebase doesn't yet enforce, capture it via `drifts:creating-drift-logs` before ending. +- **Issue labels:** `.github/labels.yml` is the only list of labels. Every issue an agent opens carries one `needs:*` when the owner has to act, at least one `scope:*`, one `priority:*` and one `type:*`; `wayfinder:*` belongs only to a map and its tickets. ## Architecture invariants (enforced) diff --git a/AGENTS.md b/AGENTS.md index 92d622a8f..2e7bf204c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -112,6 +112,7 @@ Claude Code **plugin** under `plugins/yandex-360/`. Published on PyPI as `yandex ## Working notes - **Drift log:** when a session reveals a convention the codebase doesn't yet enforce, capture it via `drifts:creating-drift-logs` before ending. +- **Issue labels:** `.github/labels.yml` is the only list of labels. Every issue an agent opens carries one `needs:*` when the owner has to act, at least one `scope:*`, one `priority:*` and one `type:*`; `wayfinder:*` belongs only to a map and its tickets. ## Architecture invariants (enforced) diff --git a/CLAUDE.md b/CLAUDE.md index 92d622a8f..2e7bf204c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -112,6 +112,7 @@ Claude Code **plugin** under `plugins/yandex-360/`. Published on PyPI as `yandex ## Working notes - **Drift log:** when a session reveals a convention the codebase doesn't yet enforce, capture it via `drifts:creating-drift-logs` before ending. +- **Issue labels:** `.github/labels.yml` is the only list of labels. Every issue an agent opens carries one `needs:*` when the owner has to act, at least one `scope:*`, one `priority:*` and one `type:*`; `wayfinder:*` belongs only to a map and its tickets. ## Architecture invariants (enforced)