Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
107 changes: 107 additions & 0 deletions .github/labels.yml
Original file line number Diff line number Diff line change
@@ -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"
34 changes: 34 additions & 0 deletions .github/workflows/labels.yml
Original file line number Diff line number Diff line change
@@ -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' }}
1 change: 1 addition & 0 deletions .rulesync/rules/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.
Expand Down
1 change: 1 addition & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.
Expand Down
1 change: 1 addition & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.
Expand Down
Loading