docs: Add deprecated docstrings to all legacy FGA methods

[atainter]

No description provided.

[greptile-apps]

Greptile Summary

This PR adds method-level @deprecated JSDoc annotations to all 12 methods of the FGA class in src/fga/fga.ts, complementing the already-existing class-level deprecation notice. This is a documentation-only change with no logic modifications.

• All 12 FGA methods now carry a @deprecated tag and a @see src/authorization/authorization.ts reference, consistent with the class-level annotation that was already present.
• 6 of the 12 deprecated methods (checkBatch, writeWarrant, batchWriteWarrants, listWarrants, query, batchWriteResources) have no direct equivalent in the Authorization module, so the uniform @see reference alone may not provide sufficient migration guidance for users of those methods.
• No functional code is modified; the change is purely additive documentation.

Confidence Score: 5/5

Safe to merge — this is a documentation-only change with no logic modifications.

All 12 FGA methods are correctly annotated with @deprecated and no methods were missed. The sole observation is a P2 style suggestion about the @see reference being potentially insufficient for the 6 methods with no Authorization equivalent. P2 findings do not block merge.

No files require special attention.

Important Files Changed

Filename	Overview
src/fga/fga.ts	Adds @deprecated JSDoc annotations to all 12 FGA methods; all methods are covered, though the uniform @see reference may not guide users of the 6 methods with no Authorization equivalent

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Developer calls FGA method] --> B{Direct equivalent in\nAuthorization module?}
    B -- Yes --> C["check / createResource / getResource\nlistResources / updateResource / deleteResource"]
    B -- No --> D["checkBatch / writeWarrant / batchWriteWarrants\nlistWarrants / query / batchWriteResources"]
    C --> E[Migrate to Authorization module\nsrc/authorization/authorization.ts]
    D --> F[No direct equivalent —\nmigration guide needed]

Loading

_{Reviews (1): Last reviewed commit: "Add deprecated docstrings to all legacy ..." | Re-trigger Greptile}

[greptile-apps]

@see reference may be insufficient for some FGA methods

The @see src/authorization/authorization.ts annotation is applied uniformly to all 12 methods, but 6 of them — checkBatch, writeWarrant, batchWriteWarrants, listWarrants, query, and batchWriteResources — have no direct equivalent in the Authorization module. Developers trying to migrate those calls will find no corresponding method to switch to.

Consider supplementing the @see tag with a link to an external migration guide or changelog entry that covers every FGA method, not only those that map cleanly into Authorization.