flowstate-epic-flowstate-community-epicdm-flowstate-rag-sync
Package-local agent skill for @epicdm/flowstate-rag-sync.
Tags
Publisher
Versions
1 version published — latest: 1.0.8
- 1.0.8publishedInvalid Date
Skill
flowstate-rag-sync Package Skill
Package: @epicdm/flowstate-rag-sync
Repository: epic-flowstate-community
Path: packages/flowstate-rag-sync
Version: 1.0.8
Use this published Dojo skill as the package-level entrypoint. For detailed workflows, use the package-local skills listed below.
Primary Package Workflow
RAG Sync Admin Monitoring
Use this skill for service health, admin status, and dashboard integration.
Direct Routes
GET /healthreturns{ status: 'ok' }.GET /statusreturns service metrics, connection display, pipeline metrics, and vector-store summary.
Caveat
/status currently reports several optimistic placeholders:
- connection
connected: true - RxDB
replicating: true - vector-store
totalDocuments: 0
Do not use it as a complete health guarantee until real checks are implemented.
Debug Checklist
- Check direct
/health. - Check
/statusfor metrics, but verify actual service connections separately. - Confirm gateway/UI route prefix.
- Check logs for SurrealDB, Redis, Ollama, and RxDB startup failures.
- Check metrics error entries for unknown collections or embedding failures.
Package Skill Inventory
Package Skill Inventory: @epicdm/flowstate-rag-sync
Skill Map
| Skill | Type | Trigger | Teaches | Dojo |
|---|---|---|---|---|
flowstate-rag-sync | orchestrator | Use when working on the RAG sync service lifecycle or package docs | Package purpose, local-only boundary, skill routing | local-only |
flowstate-rag-sync-service-configuration | workflow/reference | Use when configuring env, Docker, routes, or startup | loadConfig, env vars, service dependencies, direct vs gateway paths | ready-after-review |
flowstate-rag-sync-indexing-pipeline | workflow | Use when changing RxDB event handling, queues, hashes, retries, or processing concurrency | Orchestrator event flow and dedupe model | ready-after-review |
flowstate-rag-sync-document-processing | workflow/reference | Use when adding/changing supported collections or chunk templates | COLLECTION_CONFIG, required fields, unknown collection behavior | ready-after-review |
flowstate-rag-sync-vector-store-contracts | reference | Use when touching SurrealDB schema, embeddings, vector search, or RAG client compatibility | rag_documents, 768-dimension index, hash/upsert/delete/search contracts | ready-after-review |
flowstate-rag-sync-admin-monitoring | workflow/troubleshooting | Use when checking /health, /status, metrics, or dashboard routes | Admin server routes, placeholder caveats, route layers | ready-after-review |
flowstate-rag-sync-ams-memory-events | workflow | Use when indexing AMS memory events or querying namespace memories | Redis pub/sub, memory collection mapping, namespace behavior | ready-after-review |
flowstate-rag-sync-maintenance-and-verification | maintenance | Use before changing public config, schema, docs, Docker, feature matrix, or Dojo | Tests, integration needs, version/docs drift, anti-sprawl | local-only |
Anti-Sprawl Decision
Eight skills are justified because config, indexing, document processing, vector schema, admin monitoring, and AMS events fail differently. Do not create one skill per exported class or helper.
Review Gate
Package Skills Review: @epicdm/flowstate-rag-sync
Verdict
Pass with fixes.
The skillset teaches service operation and vector-index contracts instead of generated feature labels.
Findings
| Severity | Skill | Issue | Evidence | Required Fix |
|---|---|---|---|---|
| High | document-processing/configuration | Compose collection list can include unsupported collections | COLLECTION_CONFIG, compose config | Fix config or document unsupported collections |
| High | vector-store-contracts | MTREE index assumes 768-dimensional embeddings | SurrealDBClient.initSchema() | Keep embedding model parity explicit |
| Important | admin-monitoring | /status includes placeholder connection values and document counts | AdminServer.ts | Do not publish as full health guarantee |
| Important | maintenance | Version/docs/Dojo drift | package metadata, source logs, generated Dojo | Clean before Dojo publication |
Verification
Commands run:
yarn workspace @epicdm/flowstate-rag-sync typecheck
yarn workspace @epicdm/flowstate-rag-sync lint
yarn workspace @epicdm/flowstate-rag-sync test --runInBand
yarn workspace @epicdm/flowstate-rag-sync build
Results:
- Typecheck passed.
- Lint passed.
- Tests passed: 8 suites, 97 tests.
- Build passed.
Dojo Publication Decision
Do not publish existing generated .flowstate/dojo artifacts. Rebuild from reviewed workflow skills after verification and after collection/vector/admin caveats are either fixed or explicitly tracked.
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-rag-sync/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-rag-sync --target <target> --out ./skillsReplace <target> with your agent target identifier. See the CLI docs for details.