refactor(sqlite-storage): rename SqliteOrigin variants for clarity

[NathanFlurry]

Description

Please include a summary of the changes and the related issue. Please also include relevant motivation and context.

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

How Has This Been Tested?

Please describe the tests that you ran to verify your changes.

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

[NathanFlurry]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• ci(publish): skip lfs for preview checkouts #4819
• test(engine): cover envoy Sleep crash policy wake and recovery paths #4816
• refactor(sqlite-storage): extract DBHead to vbare-versioned protocol crate #4815
• refactor(sqlite-storage): rename SqliteOrigin variants for clarity #4814 👈 (View in Graphite)
• fix(sqlite-storage): allow invalidate_v1_migration on non-migrating META #4813
• test(engine): stabilize runner and envoy suites #4809
• fix(pegboard): decode envoy actor eviction keys #4803 : 1 other dependent PR (#4804 )
• fix(pegboard-envoy): subscribe before registering envoy #4802
• fix(envoy-client): dedupe replayed commands by index #4811 : 1 other dependent PR (#4812 )
• fix(envoy-client): complete command and request lifecycles #4801
• fix(guard): serialize gateway actor keys correctly #4655 : 1 other dependent PR (#4800 )
• chore(rivetkit): remove inline tests #4668 : 1 other dependent PR (#4657 )
• fix(api): subscribe before namespace workflow dispatch #4654
• fix(rivetkit): restore hibernatable sockets and hydrate serverless starts #4658
• test(rivetkit): stabilize actor db driver tests #4664 : 1 other dependent PR (#4656 )
• fix(test): stabilize lifecycle, sleep, queue, and run edge cases #4660 : 1 other dependent PR (#4665 )
• test(rivetkit): re-enable gateway URL and direct-registry coverage #4659
• fix(rivetkit): keep internal error exposure behavior consistent #4661
• fix(rivetkit): add lifecycle error retry and gateway HTTP routing #4666
• fix(rivetkit-core): remove legacy timeouts #4799
• chore: add CLAUDE.md guidance on test fixtures, SDK regen, and TS client layer #4796
• fix(inspector): stream patched state updates #4795
• fix(rivetkit): refresh stale actor handles #4794
• test(rivetkit-napi): move private tests to crate root #4793
• test(rivetkit-core): move private tests to crate root #4792
• test(runner-configs): assert envoy protocol version #4791
• fix(serverless): split metadata protocol errors #4789 : 1 other dependent PR (#4790 )
• chore(sqlite): add open close lifecycle for envoy actors #4788
• fix(rivetkit): share lifecycle shutdown grace #4810
• fix(pegboard): move sqlite v1 migration into actor workflow #4787 : 1 other dependent PR (#4797 )
• test(rivetkit): cover c.db access from onWake/onSleep/onDestroy #4786
• fix(rivetkit-napi): run onMigrate before createState/onCreate/createVars #4785
• refactor(rivetkit-core): merge ready+started into lifecycle_started, drop redundant napi calls #4784
• fix(rivetkit): drain native sleep side tasks reliably #4782 : 1 other dependent PR (#4783 )
• fix(rivetkit): route raw request fetches to actors #4781
• fix(pegboard): refresh runner config after envoy connect #4778 : 2 other dependent PRs (#4779 , #4798 )
• chore(kitchen-sink): configurable endpoint #4766 : 2 other dependent PRs (#4754 , #4777 )
• refactor(rivetkit-core): rename StopReason to ShutdownKind and kill enum fallthroughs #4765
• chore(envoy-client): log command and event payloads #4751
• fix(rivetkit): minor sleep-cleanup follow-ups #4761
• docs(rivetkit): clean up stale setPreventSleep references in docs and JSDoc #4760
• docs(rivetkit): document keepAwake/waitUntil counter-arm race and surface bridge errors #4759
• test(engine): force overdue branch in alarm-during-sleep test with negative offset #4758
• fix(rivetkit-core): return stopping not starting when sleep/destroy called mid-shutdown #4757
• test(rivetkit): remove sleepWithPreventSleep fixture and tests #4756
• test(engine): add regression test for alarm-during-sleep-transition race #4755
• test(rivetkit-core): cover sleep/destroy guards and prevent_sleep no-op #4750
• docs: add keepAwake vs waitUntil table and internal sleep-sequence invariants #4749
• feat(rivetkit): expose c.keepAwake(promise) through native path #4748
• refactor(rivetkit): deprecate setPreventSleep to no-op in TypeScript #4747
• fix(rivetkit-core): enumerate non-drained counters in grace deadline warn log #4746
• fix(rivetkit-core): abort graceful cleanup task when grace deadline elapses #4745
• fix(rivetkit-core): error on sleep/destroy before startup or already-requested #4743
• fix(rivetkit-core): cap SerializeState shutdown timeout at 15s #4742
• refactor(rivetkit-core): remove prevent_sleep field and deprecate set_prevent_sleep to no-op #4741
• fix(api-public): remove orphan import_export actors module #4764
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[claude]

Code Review: refactor(sqlite-storage): rename SqliteOrigin variants for clarity

Overview

This PR renames two SqliteOrigin enum variants for clarity:

• Native → CreatedOnV2: removes the ambiguous "native" label, making it explicit that this actor was created directly in v2 storage format
• MigratingFromV1 → MigrationFromV1InProgress: better communicates the transient/lease-held state during migration

MigratedFromV1 is unchanged (already clearly named). Changes are applied consistently across all production code, tests, and comments.

---

Correctness: Backward Compatibility

The most important question for a rename on a #[derive(Serialize, Deserialize)] enum is whether existing serialized data will still decode correctly. Since serde_bare encodes enum variants by their integer index (not by name), renaming is safe as long as variant order is preserved.

Original and new orderings both maintain:

0 → CreatedOnV2    (was Native)
1 → MigratedFromV1
2 → MigrationFromV1InProgress  (was MigratingFromV1)

Backward compatibility is preserved. ✓

---

Code Quality

• Naming improvement is genuine. CreatedOnV2 is much clearer than Native (native to what?), and MigrationFromV1InProgress clearly signals the transient lease state vs. a terminal state.
• All call sites updated. Logic, tests, and inline comments all consistently use the new names.
• Test name updated correctly. decode_db_head_defaults_legacy_rows_to_created_on_v2_origin is the right rename for decode_db_head_defaults_legacy_rows_to_native_origin.

---

Minor Suggestions

1. Doc comment on the enum itself — The diff shows only the tail of the SqliteOrigin doc comment (lifecycle guarantee instead of file locking or generation ownership fencing). If the full comment names the Native variant explicitly anywhere, it should be updated to CreatedOnV2 for consistency.

2. PR description — The checklist and description fields are still blank. For a refactor like this, a one-liner on the motivation (e.g., "Native was confusing — it didn't convey that the actor was created on v2; MigratingFromV1 was ambiguous about whether it was past or present tense") would help future readers of git blame understand the intent.

---

Summary

Clean, mechanical rename with no logic changes. Serialization compatibility is preserved by maintaining variant order. The new names are meaningfully clearer. No blocking issues.

[NathanFlurry]

Landed in main via stack-merge fast-forward push. Commits are in main; closing to match.

[github-actions]

Preview packages published to npm

Install with:

npm install rivetkit@pr-4814

All packages published as 0.0.0-pr.4814.107a2fc with tag pr-4814.

Engine binary is shipped via @rivetkit/engine-cli on linux-x64-musl, linux-arm64-musl, darwin-x64, and darwin-arm64. Windows users should use the release installer or set RIVET_ENGINE_BINARY.

Docker images:

docker pull rivetdev/engine:slim-107a2fc
docker pull rivetdev/engine:full-107a2fc

Individual packages

npm install rivetkit@pr-4814
npm install @rivetkit/react@pr-4814
npm install @rivetkit/rivetkit-napi@pr-4814
npm install @rivetkit/workflow-engine@pr-4814