saga_forge 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9198aa3ee09a2ee78074a346f4df07d7581559dec0f56128579f1840b4499a10
+  data.tar.gz: 6a471689442709ff20cb58baf40ea9847c5135995f9e60f4bf87ccd394778512
+SHA512:
+  metadata.gz: 0ef95d4a19acdcc0d6c8a745b9b42c7e067416417918b7ad1e1df282e13167afeed28694104d3cb773aa288c852264a8154cfd3065d1d47c6784e60496e1e6b1
+  data.tar.gz: 30d863984778d17c11e57220b2c0326f4a6e7004eac8c1ef469bf7962e4694a2cf46af4cf0a812b4da69622d221cead97437a8eb99a00310269334dfa8ad2c13

data/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+## [0.1.0] - 2026-08-26
+
+### Bug Fixes
+
+- Json fallback columns get null:false + empty-hash defaults
+- Deep-freeze Definition, exact block-extent jump attribution, DSL guards
+- Loud boot-time definition compilation, router skip logging, test registry hygiene
+- Savepoint duplicate-insert dedup for PG, testable boot compile, doc notes
+- Atomic stall counter, not-found discard boundary test
+- Lock retry bookkeeping against concurrent deliveries, encoding-safe error capture
+- Version-fence compensation commits against concurrent runners
+- Index compensating scan, sweep concurrency guards, batched retention deletes
+- Status-scoped recovery writes, operator guards, bulk enqueue
+- Anchor the migration exists-check to exact names
+- Freeze graph members; test + document multi-terminal to_graph
+- Close forward-only guard hole in TimeoutJob; stamp last_active_at on timeout/compensation paths
+
+### Documentation
+
+- SagaForge design spec and core implementation plan
+- Match recurring.yml snippet comment verbatim to plan wording
+- Final task-tracking sync — all 14 plan tasks completed
+- Hero example initiates a pending payment; settlement is genuinely async
+- Rewrite README to the angarium standard
+- Landing page and Pages deploy workflow
+- 'events' not 'webhooks' in the hook; drop the headless claim
+- Explain the stall budget (timing, tuning, re-delivery)
+- Saga_forge-dashboard design spec (phase 2)
+- Saga_forge-dashboard implementation plan (phase 2)
+- Dashboard plan follow-ups and task completion tracking
+- Forward-only DAG + structural dedup implementation plan
+- Forward-only DAG, structural dedup, persisted lifecycle timestamps, Rails-required
+- Task tracking for DAG/structural-dedup refactor (all tasks complete)
+- Mark review-fix task complete
+
+### Features
+
+- Gem scaffold, configuration, combustion test harness
+- Schema, ApplicationRecord multi-DB routing, State and Event models
+- Port RetryPolicy and CompositeRetryPolicy from chrono_forge
+- Saga DSL and compiled Definition with boot validations and mermaid
+- Router, external publisher with dedup and guard, saga eager-load railtie
+- Execution lifecycle — not-found absorption, halt, stall spin and parking
+- Facade verbs, single-commit execution, staged publish delivery, parking re-delivery
+- Retry policy integration with per-error budgets and failed-event isolation
+- Derived LIFO compensation with per-step commits and tolerant retries
+- Version-fenced timeouts with fail! and branch actions
+- Sweeper delivery guarantee with stranded-recovery duties, terminal-only retention
+- Operator recovery API — retry_stalled!, resume!, compensate!, cancel!
+- Install and migrations generators with --database multi-DB support
+- Durability suite, CI matrix, README, solid_queue key coverage
+- Definition#to_graph, stay_targets, State.compensating (dashboard reads)
+- Lower stall_budget default to 3 (parking is cheap and self-healing)
+- Structural dedup key + finalized_at/last_active_at/last_processed_at
+- Structural (saga,correlation,event) dedup; drop event_id/digest
+- Tolerate benign staged-insert collisions via per-row savepoints
+- [**breaking**] Remove stay verb; sagas advance, branch, or fail — never loop
+- [**breaking**] Enforce forward-only DAG — reject advances into visited states
+- Stamp last_active_at/finalized_at/last_processed_at atomically at commit
+- Sweeper/retention key off persisted last_active_at/finalized_at/last_processed_at
+- [**breaking**] Default job_queue to :default; add maintenance_queue seam
+
+### Miscellaneous Tasks
+
+- Shebang and strict mode for bin/appraise
+- LICENSE, lean gem manifest, record A.8 warning deferral
+- Add cliff-driven release tooling for both gems
+- Exclude the dashboard's demo config.ru from root standard
+- Tidy gemspecs for release
+- Require MFA to push the gems (rubygems_mfa_required)
+
+### Refactoring
+
+- Boot-validate timeouts, extract shared post-commit effects, timeout concurrency key
+- Adopt chrono_forge's migration template pattern (install/upgrade generators)
+- [**breaking**] Require Rails (railties dep); drop standalone ActiveRecord/ActiveJob guards
+
+### Testing
+
+- UnknownStateError rollback + duplicate-start race coverage, engine contract comments
+- Exercise limits_concurrency through the real solid_queue macro
+
+## [Unreleased]

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stefan Froelich
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.