Theme
Aa
← man.tcos.us gopher root · man.tcos.us
lu: · ·
HEE-BOARD(1)                       HEE Tools                       HEE-BOARD(1)

NAME
       hee-board - real, 0-token curated filtered views over the TCOS Roadmap

SYNOPSIS
              hee-board [-h] {p0,off-project,open-prs,stale,outsiders} ...
                hee-board p0                 -- P0 items across every repo
                hee-board unassigned-epics   -- real Epics with no sub-issues linked
                hee-board off-project        -- open issues not yet on the Project board
                hee-board stale --days N     -- items with no update in N days (default 30)
                hee-board open-prs           -- every real open PR org-wide, via `gh search
                                                 prs` (not the Project board -- most open
                                                 PRs, esp. Dependabot ones, are never added
                                                 to it, so board-scoped commands above would
                                                 silently miss almost all of them)
                hee-board outsiders --roster FILE [--days N] [--allow-bot LOGIN]... [--markdown FILE]
                                             -- PRs and issues filed by accounts outside the
                                                 roster: every open one, plus any created in
                                                 the last N days (default 7), in every
                                                 non-archived org repo

              outsiders:
                "Us" is every GitHub login in the roster file (roster.json: tiers[].people[].github).
                A roster login whose status is departed or inactive still counts as a finding:
                the roster says that account holds no access. Bots are listed separately;
                dependabot[bot] and github-actions[bot] are expected, --allow-bot adds more.

                Severity, per item:
                  CRITICAL  an account outside the roster filed on a PRIVATE repo -- it can
                            read that repo, so access is wider than the roster says
                  WARNING   an account outside the roster, an unexpected bot, or a roster
                            account marked departed or inactive, filed on a public repo
                  UNKNOWN   a repo whose issues could not be read (token scope, rate limit)
                  OK        nothing filed from outside the roster
                Exit code is the worst of these, in that order: 2, 1, 3, 0.

              positional arguments:
                {p0,off-project,open-prs,stale,outsiders}

              options:
                -h, --help            show this help message and exit

DESCRIPTION
              project, since GitHub Projects v2 has no view-creation mutation in its
              GraphQL schema (confirmed live, 2026-08-24: zero ProjectV2View fields in
              the mutation type) -- UI-only, can't be built once and reused by a
              script. This is the functional equivalent: one real item-list fetch,
              then curated slices printed as plain text. 0-token by design -- pure
              deterministic filtering, no LLM call.

EXAMPLES
              hee board p0
              hee board open-prs

              Not marked "# ci": every view queries GitHub (issues, PRs, the project
              board) over the API, which a runner cannot reach deterministically.

                                                                   HEE-BOARD(1)