# Siglo

- [Siglo](https://siglo.dev/index.md): Zero-daemon, in-process workflow orchestration with durable checkpoints, Sagas, and live visual DevTools.
- [Getting Started](https://siglo.dev/01-getting-started.md): Build a resilient checkout workflow with retries, compensation rollbacks, and unit tests using Siglo.
- [Core Concepts](https://siglo.dev/02-core-concepts.md): Mental model and architecture of Siglo: AST graph representation, accumulated context inference, step lifecycles, and metadata namespaces.
- [Sequential Workflows](https://siglo.dev/03-sequential-workflows.md): Compose linear pipelines with strict step execution order, accumulated context, and declarative lifecycle hooks in Siglo.
- [Branching and Parallelism](https://siglo.dev/04-branching-and-parallelism.md): High-performance workflow combinators for concurrent fan-out, racing, conditional routing, and bounded batch mapping in Siglo.
- [Retries, Timeouts, and Cancellation](https://siglo.dev/05-retries-timeouts-and-cancellation.md): Fault tolerance patterns in Siglo: exponential backoff retries with jitter, step and workflow deadlines, AbortSignal cooperative cancellation, and automatic Saga rollbacks.
- [Durable Workflows](https://siglo.dev/06-durable-workflows.md): Long-running and suspendable workflows in Siglo: asynchronous event suspension with waitForEvent, durable timer sleeps, event-driven resumption, and schema migrations.
- [Storage and Adapters](https://siglo.dev/07-storage-and-adapters.md): Pluggable persistence architecture for Siglo: PostgreSQL and Redis adapters, durable checkpoints, distributed locks, multi-tenant namespaces, and storage error modes.
- [Observability](https://siglo.dev/08-observability.md): Telemetry, diagram exports, and real-time DevTools in Siglo: OpenTelemetry distributed tracing, Mermaid/DOT AST exports, and React live monitoring.
- [Testing and Replay](https://siglo.dev/09-testing-and-replay.md): Zero-flake test harness for Siglo: step mocking, spies, virtual clocks, execution trace snapshots, and production failure replay.
- [TypeScript Reference](https://siglo.dev/10-typescript-reference.md): Type safety and static inference in Siglo: Step generic signatures, accumulated context union typing, typed $steps history, and Standard Schema validation.
- [Production Operations](https://siglo.dev/11-production-operations.md): Runbook and operational best practices for Siglo in mission-critical environments: zero-daemon topologies, PostgreSQL OCC, distributed locking, and graceful container shutdown.
- [Serve a REST Endpoint and Watch It Run Live](https://siglo.dev/rest-and-live-monitoring.md): Expose a Siglo checkout workflow through an Express REST endpoint, stream execution events, and inspect step retries and compensations in the live monitor.
- [Run Checkout Across Two Servers with PostgreSQL and Redis](https://siglo.dev/distributed-rest-and-live-monitoring.md): Scale a Siglo checkout workflow across multiple API servers using PostgreSQL idempotency and Redis pub/sub live monitoring.
- [Suspend Checkout for Approval and Resume Across Servers](https://siglo.dev/durable-distributed-checkout.md): Suspend a distributed Siglo checkout workflow for human approval, persist execution state to PostgreSQL, and resume across server restarts.
- [Route Kafka Order Events with branch and when](https://siglo.dev/kafka-order-routing.md): Consume Kafka order events, route conditional fulfillment with branch and when, deduplicate with PostgreSQL, and monitor live decisions in Siglo.
- [Accept Asymmetrically Signed Orders](https://siglo.dev/signed-order-intake.md): Authenticate partner order requests with @siglo/crypto and @siglo/express before publishing them to Kafka, with timestamp and nonce replay protection.
- [Zero-Code APM Dashboards](https://siglo.dev/zero-code-apm-dashboards.md): Explore OpenTelemetry traces in Jaeger and Prometheus metrics in pre-provisioned Grafana dashboards for distributed Kafka order routing workflows.
- [Siglo Workflow Explorer & IDE Tooling](https://siglo.dev/ide-workflow-explorer.md): Visual static graph inspection, live-typing feedback, and bidirectional source code navigation for Siglo workflows in IntelliJ IDEA and VS Code.
- [Live Monitoring & DevTools](https://siglo.dev/live-monitoring.md): Real-time DAG topology visualization, execution state diff inspection, latency waterfalls, and interactive DevTools for Siglo workflows.
- [Ecosystem DevTools and Offline Testing](https://siglo.dev/ecosystem-devtools.md): Web monitor, runtime inspection protocols, zero-capture redaction contracts, and offline test recipes for Siglo ecosystem steps.
- [Ecosystem Adapters & Integrations](https://siglo.dev/ecosystem-adapters.md): Production-ready ecosystem integrations for Siglo: HTTP web frameworks, message brokers, persistent storage, security, generative AI, and developer tools.
- [PostgreSQL Adapter](https://siglo.dev/adapters/postgres.md): Enterprise ACID persistence, context mutation audit logging, OCC versioning, advisory locks, and idempotency store for Siglo workflows.
- [Redis Adapter](https://siglo.dev/adapters/redis.md): In-memory distributed persistence, step response caching, atomic idempotency deduplication, distributed mutex locking, and replay defense.
- [Scheduler & Durable Resumption](https://siglo.dev/adapters/scheduler.md): Background timer polling, PostgreSQL advisory session locking, and cloud webhook dispatchers for resuming durable Siglo workflows.
- [Kafka Consumer](https://siglo.dev/adapters/kafka.md): Partitioned Kafka consumer and batch handler adapter for executing Siglo workflows with idempotency deduplication and offset control.
- [BullMQ Job Queue](https://siglo.dev/adapters/bullmq.md): Redis-backed BullMQ worker processor and job queue consumer adapter for executing Siglo workflows.
- [AWS SQS Adapter](https://siglo.dev/adapters/sqs.md): AWS SQS batch consumer adapter for Lambda event source mappings and long-polling workers with partial batch failure handling.
- [HTTP Client Steps](https://siglo.dev/adapters/http.md): Resilient, W3C-traced HTTP client steps for Siglo workflows with ASL egress perimeter enforcement, backoff retries, and declarative sagas.
- [Express Adapter](https://siglo.dev/adapters/express.md): Express middleware adapter for executing Siglo workflows with correlation propagation, cancellation, and semantic status code mapping.
- [Fastify Adapter](https://siglo.dev/adapters/fastify.md): Low-overhead Fastify route handler adapter for executing Siglo workflows with asynchronous lifecycle and raw socket cancellation.
- [Hono Adapter](https://siglo.dev/adapters/hono.md): Web Standards-compliant route handler and middleware adapter for deploying Siglo workflows to Cloudflare Workers, Deno, Bun, and Node.js.
- [Cryptography & Security](https://siglo.dev/adapters/crypto.md): Zero-dependency cryptographic primitives: timing-safe webhook verification, replay defense, AES-256-GCM envelope encryption, and PII redaction.
- [AI & Agentic Inference](https://siglo.dev/adapters/ai.md): Multi-provider LLM inference, native structured outputs, self-healing prompt repair, and Step-as-Tool agent loops for Siglo workflows.
- [OpenTelemetry Adapter](https://siglo.dev/adapters/opentelemetry.md): Vendor-neutral distributed tracing, semantic spans, context event streaming, and W3C Trace Context propagation for Siglo workflows.
- [Notifications & Approvals](https://siglo.dev/adapters/notifications.md): Multi-channel messaging, tamper-proof cryptographic approval tokens, and distributed durable callback resumption for Siglo workflows.
- [Notification Hardening & Recovery](https://siglo.dev/adapters/notification-hardening.md): Production security, two-phase approval confirmation, authorization callbacks, durable recovery, and network egress defenses for @siglo/notifications.
- [Live Monitoring & DevTools](https://siglo.dev/adapters/monitor.md): Real-time workflow telemetry, dynamic DAG topology visualization, latency waterfalls, SSE/WebSocket transports, and Prometheus metrics.
- [Developer Tools & CLI](https://siglo.dev/adapters/cli.md): Scaffold, visualize, validate, inspect, replay, monitor, and reconcile Siglo workflows from the command line and Node.js API.
- [Testing & Deterministic Replay](https://siglo.dev/adapters/testing.md): Zero-flake testing utilities, virtual clocks, step spies, mocks, assertions, and golden fixture replay tooling for Siglo workflows.
- [Execution Semantics Contract](https://siglo.dev/execution-semantics.md): Formal runtime execution semantics, lifecycle phases, context accumulation, error propagation, network boundaries, and saga compensation contracts in Siglo.
- [Concurrency and Parallelism](https://siglo.dev/concurrency-and-parallelism.md): Comprehensive guide to concurrent execution, parallel fan-out, competitive racing, conditional routing, and bounded collection mapping in Siglo.
- [Error Model & Exception Hierarchy](https://siglo.dev/error-model.md): Comprehensive exception hierarchy rooted at SigloError: timeout, cancellation, spec validation, optimistic concurrency, durable events, sagas, network egress, and error normalization.
- [Storage & Checkpoint Contract](https://siglo.dev/storage-contract.md): Persistence model, checkpoint schema v2.0.0, optimistic concurrency control (OCC), field redaction, and StorageAdapter interface in Siglo.
- [Compensation and Sagas](https://siglo.dev/compensation-and-sagas.md): Saga pattern implementation in Siglo: automatic LIFO rollback, inline closures, named persistent handlers, retry policies, strict vs best-effort execution, and abandoned stack reconciliation.
- [Durable Waits and External Events](https://siglo.dev/durable-waits.md): Formal specification and operational contracts for durable suspension, correlation keys, event resumption, and checkpoint state restoration in Siglo.
- [Idempotency and Deduplication](https://siglo.dev/idempotency.md): Workflow-level and step-level idempotency guarantees, atomic claim lifecycle, wait-and-settle thundering herd defense, and error classification.
- [Network Egress Policy & Guardrails](https://siglo.dev/network-egress-policy.md): In-process zero-trust network perimeter enforcement via AsyncLocalStorage (ASL) across fetch, Node HTTP, and raw TCP sockets in Siglo.
- [Production Best Practices & Operational Runbook](https://siglo.dev/production-best-practices.md): Master engineering guide for deploying Siglo workflows in mission-critical, distributed, high-throughput enterprise production environments.
- [Workflow Graph Model](https://siglo.dev/workflow-graph.md): Declarative workflow AST, pure JSON-serializable node hierarchy, cycle validation, and inspector API in Siglo.
- [Workflow Versioning and State Migrations](https://siglo.dev/workflow-versioning.md): Semantic version tagging on flows, compatibility validation during resumption, state migration functions, and deployment best practices in Siglo.
- [API Reference Overview](https://siglo.dev/api/overview.md): Comprehensive API reference for Siglo: orchestration combinators, Flow and Step methods, execution options, storage adapters, error hierarchy, and deterministic testing.
- [Orchestration & Combinators](https://siglo.dev/api/orchestration-and-combinators.md): API reference for Siglo functional workflow combinators: flow, parallel, all, allSettled, race, when, branch, map, waitForEvent, wait, and AST graph utilities.
- [Flow Instance Methods](https://siglo.dev/api/flow.md): API reference for the Siglo Flow interface: run, timeout, version, networkPolicy, monitor, hook, resume, compensate, and AST export methods.
- [Step Methods](https://siglo.dev/api/step.md): API reference for the Step execution unit in Siglo: instantiation, schema validation, lifecycle hooks, retries, sagas, idempotency, caching, dependency injection, and network guardrails.
- [Execution Options](https://siglo.dev/api/execution-options.md): API reference for ExecutionOptions in Siglo: pojo, mode, signal, timeout, services, durable checkpoints, migrations, namespaces, idempotency, stepExecutionHook, and network policy.
- [Storage & Persistence Utilities](https://siglo.dev/api/storage-and-persistence.md): API reference for Siglo storage adapters and persistence utilities: useStorage, getStorageAdapter, checkpoints, OCC, serialization, and cleanExpiredCheckpoints.
- [Error Hierarchy & Exceptions](https://siglo.dev/api/error-hierarchy.md): API reference for the SigloError exception model: timeouts, cancellations, schema validation, sagas, network policy violations, and error normalization.
- [Deterministic Testing](https://siglo.dev/api/testing.md): API reference for the @siglo/testing harness: virtual clocks (FakeClock), InMemoryStorageFake, step spies, step mocks, event injection, assertions, and execution replay.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.