Files
archie/internal/store/interface.go
T
sam e8356ed1dd feat(eda): playbook dispatch idempotency ledger
Add the playbook_dispatches at-most-once ledger (docs/prds/eda-playbook-engine.md
gap 2) and the record-then-invoke coordinator helper, with the cross-process
plumbing the State Store boundary requires.

- proto: RecordPlaybookDispatch and DeletePlaybookDispatches RPCs (string keys)
- storecontract: PlaybookDispatcher interface (no *sql.Tx, reuses ErrAlreadyDispatched)
- store: playbook_dispatches table + INSERT OR IGNORE dedup + delete-by-playbook
- staterpc: client/server methods and Deps field; error sentinel survives the hop
- eda/playbook: InvokeOnce record-before-invoke helper, keyed on
  (playbook, version, event, action) with a "1" action-position fallback

The ledger is administrative-only: task-scoped grants never reach it, matching
TaskGrants' Update/Transition/InsertEvent allowlist. Not wired into the daemon
workflow pin; the production call site arrives with the first side-effecting
position.
2026-09-22 04:36:28 +10:00

77 lines
3.1 KiB
Go

// Package store defines the task and event persistence for archied's data.
// TaskStore is the full surface the daemon needs and *Store is its SQLite
// implementation.
//
// REVISED (archie-core-8cda.5.6): the producer-owned contract surfaces this
// package used to define live in internal/contracts/store/v1 (package
// storev1) -- the approved contract location -- so the archie-ui process can
// reference the contract without linking this SQLite implementation. The
// definitions below are type aliases for compatibility with the daemon-side
// callers; new UI-process-facing code imports storev1 directly.
package store
import (
"github.com/samcharles93/archie-core/internal/domain/storecontract"
"github.com/samcharles93/archie-core/internal/domain/workflow"
)
// Aliases: the daemon/webui/intake store surfaces moved to storecontract. The
// message strings of the sentinel errors are the wire contract (see
// storev1's var block); the aliases change nothing observable.
type (
TaskStore = storecontract.TaskStore
TaskLifecycle = storecontract.TaskLifecycle
TaskArchiver = storecontract.TaskArchiver
TaskRetryer = storecontract.TaskRetryer
TaskQueries = storecontract.TaskQueries
TaskEvents = storecontract.TaskEvents
TaskLogStore = storecontract.TaskLogStore
CaptureStore = storecontract.CaptureStore
ConfigSnapshotStore = storecontract.ConfigSnapshotStore
ApplyStatusStore = storecontract.ApplyStatusStore
MappingStore = storecontract.MappingStore
BindingStore = storecontract.BindingStore
BindingDispatcher = storecontract.BindingDispatcher
BindingTaskCreator = storecontract.BindingTaskCreator
PlaybookDispatcher = storecontract.PlaybookDispatcher
CapturedEvent = storecontract.CapturedEvent
ConfigSnapshot = storecontract.ConfigSnapshot
ApplyStatus = storecontract.ApplyStatus
WorkflowStat = storecontract.WorkflowStat
StageStat = storecontract.StageStat
DayTokens = storecontract.DayTokens
)
var (
ErrStaleTransition = storecontract.ErrStaleTransition
ErrBindingNotFound = storecontract.ErrBindingNotFound
ErrBindingOverlap = storecontract.ErrBindingOverlap
ErrBindingTransition = storecontract.ErrBindingTransition
ErrAlreadyDispatched = storecontract.ErrAlreadyDispatched
ErrMappingNotFound = storecontract.ErrMappingNotFound
)
// Compile-time check: *Store satisfies TaskStore.
var _ TaskStore = (*Store)(nil)
// Compile-time check: *Store satisfies workflow.Store.
var _ workflow.Store = (*Store)(nil)
// Compile-time check: *Store satisfies CaptureStore.
var _ CaptureStore = (*Store)(nil)
// Compile-time check: *Store satisfies MappingStore.
var _ MappingStore = (*Store)(nil)
// Compile-time check: *Store satisfies BindingStore.
var _ BindingStore = (*Store)(nil)
// Compile-time check: *Store satisfies BindingDispatcher.
var _ BindingDispatcher = (*Store)(nil)
// Compile-time check: *Store satisfies BindingTaskCreator.
var _ BindingTaskCreator = (*Store)(nil)
// Compile-time check: *Store satisfies PlaybookDispatcher.
var _ PlaybookDispatcher = (*Store)(nil)