admin
9bf56a806b
Relocate the ~6k-file docs tree from the repo root into plugins/document-navigator/docs/ so the plugin is self-contained and portable. docs/superpowers/ (specs and plans) stays at the repo root. Moved via cp+rm rather than git mv because directory rename() fails with EPERM on this WSL /mnt DrvFs mount; git rename-detection pairs the identical-content files at commit time. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
flow
Finite state machines, CRDTs, idempotency, and CBOR serialization.
Packages in flow
18 packages.
| Package | Description |
|---|---|
@suaveplan/cbor |
RFC 8949 (CBOR) encoder + decoder, RFC 8742 (CBOR Sequences), pull-style streaming decoder (AsyncIterable<Uint8Array> / ReadableStream<Uint8Array>), RFC 90… |
@suaveplan/crdt |
Conflict-free Replicated Data Types (CRDTs) for distributed systems. Provides eight composable CRDT primitives plus a vector-clock and a sync manager that coor… |
@suaveplan/fsm |
Typed, generic finite state machine (FSM) for TypeScript. Ships a synchronous-by-default interpreter with guard predicates, ordered transition actions, context… |
@suaveplan/idempotency |
Idempotency key guard and deduplication for async operations. The package provides a complete pending → completed | failed state machine, three store backend… |
@suaveplan/job-scheduler |
Universal in-process job scheduler with cron + queued runs, retries, timeouts, concurrency control, and OpenTelemetry observability. Built on @suaveplan/cron… |
@suaveplan/queue |
Enterprise-grade queue management: memory/priority/delayed queues, concurrent workers with retry and dead-letter forwarding, job state machines, and OTel instr… |
@suaveplan/queue-distribution |
Worker-pool distribution layer: load-balancing strategies, worker pool management, manager with retry and health checks, in-process LocalWorker. Transport-ag… |
@suaveplan/queue-distribution-http |
HTTP transport plugin for @suaveplan/queue-distribution. Ships HttpWorkerCommunicator (a fetch-backed WorkerCommunicator with a Zod-validated wire envelo… |
@suaveplan/queue-distribution-worker-thread |
Web-Worker / Node worker_threads transport plugin for @suaveplan/queue-distribution. Ships WorkerThreadCommunicator (a ThreadWorkerLike-based message b… |
@suaveplan/rate-limiter |
Enterprise rate limiter with three algorithms, rule-based routing, tenant multipliers, pluggable storage, and OTel instrumentation. |
@suaveplan/retry |
Retry strategies and circuit-breaker for async operations. The package provides constant, linear, and exponential backoff with four jitter modes (full, equal,… |
@suaveplan/rules |
Universal rule engine + validation system. Comprehensive RuleEngine with async evaluation, depth limit, AbortSignal, plugin registration; fluent `RuleBuilder… |
@suaveplan/rules-hono |
Hono middleware wrapping @suaveplan/rules. Six middleware factories — ruleMiddleware, validationMiddleware, accessControl, responseValidation, `rateL… |
@suaveplan/streams |
WHATWG-Streams-based primitives: backpressure-first transforms, zero-copy Uint8Array operations, AbortSignal integration end-to-end, structured errors, OTe… |
@suaveplan/streams-chunk-queue |
Universal out-of-order chunk reconstitution. Accepts chunks for a file in any order and exposes a sequential ReadableStream<Uint8Array> consumer surface, com… |
@suaveplan/streams-metadata |
Universal stream transforms that detect MIME type and extract EXIF/IPTC/XMP image metadata from buffered Uint8Array payloads. Three composable transforms (`M… |
@suaveplan/undo |
Enterprise-grade undo/redo engine with branching history, async commands, history compression, selective undo, and command merging. Built for collaborative edi… |
@suaveplan/workflow |
Workflow and pipeline orchestration: sequential and parallel step execution, conditional branching with guard functions, retry strategies, timeouts, saga-patte… |