flowstate-url-builder Package Skill

Package: @epicdm/flowstate-url-builder Repository: epic-flowstate-community Path: packages/flowstate-url-builder Version: 1.0.7

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

Primary Package Workflow

FlowState URL Builder Consumer Integration

Status: Active Purpose: Prevent URL builder changes from breaking packages that depend on gateway URL construction. Scope: Consumers of @epicdm/flowstate-url-builder in the community repo. Trigger: Public export, default URL, route prefix, path-stripping behavior, or method output may change. Input: Proposed URL builder change and affected route/method. Output: Compatibility-aware implementation with downstream checks.

Known Consumers

Check:

• packages/flowstate-app-framework/src/services/FlowstateAuthService.ts
• packages/flowstate-cli/src/cli/utils/httpRxDBClient.ts
• packages/flowstate-mcp/package.json
• packages/flowstate-app-framework/package.json
• packages/flowstate-cli/package.json
• docker/Dockerfile.base
• gateway-route planning/docs that mention @epicdm/flowstate-url-builder

Compatibility Workflow

1. Name the method or export that changed.
2. Search usage:

rg "@epicdm/flowstate-url-builder|createServiceUrlBuilder|ServiceUrlBuilder|getAuthUrl|getRxdbRestUrl|getMcpUrl|getObsUrl|getAmsUrl|getOAuthDiscoveryUrl" packages docker docs

3. Update tests in this package.
4. Run typecheck for affected TypeScript consumers if public signatures changed.
5. Update README and docs only after source and tests agree.

Verification

Minimum package gate:

yarn workspace @epicdm/flowstate-url-builder test --runInBand --no-cache
yarn workspace @epicdm/flowstate-url-builder typecheck
yarn workspace @epicdm/flowstate-url-builder build

Consumer gates when signatures or auth/RxDB URLs change:

yarn workspace @epicdm/flowstate-app-framework typecheck
yarn workspace @epicdm/flowstate-cli typecheck

Composition Notes

• Use flowstate-url-builder-kong-routing before this skill to understand route behavior.
• Pair with gateway route skills when the actual Kong routing table changes.

Created: 2026-06-29

Package Skill Inventory

@epicdm/flowstate-url-builder Skill Inventory

Repository: epic-flowstate-community Package path: packages/flowstate-url-builder Package: @epicdm/flowstate-url-builder Inventory date: 2026-06-29

Skill Map

Composition

Start with flowstate-url-builder, then use:

• flowstate-url-builder-kong-routing for route/method behavior.
• flowstate-url-builder-consumer-integration before changing public URLs or exports.
• flowstate-url-builder-maintenance for docs, generated Dojo cleanup, and package verification.

Not Created

• No separate skill per method. The important distinction is preserved versus stripped Kong routes.
• No generic Kong skill. This package's job is specific URL construction, not gateway administration.

Review Gate

@epicdm/flowstate-url-builder Skills Review

Review date: 2026-06-29 Verdict: Pass for local package-skill coverage; Dojo publication deferred until generated Dojo files are rebuilt from reviewed skills.

Coverage Check

• Package purpose, exports, and commands are covered in flowstate-url-builder.
• Preserved and stripped path behavior is covered in flowstate-url-builder-kong-routing.
• Downstream package impact is covered in flowstate-url-builder-consumer-integration.
• Docs, feature matrix, generated Dojo, and verification upkeep are covered in flowstate-url-builder-maintenance.

Quality Notes

• Skills teach route-selection behavior instead of restating the two feature-matrix entries.
• Skills call out deprecated getRxdbReplicationUrl() while preserving its current public/tested behavior.
• Skills treat existing .flowstate/feature-matrix artifacts as authoritative local inventory surfaces, not files to duplicate elsewhere.
• Review captures version drift between package.json 1.0.7 and older 1.0.4 FlowState artifacts.
• Review captures the mismatch between legacy six-capability feature inventory and newer two-symbol generated inventory/Dojo content.

Verification

Skill-file checks run:

find packages/flowstate-url-builder/.flowstate/skills -name 'SKILL.md' -print
rg '^---$|^name:|^description: Use when' packages/flowstate-url-builder/.flowstate/skills
LC_ALL=C rg -n '[^\x00-\x7F]' packages/flowstate-url-builder/.flowstate/skills

Results:

• Four SKILL.md files found.
• Frontmatter pattern present for all skills.
• ASCII scan passed.

Package verification run:

yarn workspace @epicdm/flowstate-url-builder test --runInBand --no-cache
yarn workspace @epicdm/flowstate-url-builder typecheck
yarn workspace @epicdm/flowstate-url-builder build
yarn workspace @epicdm/flowstate-url-builder lint
yarn nx build @epicdm/flowstate-url-builder

Results:

• test --runInBand --no-cache passed: 1 suite, 34 tests.
• typecheck passed.
• build passed and emitted CJS, ESM, and DTS outputs.
• lint passed.
• nx build passed with local cache output and Nx Cloud setup notice.

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