feat: expose Step Functions executions to automation

[YoungJinJung]

Summary

• Add unic resources step-function-executions --state-machine <arn> --json using the existing failure-first execution ordering.
• Expose the same read-only contract as list_step_function_executions over MCP with strict arguments and states:ListExecutions metadata.
• Return stable UTC timestamps and explicitly report the 200-execution cap through pagination metadata and warnings.

Related Issues

Refs #360

Validation

• go test ./internal/cli ./internal/mcp ./internal/services/aws -run "TestStepFunction|TestCatalogFeaturesHaveAgentSurfaceDecision|TestReadOnlyOperation|TestMCPCapabilities" -count=1
• make test
• make build
• git diff --check
• ./unic schema resources step-function-executions --json

Checklist

• Scope is focused
• Branch name follows docs/branch-naming-harness.md
• Documentation harness reviewed (docs/documentation-harness.md)
• README updated if user-facing behavior changed
• Relevant docs/ pages updated if architecture, auth, config, or workflow changed
• Tests/validation included
• Breaking changes documented (none)

[coderabbitai]

Warning

Review limit reached

Next included review available in 30 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 541efcd9-8ea2-4190-a309-263cdc107ef4

📥 Commits

Reviewing files that changed from the base of the PR and between 141d12e and f79d9cb.

📒 Files selected for processing (9)

• README.md
• docs/development.md
• internal/cli/resources.go
• internal/cli/resources_operations.go
• internal/cli/resources_operations_test.go
• internal/mcp/agent_surface_test.go
• internal/mcp/server.go
• internal/mcp/server_test.go
• skills/unic-aws/SKILL.md

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[amazon-q-developer]

This PR successfully exposes Step Functions executions through the CLI and MCP interface with consistent patterns and comprehensive test coverage. The implementation follows existing conventions for resource queries, properly handles error cases, and includes appropriate pagination warnings. The failure-first triage ordering and 200-execution limit are clearly documented and tested.

---

You can now have the agent implement changes and create commits directly on your pull request's source branch. Simply comment with /q followed by your request in natural language to ask the agent to make changes.

[YoungJinJung]

Reviewed head f79d9cb. I read the complete nine-file diff, tests, issue context, CI, prior reviews, comments, and inline discussion. The bounded 200-execution query, stable failure-first ordering, conservative cap signal, UTC serialization, CLI/MCP wiring, permissions, and documentation are aligned; no actionable concerns remain. Local validation passed: make test, make build, schema inspection, and git diff --check. Approval and merge remain for an independent reviewer because this GitHub identity authored the PR.

[youngjinjung-linq]

Reviewed head f79d9cb. I read the complete nine-file diff, tests, CI, issue context, prior reviews, comments, and inline discussion. The bounded Step Functions query, stable failure-first contract, conservative cap signal, UTC serialization, CLI/MCP wiring, permissions, and documentation are aligned; no actionable concerns remain. Local validation passed: targeted tests, make test, make build, schema inspection, and git diff --check.