Sign in
atomic

flowstate-epic-flowstate-apps-epicdm-flowstate-app-data-browser

Package-local agent skill for @epicdm/flowstate-app-data-browser.

Tags

flowstatepackageepic-flowstate-apps

Publisher

Versions

1 version published — latest: 1.0.0

  • 1.0.0
    publishedInvalid Date

Skill

flowstate-app-data-browser Package Skill

Package: @epicdm/flowstate-app-data-browser Repository: epic-flowstate-apps Path: packages/flowstate-app-data-browser 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

Data Browser RxDB Services

Status: Active
Purpose: Preserve Data Browser data access across local and REST modes.
Scope: src/services/rxdb.ts, src/hooks/useRxDB.ts, collection pages, and document forms.
Trigger: A task changes connection mode, collection listing, query, pull, create, update, delete, or count behavior.
Input: Target operation and mode.
Output: Mode-aware service behavior with matching hooks.

Workflow

  1. Start in src/hooks/useRxDB.ts to understand mode selection from DataBrowserModeContext.
  2. For REST mode, edit RxDBService in src/services/rxdb.ts. Use getCollectionVersion(collection) for versioned REST endpoints.
  3. For local mode, edit LocalRxDBService; it operates against database.collections.
  4. Keep the hook result stable: { service, isConnected, error, mode, testConnection }.
  5. When adding collection operations, update both service classes or document why the operation only works in one mode.

REST Endpoint Patterns

OperationPattern
Query/${collection}-rest/${version}/query
Pull/${collection}/${version}/pull
Create/${collection}-rest/${version}/
Update/${collection}-rest/${version}/${id}
Delete/${collection}-rest/${version}/${id}

Verification

yarn workspace @epicdm/flowstate-app-data-browser typecheck
yarn workspace @epicdm/flowstate-app-data-browser build

For service changes, add tests or a small mocked-service exercise for both REST and local mode.

Package Skill Inventory

Skill Inventory: @epicdm/flowstate-app-data-browser

SkillTypeUse when
flowstate-app-data-browserOrchestratorWorking on Data Browser plugin, routes, pages, or deciding which data-browser subskill to load.
flowstate-app-data-browser-rxdb-servicesWorkflowChanging local/REST RxDB service access, collection querying, CRUD, or connection mode behavior.
flowstate-app-data-browser-schema-auditWorkflowChanging built-in schema audit, org seeding, duplicate cleanup, extra schema deletion, or dynamic schema forms.

Composition

Use the orchestrator for route and page tasks. Use RxDB services for data access or connection-mode changes. Use schema audit for built-in schema lifecycle and seeding behavior.

Review Gate

Review: @epicdm/flowstate-app-data-browser Skills

Status: Passed for local package use
Reviewed: 2026-06-30

Checks

CheckResult
Source-backedPassed. Skills reference route, service, hook, form, and audit files.
Not a generated feature listPassed. Skills explain local/REST modes and schema audit workflows.
ComposablePassed. Orchestrator separates service operations from audit/seeding.
Verification includedPassed. Package commands are documented.

Residual Risk

The service layer uses broad any types around RxDB documents and RJSF widget props. Future behavior changes should add focused tests around query/create/update/delete and schema audit computations.

Usage

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

Install

Run this in your project to install via CLI:

fscloud dojo skill install flowstate-epic-flowstate-apps-epicdm-flowstate-app-data-browser --target <target> --out ./skills

Replace <target> with your agent target identifier. See the CLI docs for details.