feat: complete issue list filters, sort, and fields (task 0002)

Finish the `issue list` flag surface left minimal by the tracer slice:

- Server-side filters `--label`, `--assignee`, `--author`, `--milestone`,
  mapped to Gitea's `labels`, `assigned_by`, `created_by`, `milestones`.
- Client-side `--sort <created|updated|comments>`, always descending, over
  the fully paginated set (ADR 0005); `--limit` caps the sorted result.
- `--fields` exposing body, closedAt, labels, milestone, updatedAt, url.
- `--search` refused with a VALIDATION_ERROR redirecting to `search issues`.

Exhaustive pagination lands as a shared `paginate.ts`, since ADR 0005 makes
it a policy later slices reuse; `lookup.ts` drops its hand-rolled copy of the
same loop. The helper carries the 20-page cap that copy encoded, matching the
1000-item ceiling Principle 8 sets.
This commit is contained in:
2026-07-11 23:05:47 -04:00
parent 12a7baa378
commit 348f28a54d
7 changed files with 649 additions and 55 deletions

View File

@@ -2,36 +2,23 @@ import type { Label } from "gitea-js";
import type { GiteaClient } from "./client.js";
import type { RepoContext } from "./context.js";
import { axiError, classifyHttpError } from "./errors.js";
import { fetchAllPages } from "./paginate.js";
/**
* Name→ID resolution for the Gitea endpoints that only accept numeric ids.
* Shared by every command that takes a `--label` or `--milestone` name.
*/
const LABEL_PAGE_SIZE = 50;
/** Guard against an unbounded loop if a server ignores paging and always returns a full page. */
const LABEL_PAGE_LIMIT = 20;
/** Fetch every label in the repository, paging until the API runs out. */
async function listAllLabels(api: GiteaClient, context: RepoContext): Promise<Label[]> {
const labels: Label[] = [];
for (let page = 1; page <= LABEL_PAGE_LIMIT; page++) {
let batch: Label[];
try {
const response = await api.repos.issueListLabels(context.owner, context.name, {
page,
limit: LABEL_PAGE_SIZE,
});
batch = response.data ?? [];
} catch (error) {
throw classifyHttpError(error);
}
labels.push(...batch);
if (batch.length < LABEL_PAGE_SIZE) {
break;
}
try {
const { items } = await fetchAllPages<Label>((page, limit) =>
api.repos.issueListLabels(context.owner, context.name, { page, limit }),
);
return items;
} catch (error) {
throw classifyHttpError(error);
}
return labels;
}
/**