flowstate-app-aigateway Package Skill

Package: @epicdm/flowstate-app-aigateway Repository: epic-flowstate-apps Path: packages/flowstate-app-aigateway Version: 1.0.0

Use this published Dojo skill as the package-level entrypoint. For detailed workflows, use the package-local skills listed below.

Primary Package Workflow

AI Gateway Data Console

Status: Active Purpose: Keep gateway data and console pages synchronized. Scope: packages/flowstate-app-aigateway/src/data.ts and src/pages Trigger: Work changes data displayed by gateway pages or moves seed data to real services. Input: Target entity or page. Output: Updated data contracts, formatters, and page consumption.

Workflow

1. Locate the relevant interface in src/data.ts: WorkerUsage, ProviderRoute, BudgetRow, LedgerRow, PayloadAuditRow, or GatewayEvent.
2. Update helpers such as formatMoney, formatLatency, and statusTone if a new status or unit is introduced.
3. Trace page usage in src/pages/*Page.tsx; most pages import arrays and helpers directly from src/data.ts.
4. Keep ledger and payload audit records linkable. Payload IDs encode request/response kinds and refer back to ledgerId.
5. When replacing seed arrays with API-backed data, keep a narrow adapter that returns the existing interfaces before changing the UI.

Verification

• yarn workspace @epicdm/flowstate-app-aigateway typecheck
• Add tests for new status-to-tone or formatter logic when behavior branches are added.

Created: 2026-06-30

Package Skill Inventory

FlowState AI Gateway Skill Inventory

Reviewed: 2026-06-30

Skills

Review Notes

The package currently exposes typed seed data and display pages rather than collection mutations. Skills therefore focus on preserving contracts and page composition while integrating real gateway data later.

Review Gate

FlowState AI Gateway Skills Review

Reviewed: 2026-06-30 Status: Pass with seed-data caveat

Checks

• Skills identify src/data.ts as the current source of truth.
• Skills avoid claiming collection CRUD or persistence that is not present.
• Skills include verification commands available from package.json.

Residual Risk

The package has test: echo 'No tests yet'. Add tests around src/data.ts mapping helpers or page rendering before substantial behavior changes.

Start with this skill to understand the package purpose, then use the package-local focused skills for specific workflows. Keep this Dojo version aligned with packages/flowstate-app-aigateway/package.json. Do not treat generated feature lists as lessons; use workflow evidence from CODE-REVIEW.md, SKILL-INVENTORY.md, and REVIEW.md.