flowstate-epic-flowstate-apps-epicdm-flowstate-app-connectors
Package-local agent skill for @epicdm/flowstate-app-connectors.
Tags
Publisher
Versions
1 version published — latest: 0.1.0
- 0.1.0publishedInvalid Date
Skill
flowstate-app-connectors Package Skill
Package: @epicdm/flowstate-app-connectors
Repository: epic-flowstate-apps
Path: packages/flowstate-app-connectors
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
Connector Field Mappings
Status: Active
Purpose: Keep field mapping transforms predictable and easy to preview.
Scope: src/lib/transform-runner.ts, MappingEditor, and MappingTransformPreview.
Trigger: A task changes mapping validation, transform execution, or transform preview UI.
Input: Desired transform rule or mapping behavior.
Output: A validated mapping workflow with compatible preview behavior.
Transform Grammar
| Rule | Behavior |
|---|---|
markdown->plain | Strips common markdown formatting from string values. |
lookup:<col>.<field> | Calls optional ctx.lookup(collection, field, value) and returns its result. |
enum:<a->b, c->d> | Maps exact string values to replacements. |
| Unknown or blank | runTransform returns the original value. |
Workflow
- Update pure behavior in
src/lib/transform-runner.tsfirst. - Keep
runTransformforgiving for runtime data. Unknown rules should not corrupt values. - Put authoring errors in
validateMapping; it already checks required source/target fields and known transform prefixes. - Update
MappingTransformPreviewso agents and users can see the transform outcome before saving. - If mapping persistence changes, inspect
ConnectorClient.updateFieldMappings; current source notes that dedicated field mapping MCP tooling is not yet available.
Verification
yarn workspace @epicdm/flowstate-app-connectors typecheck
yarn workspace @epicdm/flowstate-app-connectors build
Add unit tests for new transform grammar because runTransform is pure and cheap to test.
Package Skill Inventory
Skill Inventory: @epicdm/flowstate-app-connectors
| Skill | Type | Use when |
|---|---|---|
flowstate-app-connectors | Orchestrator | Working on connector app entry points, routes, pages, or deciding which connector subskill to load. |
flowstate-app-connectors-mcp-client | Workflow | Adding or debugging connector MCP calls, OAuth connect flows, sync actions, auth, or scope propagation. |
flowstate-app-connectors-field-mappings | Reference | Changing mapping transforms, mapping validation, or preview behavior. |
Composition
Use the orchestrator for page-level tasks. Load the MCP client skill for any networked connector operation. Load the field mappings skill for transform grammar and validation details.
Review Gate
Review: @epicdm/flowstate-app-connectors Skills
Status: Passed for local package use
Reviewed: 2026-06-30
Checks
| Check | Result |
|---|---|
| Source-backed | Passed. Skills cite plugin, client, OAuth, and transform source files. |
| Not a generated feature list | Passed. Skills emphasize transport, scope, and transform workflows. |
| Composable | Passed. Orchestrator separates MCP transport from field mapping reference. |
| Verification included | Passed. Package commands are documented. |
Residual Risk
The package currently has placeholder tests. Connector client behavior should be covered with mocked fetch before changing JSON-RPC parsing or scope injection.
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-connectors/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-connectors --target <target> --out ./skillsReplace <target> with your agent target identifier. See the CLI docs for details.