Add GET /api/v1/settlements/:id/audit filtering audit log entries by settlement id

[Jagadeeshftw]

📌 Description

GET /api/v1/audit returns the last 200 mutating requests globally per the README, but support/debugging a single settlement's lifecycle (open -> execute/cancel) currently requires manually scanning that global list for matching paths containing the id.

🧩 Requirements and context

• Add GET /api/v1/settlements/:id/audit returning only audit entries whose path references that settlement id.
• Return 404 if the settlement id doesn't exist (consistent with GET /api/v1/settlements/:id); an empty array if it exists but has no audit entries (e.g. entries aged out of the ring buffer).
• Reuse the existing in-memory audit store from middleware/auditLog.ts — no new storage needed.

🛠️ Suggested execution

• Add the route in src/routes/settlements.ts, filtering the shared audit history by path pattern.
• Add tests in routes/settlements.test.ts for found/not-found settlement ids and the filtered result shape.
• Document in src/openapi.ts and the README.

✅ Acceptance criteria

• Endpoint returns only audit entries relevant to the given settlement id.
• 404 for an unknown settlement id.
• Documented in OpenAPI spec and README.

🔒 Security notes

No new attack surface; read-only view filtered from data already exposed by GET /api/v1/audit.

📋 Guidelines

• Minimum 95% test coverage
• Clear documentation
• Timeframe: 96 hours

[GazzyLee]

I'd like to work on this. I'll add a GET /api/v1/settlements/:id/audit endpoint that reuses the existing in-memory audit log to return only entries related to the specified settlement. I'll ensure it returns 404 for unknown settlement IDs, an empty array when no audit entries exist, add comprehensive route tests for the different scenarios, and update both the OpenAPI spec and README to document the new endpoint.
Please assign

[GBOYEE]

Hello! I'd love to pick this one up (Add GET /api/v1/settlements/:id/audit filtering audit log entries b...). I'll implement the helper and integrate it. Happy to submit a PR for this once the bot assigns it.

[grantfox-oss]

🦊 GrantFox — @GazzyLee has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #102)
2. Your PR will be reviewed by the AnchorNet-Org maintainers

Good luck! Track your progress on GrantFox.