fj/docs
Stephen Way e60a810c69
Some checks are pending
ci / check (push) Waiting to run
docs: sync README + CLAUDE.md + architecture.md with recent additions
* README: new commands (milestone, search code, watch/star, edit-comment,
  request-review) and the `--json-fields` / `--no-pager` globals.
* CLAUDE.md: layout includes json_filter and .forgejo/workflows; test
  count updated to 75; HTTP retry, JSON projection, pager-on-Unix
  conventions documented; setup-git hostname-validation invariant
  called out; auth token TTY guard noted.
* docs/architecture.md: HTTP retry section now covers 429 / Retry-After
  and Request::try_clone; new JSON projection section explains the
  global --json-fields flow; test strategy mentions remote CI and
  ignored env-mutating tests.
* docs/README.md: link to SECURITY.md and CHANGELOG.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-13 14:57:07 -07:00
..
architecture.md docs: sync README + CLAUDE.md + architecture.md with recent additions 2026-05-13 14:57:07 -07:00
faq.md bugs + agent-focused Forgejo gaps + CI + docs 2026-05-13 14:52:28 -07:00
gh-to-fj.md bugs + agent-focused Forgejo gaps + CI + docs 2026-05-13 14:52:28 -07:00
jq.md docs: CLAUDE.md, CONTRIBUTING.md, CHANGELOG.md, docs/ 2026-05-13 12:48:46 -07:00
README.md docs: sync README + CLAUDE.md + architecture.md with recent additions 2026-05-13 14:57:07 -07:00
troubleshooting.md docs: CLAUDE.md, CONTRIBUTING.md, CHANGELOG.md, docs/ 2026-05-13 12:48:46 -07:00

fj documentation

  • architecture.md — module graph, layering rules, the HTTP funnel, pager + SIGINT, repo resolution, test strategy.
  • jq.md — the fj api --jq syntax. Dot paths, brackets, negative indices, pipes.
  • gh-to-fj.md — command-by-command mapping from gh.
  • faq.md — common questions about tokens, hosts, debug, scripting, plugins.
  • troubleshooting.md — keychain prompts, hangs, 401 errors, --debug, pager opt-out, alias precedence, hook bypass.

For build/test workflow see ../CONTRIBUTING.md. For project conventions see ../CLAUDE.md. For security policy see ../SECURITY.md. For release notes see ../CHANGELOG.md.