flowstate-collections Package Skill

Package: @epicdm/flowstate-collections Repository: epic-flowstate-community Path: packages/db-collections Version: 1.1.9

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

Primary Package Workflow

Collection Contracts

Use this skill when adding, removing, renaming, or changing a FlowState collection contract.

Contract Sync Points

Check and update the relevant pieces together:

• generated RxDB model under src/models
• generated or hand-authored Zod schema under src/schemas
• root exports in src/index.ts
• collections map
• COMMUNITY_COLLECTIONS and ALL_COLLECTION_NAMES in src/tiers.ts
• ID prefix maps in src/utils/id
• D1 table/route expectations in downstream packages
• tests for models, schemas, tiers, and consumers

Generated File Boundary

Do not casually hand-edit generated models or generated schemas. Identify the upstream Drizzle/generator source, regenerate, then review the generated diff.

Hand-authored workflow schemas and helper contracts can be edited directly, but still need reverse-reference checks because this package is imported broadly.

Tier Routing

Use:

const selected = getCollectionsForTier(collections, premium)
const modes = buildCollectionModes(premium)

Community mode includes 13 local collections. Premium mode returns all collections local through an empty mode map plus default local behavior.

Watch Outs

• Missing ID prefix entries break createId, reverse lookup, and downstream tools.
• Docs that say 13 physical collections are stale shorthand for community local limits, not total source collections.
• Package manifests in some consumers pin released versions; verify dist/version drift before publication.

Package Skill Inventory

Package Skill Inventory: @epicdm/flowstate-collections

Package path: packages/db-collections.

Skill Map

Anti-Sprawl Decision

Do not create one skill per model, Zod schema, ID helper, or table. This package is a shared contract package; the useful skills are contract maintenance workflows and focused references for virtual schemas, React routing, workflow helpers, and vault contracts.

Review Gate

Package Skill Review: @epicdm/flowstate-collections

Package path: packages/db-collections.

Review Result

Status: drafted, source-backed, partially verified, pending test repair and publication.

The skillset is workflow-shaped around data contracts, virtual schemas, React data access, helper contracts, vault payload contracts, and package maintenance.

Checks

• Source review: completed from package exports, models, tiers, core adapters, tests, and generated artifact drift.
• Skill inventory: completed.
• Skill files: completed.
• ASCII/frontmatter scan: passed.
• Package typecheck: passed.
• Package lint: passed with 449 existing warnings.
• Package build: passed through Nx.
• Package tests: failed in src/__tests__/tiers.test.ts because tests still expect 32 total collections and 19 remote community collections, while source exposes 34 total collections and 21 remote community collections.
• Generated Dojo replacement: pending.
• Cloud Dojo publication: pending.

Verification Commands

Run before publication:

yarn workspace @epicdm/flowstate-collections test
yarn workspace @epicdm/flowstate-collections typecheck
yarn workspace @epicdm/flowstate-collections lint
yarn nx build @epicdm/flowstate-collections

Publication Gate

Do not publish existing .flowstate/dojo artifacts until they are rebuilt from reviewed package 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/db-collections/package.json. Do not treat generated feature lists as lessons; use workflow evidence from CODE-REVIEW.md, SKILL-INVENTORY.md, and REVIEW.md.