diff --git a/.github/labels.yml b/.github/labels.yml new file mode 100644 index 0000000..e27cb8a --- /dev/null +++ b/.github/labels.yml @@ -0,0 +1,107 @@ +# 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" +- 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" +- name: "type:security" + color: "#b60205" + description: "Secrets, credentials, personal data, release access" +- 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 refract. +- name: "scope:spec" + color: "#1d76db" + description: "Loading and validating the YAML spec" +- name: "scope:ir" + color: "#5319e7" + description: "The typed intermediate representation" +- name: "scope:emitters" + color: "#0e8a16" + description: "Backends that write code for a language" +- name: "scope:runtime" + color: "#fbca04" + description: "What generated code imports at run time" +- name: "scope:cli" + color: "#f9d0c4" + description: "The refract command" +- name: "scope:ci" + color: "#c5def5" + description: "CI/CD and release automation" + +# 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: release-please writes the autorelease labels. +- name: "autorelease: pending" + color: "#ededed" +- name: "autorelease: tagged" + color: "#ededed" +- 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 0000000..3923cf7 --- /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@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0 + 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 e97b975..d28c9a7 100644 --- a/.rulesync/rules/overview.md +++ b/.rulesync/rules/overview.md @@ -27,6 +27,7 @@ Baseline agent discipline comes from the `core` and `drifts` plugins of the `bim ## Conventions - Python >= 3.12; `uv` only (`uv sync`, `uv run`), with `uv.lock` and the `dev` dependency group in `pyproject.toml`. +- **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. - ruff is both linter and formatter (`line-length = 100`, an explicit `select` list); `ty` is the type checker, configured with `error-on-warning = true`. - `examples/` is excluded from ruff and from ty on purpose: it is external source used as a byte-equality target, so linting or reformatting it defeats the test it exists for. - pytest runs with `--cov-fail-under=100` and `-m 'not behavioral'`; run the slow tests explicitly with `uv run pytest -m behavioral`. diff --git a/AGENTS.md b/AGENTS.md index 79a04b3..5d6d23d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -20,6 +20,7 @@ Baseline agent discipline comes from the `core` and `drifts` plugins of the `bim ## Conventions - Python >= 3.12; `uv` only (`uv sync`, `uv run`), with `uv.lock` and the `dev` dependency group in `pyproject.toml`. +- **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. - ruff is both linter and formatter (`line-length = 100`, an explicit `select` list); `ty` is the type checker, configured with `error-on-warning = true`. - `examples/` is excluded from ruff and from ty on purpose: it is external source used as a byte-equality target, so linting or reformatting it defeats the test it exists for. - pytest runs with `--cov-fail-under=100` and `-m 'not behavioral'`; run the slow tests explicitly with `uv run pytest -m behavioral`. diff --git a/CLAUDE.md b/CLAUDE.md index 79a04b3..5d6d23d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -20,6 +20,7 @@ Baseline agent discipline comes from the `core` and `drifts` plugins of the `bim ## Conventions - Python >= 3.12; `uv` only (`uv sync`, `uv run`), with `uv.lock` and the `dev` dependency group in `pyproject.toml`. +- **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. - ruff is both linter and formatter (`line-length = 100`, an explicit `select` list); `ty` is the type checker, configured with `error-on-warning = true`. - `examples/` is excluded from ruff and from ty on purpose: it is external source used as a byte-equality target, so linting or reformatting it defeats the test it exists for. - pytest runs with `--cov-fail-under=100` and `-m 'not behavioral'`; run the slow tests explicitly with `uv run pytest -m behavioral`.