beads/internal/workapi/doc.go
Julian Knutsen b1fe68e63a
ci(bazel): run pr.yml's repository guards as Bazel tests (#7329)
fast-checks, PR Policy, and the Linux leg of check-doc-freshness-platforms
ran repository guards on GitHub runners. They now run as Bazel tests in
bazel.yml's `test` lane (remote, cached), each over only the files it reads:

- tools/bazel/repo_subset.bzl picks a narrow, path-selected slice of
  //:repo_files at analysis time. scripts/repochecks/run_check.sh copies that
  slice into a throwaway git checkout and runs the unchanged guard there.
- //scripts/repochecks: build_tags, workflow_tags, go_install_guidance,
  winget_portable_alias, migration_hygiene (checks A and B),
  fmt (registered SDK gofmt), doc_freshness, workapi_frontend_boundary,
  types_gen_drift (`make api-check` drift, oapi-codegen from go.mod).
- //scripts:doc_freshness_required_test (integration lane, -required-suite)
  and //scripts/gitattributespolicy:gitattributespolicy_required_host_test
  cover the Linux doc-freshness leg.
- check-versions stays covered by //internal/versioncheck:versioncheck_test.
  check-testing-short stays covered by //scripts:scripts_test.

pr-policy-wrapper is deleted. fast-checks keeps only the two checks that
need the PR base: migration hygiene's delta half (MIGRATION_HYGIENE_SCOPE=
delta) and the .beads diff. check-doc-flags stays, because it builds bd from
the pinned release tag. The example Go modules leave .bazelignore so gofmt
and the grep guards see them. check_testcases.py now accepts --not-go
//pkg:all.

Refs: ga-96smfk.20

Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-07 00:59:18 +00:00

18 lines
1.1 KiB
Go

// Package workapi holds the work-query contract shared by every bd frontend.
//
// Filter construction, defaults, validation, and response shaping live here
// so the CLI and any other frontend answer the same question the same way
// instead of drifting through parallel copies. Storage sentinels are
// normalized on the way out for the same reason: a frontend should not have
// to know that the store seam reports a missing issue as storage.ErrNotFound
// while the domain seam reports it as a wrapped sql.ErrNoRows (see
// GetIssueOrWisp). The package therefore depends on neither frontend:
// it must not import github.com/spf13/cobra or net/http, and it must not read
// process-local state (client cwd, environment) that is meaningless in a
// long-lived server. internal/config is available only for workspace-scoped
// reads such as GetCustomTypesFromYAML.
//
// The boundary is enforced mechanically, not by review: see the
// workapi-frontend-boundary depguard rule in .golangci.yml and the
// banned-accessor check in scripts/check-workapi-frontend-boundary.sh.
package workapi