fyi-oia-nz

FYI.org.nz OIA/LGOIMA

Scope

This skill wraps FYI.org.nz public authority/request read endpoints and the published all-authorities CSV. It is designed for public-corpus research and reproducible citations around OIA/LGOIMA requests.

Use this when

• You need NZ public authority discovery from FYI’s authority list
• You need authority detail for a specific FYI body URL slug
• You need request metadata for an ID or request/<id>-<slug>
• You need request event timelines (calculated_state/state transitions)
• You need simple request-text search across FYI pages as a discovery aid

Do not use this for

• Request drafting or posting
• Requester personal data extraction
• Bulk crawling of the search surface

Commands

• authorities [--tag <tag>] [--query <text>] [--limit N] [--json]

  • List public authorities from /body/all-authorities.csv, with optional tag/text filtering.

• categories [--limit N] [--json]

  • List body tags/categories discovered in all-authorities.csv.

• body <url_name_or_url> [--json]

  • Fetch authority metadata from /body/<url_name>.json.

• search <query> [--limit N] [--json]

  • Search FYI request pages for matching titles; uses /search/* endpoints where available and falls back to parsed request result HTML.

• request <id_or_slug> [--full] [--json]

  • Fetch request metadata from /request/<id>.json.
  • Metadata-only mode strips requester-identifying fields.
  • --full includes the full timeline with event/type fields and message IDs.

• events <id_or_slug> [--json]

  • Fetch and flatten request event timeline only.

Read-only contract

• No logins, tokens, keys, browser automation, or write operations.
• Defaults are metadata-first and remove requester personal text/name fields from command output.
• Uses only HTTPS GETs with conservative timeouts.

Resources

• scripts/cli.py
• scripts/smoke_test.py
• references/api-notes.md