flowstate-app-marketplace Package Skill

Package: @epicdm/flowstate-app-marketplace Repository: epic-flowstate-community Path: packages/apps/flowstate-app-marketplace Version: 0.1.0

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

Primary Package Workflow

FlowState App Marketplace API

Use this skill when changing marketplace API calls or teaching an agent how to use them.

Start Here

Read:

• packages/apps/flowstate-app-marketplace/src/api/marketplace-api.ts
• packages/apps/flowstate-app-marketplace/src/api/MarketplaceApiProvider.tsx
• packages/apps/flowstate-app-marketplace/src/types.ts
• packages/apps/flowstate-app-marketplace/src/__tests__/marketplace-api.test.ts

API Client Contract

createMarketplaceApiClient() accepts:

• baseUrl
• optional fetch override for tests

The returned client supports:

• listing browse/filter/search
• listing detail
• version history
• install telemetry
• uninstall/update/view best-effort telemetry
• developer authenticated listing operations
• update checks for installed package versions

Request Rules

1. Use URLSearchParams for filter query construction.
2. Encode listing IDs in path segments with encodeURIComponent.
3. Add Authorization: Bearer <token> only through authenticated helper paths.
4. Throw on normal API request failures unless the operation is explicitly best-effort.
5. Preserve best-effort behavior for telemetry routes that are not guaranteed to exist upstream.
6. Preserve empty-list fallback for update checks when the gateway route is absent.

Provider Rules

MarketplaceApiProvider owns the client instance for React consumers. When changing provider shape, update consumers and tests together.

Verification

Run:

yarn workspace @epicdm/flowstate-app-marketplace test
yarn workspace @epicdm/flowstate-app-marketplace typecheck

Focus API test updates on request path, method, auth header, body, and fallback behavior.

Package Skill Inventory

@epicdm/flowstate-app-marketplace Skill Inventory

Skill Set

Coverage

The skill set covers:

• marketplace route tree
• plugin manifest and app-framework registration
• API client request/auth/fallback behavior
• browse/detail/developer/installed page responsibilities
• install telemetry and update behavior
• host integration boundaries for package install management

Out Of Scope

• Implementing upstream marketplace API routes.
• Rebuilding generated Dojo content.
• Changing package manager or desktop install bridge behavior.

Review Gate

@epicdm/flowstate-app-marketplace Skill Review

Review Verdict

Pass with follow-ups.

The local skills are source-backed and focus on practical agent operation across routes, API client behavior, and install/update workflows. Existing generated Dojo files remain prototype artifacts and should be regenerated from these package skills before publication.

Verification

Completed:

• ASCII and skill frontmatter checks passed.
• yarn workspace @epicdm/flowstate-app-marketplace test passed: 18 files, 152 tests, with expected Router future-flag warnings, test act(...) warnings, and best-effort telemetry debug output.
• yarn workspace @epicdm/flowstate-app-marketplace typecheck passed.
• yarn workspace @epicdm/flowstate-app-marketplace build passed.
• yarn nx build @epicdm/flowstate-app-marketplace passed with dependent tasks cached and existing Nx Cloud 401/unconnected-workspace notice.

Follow-Ups

• Decide whether root rebuild:apps should call build or this package should add a rebuild script.
• Verify route activation semantics for onRoute:/marketplace versus /apps/marketplace.
• Rebuild .flowstate/dojo content from reviewed package-local skills.

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/apps/flowstate-app-marketplace/package.json. Do not treat generated feature lists as lessons; use workflow evidence from CODE-REVIEW.md, SKILL-INVENTORY.md, and REVIEW.md.