Files
gitea-axi/CLAUDE.md
alexion f9125e099d docs: correct bench/CLI login name and record bench test-config gotcha
The tea login store here holds `alexion` and `csv-reviewer`, not `axi`;
`selectLogin` matches `--login` by exact name, so `--login alexion` works and an
unknown `--login axi` fails with VALIDATION_ERROR — the prior note had this
backwards. Also record that bench/ unit tests run only under
vitest.bench.config.ts (plain `vitest run` matches test/** and finds none).
2026-07-18 23:25:32 -04:00

2.4 KiB

gitea-axi — Agent Instructions

Commits

Any commit message you write must follow the Conventional Commits specification as documented in CONVENTIONAL-COMMITS.md.

Gotchas

The origin remote is a self-hosted Gitea instance (git.alexion.dev), not GitHub. The gh CLI does not work here.

The benchmark arms invoke the built dist/main.js (the gitea-axi binary on PATH), not the TypeScript source. Run npm run build before any live bench:run if you want src/ changes reflected; the bench does not run from source.

Prefer this project's own CLI for pull requests — it is the tool being built, so opening its PRs with it is the dogfood path: npm run build && node dist/main.js pr create --login alexion --base main --head <branch> --title <text> --body-file <path>. It reuses the tea login store, which here holds exactly alexion and csv-reviewer — there is no axi profile. selectLogin matches the --login value against those names exactly, so --login alexion works and an unknown name like --login axi fails with VALIDATION_ERROR ("Login profile "axi" not found"). Fall back to tea pr create --login alexion --base main --head <branch> only for what gitea-axi cannot do yet; tea pr still lists PRs until pr list lands (task 0008).

The same login store backs the benchmark: npm run bench:run -- --arm <arm> --login alexion --task <id> (or set GITEA_AXI_BENCH_LOGIN=alexion).

The bench/ unit tests only run under their own Vitest project config: npx vitest run --config vitest.bench.config.ts bench/<file>.test.ts. Plain npx vitest run bench/<file>.test.ts reports "no tests" because the default vitest.config.ts includes only test/**.

Task branches are merged into main on the remote, so the local main goes stale. Always git fetch origin and cut a task branch from origin/main, not from whatever local main happens to point at.

Gitea's issue/PR search endpoint (GET /repos/issues/search, behind search issues/search prs) is backed by an asynchronous, eventually-consistent issue indexer (bleve by default). Content created moments earlier may not be searchable yet, so end-to-end assertions that create an issue/PR and then search for it must poll (e.g. expect.poll) until it is indexed rather than searching once. The fixture tier is unaffected — it stubs the endpoint — so this bites only the live test/e2e tier.