flowstate-tunnel Package Skill

Package: @epicdm/flowstate-tunnel Repository: epic-flowstate-community Path: packages/flowstate-tunnel 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

Tunnel Contracts

Status: Active Purpose: Keep tunnel shared contracts consistent across Worker and client code. Scope: packages/flowstate-tunnel/src/types.ts and src/constants.ts Trigger: A task involves tunnel endpoint payloads, KV records, status, heartbeat, Cloudflare API, or cloudflared timings. Input: Contract field or constant to use/change. Output: Correct shared type or constant usage.

Request And Response Types

Constants

Verification

yarn workspace @epicdm/flowstate-tunnel typecheck
yarn workspace @epicdm/flowstate-tunnel-worker typecheck

Package Skill Inventory

Skill Inventory: @epicdm/flowstate-tunnel

Review date: 2026-06-30

Skill Map

Feature Coverage

Composition Notes

• Use flowstate-tunnel-worker package skills for endpoint handlers, Cloudflare calls, KV behavior, cron cleanup, and auth.
• Use this package for shared vocabulary and validation only.

Review Gate

Package Skill Review: @epicdm/flowstate-tunnel

Review date: 2026-06-30 Verdict: pass

Quality Gate

• Source-backed package purpose: pass.
• Public entry points documented: pass.
• Composable skill map: pass.
• Generated Dojo weaknesses called out: pass.
• Dojo publish readiness: deferred until generated artifacts are rebuilt from reviewed skills.

Evidence Checked

• package.json
• src/index.ts
• src/constants.ts
• src/types.ts
• src/validation.ts
• src/__tests__/validation.test.ts
• .flowstate/feature-matrix/inventory.md
• .flowstate/dojo/agent-skillset.md

Verification Results

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

Results:

• ASCII/frontmatter check passed.
• test passed: 1 file, 7 tests. Vitest emitted the existing Vite CJS Node API deprecation warning.
• typecheck passed.
• lint passed.
• build passed.
• nx build passed with the existing Nx Cloud 401/unconnected workspace notice.

Dojo Status

Deferred. Existing generated Dojo artifacts should be rebuilt from reviewed local skills because the current skillset splits constants into separate skilllets rather than teaching shared tunnel contracts and worker composition.

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