flowstate-flowstate-platform-epicdm-flowstate-obs
Package-local agent skill for @epicdm/flowstate-obs.
Tags
Publisher
Versions
1 version published — latest: 0.1.0
- 0.1.0publishedInvalid Date
Skill
flowstate-obs Package Skill
Package: @epicdm/flowstate-obs
Repository: flowstate-platform
Path: packages/worker-obs
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
Observability Alerts And Retention
Status: Active
Purpose: Keep alerting, grouping, and scheduled cleanup reliable and isolated.
Scope: packages/worker-obs/src/services
Trigger: Work on alert rules, webhook/email dispatch, queue grouping, retention, or scheduled worker behavior.
Input: Alert or maintenance behavior change.
Output: Updated service behavior with focused tests.
Workflow
- Start at
src/index.tsto confirm queue and scheduled handlers. - For alert rules, update
src/services/alert-evaluator.ts. Preserve cooldown handling and malformed config skip behavior. - For dispatch, update
src/services/alert-dispatcher.tsand ensure failures do not corrupt ingestion state. - For grouping, update
src/services/error-grouping.ts; it is called by the worker queue handler. - For retention, update
src/services/retention.ts; it is called from the scheduled handler. - Add tests that inject D1/R2/queue-like doubles rather than requiring live Cloudflare services.
Alert Rule Behavior
| Rule Type | Trigger Source |
|---|---|
new_error | ctx.isNewGroup |
regression | ctx.isRegression |
error_spike | Count of project errors in configured window |
Verification
yarn testyarn typecheck
Composition
- Use
flowstate-obs-ingestion-streamingwhen alert inputs are produced by log or error ingestion.
Package Skill Inventory
worker-obs Skill Inventory
Package: @epicdm/flowstate-obs
Purpose: Observability API for logs, errors, sessions, streaming, alerts, RPC, retention, and queue grouping.
| Skill | Type | Use When | Source Anchors |
|---|---|---|---|
flowstate-obs-ingestion-streaming | Workflow | Changing log/error/session ingestion, SSE, WebSocket, broadcast, or RPC streaming behavior. | src/index.ts, src/routes/logs.ts, src/routes/errors.ts, src/do/streaming.ts, src/services/broadcast.ts |
flowstate-obs-alerts-retention | Workflow | Changing alert rules, alert dispatch, error grouping queue, or retention cron. | src/services/alert-evaluator.ts, src/services/alert-dispatcher.ts, src/services/error-grouping.ts, src/services/retention.ts |
Composition
- Compose with
flowstate-mcp-tool-registrywhen observability functions are exposed through MCP tools. - Compose with
flowstate-provisioning-queue-lifecyclewhen provisioning creates OBS projects for tenants.
Review Gate
worker-obs Skill Review
Reviewed: 2026-06-30 Result: Pass for local agent use.
Checks
- Skills cover the two complex operational surfaces: ingest/streaming and alerts/retention.
- Source references include routes, services, durable object, queue, scheduled work, and tests.
- Skills are package-local and not generated from feature names.
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/worker-obs/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-flowstate-platform-epicdm-flowstate-obs --target <target> --out ./skillsReplace <target> with your agent target identifier. See the CLI docs for details.