feat: headless auth and LLM docs artifacts (QL11, QL12, QL13) #10

Merged
coding-agent-marvin8 merged 0 commits from refs/pull/10/head into main 2026-05-26 06:15:50 +00:00
coding-agent-marvin8 commented 2026-05-26 04:13:06 +00:00 (Migrated from codeberg.org)

Closes #7, #8, #9.

Summary

  • QL11 (taibai init --token): adds --token TEXT to skip the browser OAuth flow. Token is validated via verify_credentials() before saving. TDD-covered in tests/test_init.py. Docs updated in docs/getting-started.md, README.md, CLAUDE.md.
  • QL12 (AGENTS.md): new agent-facing reference at repo root — headless auth, multi-profile model, --json output contract, credential storage, command reference table, exit codes.
  • QL13 (llms.txt / llms-full.txt): static docs artifacts served from the published site under not_in_nav. llms.txt is a terse command index; llms-full.txt is the full text of all 21 command pages.

Test plan

  • nox -s pytest — all 374+ tests pass (3 new tests in tests/test_init.py)
  • ruff format . && ruff check . && ty check . && complexipy . — all clean
  • taibai init --instance <instance> --token <valid-token> — succeeds without browser
  • taibai init --instance <instance> --token badtoken — exits 1 with clear error
  • mkdocs servellms.txt and llms-full.txt accessible at http://127.0.0.1:8000/llms.txt
  • AGENTS.md renders correctly in Codeberg UI
Closes #7, #8, #9. ## Summary - **QL11** (`taibai init --token`): adds `--token TEXT` to skip the browser OAuth flow. Token is validated via `verify_credentials()` before saving. TDD-covered in `tests/test_init.py`. Docs updated in `docs/getting-started.md`, `README.md`, `CLAUDE.md`. - **QL12** (`AGENTS.md`): new agent-facing reference at repo root — headless auth, multi-profile model, `--json` output contract, credential storage, command reference table, exit codes. - **QL13** (`llms.txt` / `llms-full.txt`): static docs artifacts served from the published site under `not_in_nav`. `llms.txt` is a terse command index; `llms-full.txt` is the full text of all 21 command pages. ## Test plan - [ ] `nox -s pytest` — all 374+ tests pass (3 new tests in `tests/test_init.py`) - [ ] `ruff format . && ruff check . && ty check . && complexipy .` — all clean - [ ] `taibai init --instance <instance> --token <valid-token>` — succeeds without browser - [ ] `taibai init --instance <instance> --token badtoken` — exits 1 with clear error - [ ] `mkdocs serve` — `llms.txt` and `llms-full.txt` accessible at `http://127.0.0.1:8000/llms.txt` - [ ] `AGENTS.md` renders correctly in Codeberg UI
Sign in to join this conversation.
No reviewers
No labels
No milestone
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
marvin8/taibai!10
No description provided.