Skip to content

Foundation: simulation and state primitives #70

Closed

Description

@CompleteDotTech

Goal

Shared building blocks for recipes that keep state or run a loop, so thirteen advanced recipes do not each invent a queue and a simulator.

Scope

  • A deterministic, seeded simulator base: reset, observe, enumerate legal actions, step, and a trajectory log that can be replayed.
  • A simulated review queue and action log, used wherever a recipe says an item goes to review or an action is simulated.
  • A versioned key-value store that keeps provenance and never deletes, with history and rollback.
  • A transactional wrapper: validate, apply, roll back on failure, with a replayable log.
  • A budget helper for retry limits, call budgets, and stop conditions, raising when exceeded.
  • Guidance on using ScriptedBackend to run a closed loop offline.

Acceptance criteria

  • Each primitive has tests, including property-style tests for the invariants (no deletion, budget never exceeded, replay reproduces state)
  • Same seed gives the same trajectory on Linux and Windows
  • A short example shows a loop running offline end to end
  • Lint and tests pass in CI, or locally with the output pasted in the pull request if CI does not exist yet

Dependencies

References

Activity

  1. added
    type: foundationShared code, tooling, CI, or docs that recipes depend on
    size: LTwo to three days; consider splitting the work
    status: blockedWaiting on the issues listed under Dependencies
    on Oct 6, 2026
  2. added
    status: in progressClaimed; a branch or pull request exists
    and removed
    status: blockedWaiting on the issues listed under Dependencies
    on Oct 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    priority: p1Next up once unblockedsize: LTwo to three days; consider splitting the worktype: foundationShared code, tooling, CI, or docs that recipes depend on

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions