[roll] Roll fuchsia [tools][agents] Overhaul docs and add hooks guide

Overhaul documentation for the fx agents subsystem to accompany the
landing of Git staging and commit hook support, establishing a modular
docs/ directory for deep technical internals.

- docs/git_hooks.md: Add architecture and internals guide covering
  Jiri universal hook coexistence (.d/ dispatchers), staged partition
  isolation, StashGuard safe staged formatting, and console reporting.
- docs/permissions.md: Add reference guide covering 3-way set
  reconciliation math, regex expansion mechanics, multi-repo overlay
  discovery, and runtime rule evaluation precedence
  (Deny > Ask > Allow).
- DEVELOPMENT.md: Streamline developer guide to focus on contributor
  workflows, component responsibilities, and agents_testing fixtures
  (BaseTestCase, GitWorkspaceTestCase), delegating deep subsystem
  internals to docs/.
- README.md: Document Git hooks integration, opt-outs and bypasses,
  updated status output, and ad-hoc grant precedence with runtime
  decision flow.

Original-Original-Bug: 552580060
Test: fx test //tools/agents
Original-Original-Reviewed-on: https://fuchsia-review.googlesource.com/c/fuchsia/+/1820709
Original-Original-Revision: a03efff341f79d3db8f6277a2a0e7263613206e9
GitOrigin-RevId: 737f710a890e26bf126f746a45710712cc8f968b
Change-Id: Iec496431d43da254fb581b85936110374d3ff469
Reviewed-on: https://fuchsia-review.googlesource.com/c/integration/+/1821169
Cr-Commit-Position: refs/heads/main@{#201887}
1 file changed
tree: 60744f497db8de60294878eb1837010e5298b9a4
  1. ctf/
  2. git-hooks/
  3. infra/
  4. third_party/
  5. cobalt
  6. flower
  7. jiri.lock
  8. MILESTONE
  9. minimal
  10. prebuilts
  11. README.md
  12. stem
  13. test_durations
README.md

Integration

This repository contains Fuchsia's Global Integration manifest files.

Making changes

All changes should be made to the internal version of this repository. Our infrastructure automatically updates this version when the internal one changes.

Currently all changes must be made by a Google employee. Non-Google employees wishing to make a change can ask for assistance in one of the communication channels documented at get involved.

Obtaining the source

First install Jiri.

Next run:

$ jiri init
$ jiri import minimal https://fuchsia.googlesource.com/integration
$ jiri update

Third party

Third party projects should have their own subdirectory in ./third_party.