fj/docs
Stephen Way d87a30bb29
docs: CLAUDE.md, CONTRIBUTING.md, CHANGELOG.md, docs/
* CLAUDE.md: project layout, key conventions, where to look first.
  Captures the non-obvious things a future session needs.
* CONTRIBUTING.md: build/test workflow, how to add a subcommand
  (concrete walkthrough), code style.
* CHANGELOG.md: history. 0.1.0 entry covers initial feature set;
  Unreleased captures stability + optimization batch.
* docs/architecture.md: module graph, layering rules, the HTTP funnel,
  pager + SIGINT, repo resolution, test strategy.
* docs/jq.md: --jq syntax cheatsheet (dot paths, brackets, negative
  indices, pipes, what's not supported).
* docs/troubleshooting.md: keychain re-prompts, debug logging, pager
  opt-out, alias precedence, hook bypass, common 401s.
* README.md: links into docs/ and updates binary size to 4 MB.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-13 12:48:46 -07:00
..
architecture.md docs: CLAUDE.md, CONTRIBUTING.md, CHANGELOG.md, docs/ 2026-05-13 12:48:46 -07:00
jq.md docs: CLAUDE.md, CONTRIBUTING.md, CHANGELOG.md, docs/ 2026-05-13 12:48:46 -07:00
README.md docs: CLAUDE.md, CONTRIBUTING.md, CHANGELOG.md, docs/ 2026-05-13 12:48:46 -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.
  • 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.