flowstate-epic-flowstate-community-epicdm-flowstate-workers
Package-local agent skill for @epicdm/flowstate-workers.
Tags
Publisher
Versions
1 version published — latest: 0.1.0
- 0.1.0publishedInvalid Date
Skill
flowstate-workers Package Skill
Package: @epicdm/flowstate-workers
Repository: epic-flowstate-community
Path: packages/flowstate-workers
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
Workers Agent Networking And Kong
Use this skill for agent HTTP/WebSocket routing.
Model
Kong runs DB-less. The orchestrator generates declarative service, route, and plugin entries, merges them into base kong.yml, writes atomically, then reloads Kong.
Route Types
- Shell routes use JWT validation and support token query param for WebSocket clients.
- Chat routes use JWT plus claim extraction so user claims are forwarded upstream.
Change Checklist
- Keep route names stable and deterministic.
- Preserve atomic file write behavior.
- Validate pending config from Kong's container path.
- Reload the configured Kong container.
- Keep shared claim Lua sourced from
@epicdm/gateway-routes.
Package Skill Inventory
Package Skill Inventory: @epicdm/flowstate-workers
Skill Map
| Skill | Type | Trigger | Teaches | Dojo |
|---|---|---|---|---|
flowstate-workers | orchestrator | Use when working on worker daemon, scanner, agent orchestration, CLIs, docs, or Dojo | Package map, public/de facto contracts, skill routing | local-only |
flowstate-workers-daemon-execution | workflow | Use when changing WorkerDaemon, claims, heartbeats, executor, workspace prep, or memory middleware | Worker lifecycle and process-runner execution | ready-after-review |
flowstate-workers-process-scanner | workflow | Use when changing ProcessScanner, cache, scan/resume logic, or polling/event fallback | Process detection and resume orchestration | ready-after-review |
flowstate-workers-agent-orchestration | workflow | Use when changing AgentOrchestrator, manual/task spawn, registry, health, or idle handling | Agent container lifecycle and control-plane flow | ready-after-review |
flowstate-workers-harness-runtime-config | reference/workflow | Use when changing agent runtime config, harness resolution, model/resource flags, or self-host gates | Zod runtime config, OpenClaw/Hermes resolution, policy violations | ready-after-review |
flowstate-workers-agent-networking-kong | reference/workflow | Use when changing Kong declarative route generation, merge/reload, shell/chat auth behavior | DB-less Kong route/plugin generation and reload | ready-after-review |
flowstate-workers-agent-secrets-forgejo | workflow | Use when changing vault secret fetch, .env fallback, Forgejo users/PATs, or env mappings | Secret sources, AGENT_ENV_MAP, Forgejo no-log/no-persist rules | ready-after-review |
flowstate-workers-container-builders | reference | Use when changing Docker/OpenClaw/Hermes container config, labels, mounts, or Overwatch policy | Container builders and network/resource policy | ready-after-review |
flowstate-workers-maintenance-and-drift | maintenance | Use before changing public exports, dependencies, smoke contracts, docs, feature matrix, or Dojo | Verification, dependency/export checks, generated Dojo replacement | local-only |
Anti-Sprawl Decision
The feature inventory reports about 80 items, but they collapse into 8-9 operational skills. Do not create one skill per helper, adapter, or test fixture.
Review Gate
Package Skills Review: @epicdm/flowstate-workers
Verdict
Pass with fixes.
The skillset documents worker execution and agent control-plane workflows, not individual source symbols.
Findings
| Severity | Skill | Issue | Evidence | Required Fix |
|---|---|---|---|---|
| High | harness-runtime-config/maintenance | zod import must be declared at package boundary | agent-runtime-config.ts, package metadata | Verify dependency declaration |
| High | maintenance | De facto orchestrator contracts are deep-imported by smoke tests but not root-exported | smoke tests, src/index.ts | Track supported vs internal API |
| Important | daemon-execution | Shell command construction requires trusted/validated executionId and scriptsDir | worker/executor.ts | Keep warning prominent |
| Important | secrets-forgejo | Raw PATs and secrets flow through memory and env maps | forgejo/vault modules | Preserve no-log/no-persist behavior |
| Important | generated Dojo | Existing Dojo is generated and inaccurate about tests | .flowstate/dojo/* | Rebuild from reviewed skills |
Verification
Commands run:
yarn nx test @epicdm/flowstate-workers --runInBand --skip-nx-cache
yarn nx typecheck @epicdm/flowstate-workers --skip-nx-cache
yarn nx build @epicdm/flowstate-workers --skip-nx-cache
yarn workspace @epicdm/flowstate-workers lint
Results:
- Test failed: 50 suites passed, 2 skipped, 1 failed; 701 tests passed, 10 skipped, 1 failed.
- Failing assertion:
src/orchestrator/__tests__/agent-orchestrator-openclaw.test.tsexpectedspawnOpenClawAgentto be called with an object containing selected OpenClaw container config; received config differed. - Jest did not exit after completion because of open handles; the hung test process was interrupted after the failure was captured.
- Typecheck passed.
- Build passed.
- Lint passed with 129 existing warnings.
Dojo Publication Decision
Do not publish existing generated .flowstate/dojo artifacts. Rebuild from reviewed workflow skills after verification and dependency/export drift checks.
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-workers/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-community-epicdm-flowstate-workers --target <target> --out ./skillsReplace <target> with your agent target identifier. See the CLI docs for details.