solid_queue_mongoid 0.3.0

data/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

data/.idea/workspace.xml

@@ -0,0 +1,353 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="0db87873-4844-479c-9630-707075e3936d" name="Changes" comment="fixed rubcop checks">
+      <change afterPath="$PROJECT_DIR$/release.sh" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.gitignore" beforeDir="false" afterPath="$PROJECT_DIR$/.gitignore" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
+    </list>
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="CopilotPersistence">
+    <persistenceIdMap>
+      <entry key="_/Users/washu/Projects/solid_queue_mongoid" value="3A5aHVkneKWdrN6NV4g9P2LgO6o" />
+    </persistenceIdMap>
+  </component>
+  <component name="CopilotUserSelectedChatMode">
+    <option name="chatModeId" value="Agent" />
+  </component>
+  <component name="CopilotUserSelectedModel">
+    <selectedModels>
+      <entry key="chat-panel" value="Claude Sonnet 4.6" />
+      <entry key="agent-panel" value="Claude Sonnet 4.6" />
+    </selectedModels>
+  </component>
+  <component name="EmbeddingIndexingInfo">
+    <option name="cachedIndexableFilesCount" value="11744" />
+    <option name="fileBasedEmbeddingIndicesEnabled" value="true" />
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
+  </component>
+  <component name="GitHubPullRequestSearchHistory">{
+  &quot;lastFilter&quot;: {
+    &quot;state&quot;: &quot;OPEN&quot;,
+    &quot;assignee&quot;: &quot;washu&quot;
+  }
+}</component>
+  <component name="GithubPullRequestsUISettings">{
+  &quot;selectedUrlAndAccountId&quot;: {
+    &quot;url&quot;: &quot;https://github.com/washu/solid_queue_mongoid.git&quot;,
+    &quot;accountId&quot;: &quot;21ad5f89-a1de-402b-a894-c99929c1dfc3&quot;
+  }
+}</component>
+  <component name="McpProjectServerCommands">
+    <commands />
+    <urls />
+  </component>
+  <component name="ProjectColorInfo">{
+  &quot;associatedIndex&quot;: 1
+}</component>
+  <component name="ProjectId" id="3A5aHVkneKWdrN6NV4g9P2LgO6o" />
+  <component name="ProjectLevelVcsManager">
+    <ConfirmationsSetting value="2" id="Add" />
+  </component>
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "ModuleVcsDetector.initialDetectionPerformed": "true",
+    "RSpec.All specs in spec: solid_queue_mongoid.executor": "Run",
+    "RSpec.solid_queue_mongoid_spec.executor": "Run",
+    "RunOnceActivity.MCP Project settings loaded": "true",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "RunOnceActivity.git.unshallow": "true",
+    "RunOnceActivity.ruby.rubocop.migration.global.runOnSaveToExternalFormatter": "true",
+    "RunOnceActivity.typescript.service.memoryLimit.init": "true",
+    "SHARE_PROJECT_CONFIGURATION_FILES": "true",
+    "codeWithMe.voiceChat.enabledByDefault": "false",
+    "com.intellij.lang.ruby.rbs.tools.collection.workspace.sync.RbsCollectionUpdateProjectActivity#LAST_UPDATE_TIMESTAMP": "1775988654904",
+    "com.intellij.ml.llm.matterhorn.ej.ui.settings.DefaultModelSelectionForGA.v1": "true",
+    "git-widget-placeholder": "main",
+    "junie.onboarding.icon.badge.shown": "true",
+    "node.js.detected.package.eslint": "true",
+    "node.js.detected.package.tslint": "true",
+    "node.js.selected.package.eslint": "(autodetect)",
+    "node.js.selected.package.tslint": "(autodetect)",
+    "nodejs_package_manager_path": "npm",
+    "settings.editor.selected.configurable": "ml.llm.AcpAgentsConfigurable",
+    "to.speed.mode.migration.done": "true",
+    "vue.rearranger.settings.migration": "true"
+  }
+}]]></component>
+  <component name="RunManager" selected="RSpec.All specs in spec: solid_queue_mongoid">
+    <configuration name="All specs in spec: solid_queue_mongoid" type="RSpecRunConfigurationType" factoryName="RSpec" temporary="true">
+      <module name="solid_queue_mongoid" />
+      <predefined_log_file enabled="true" id="RUBY_RSPEC" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUBY_ARGS" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="WORK DIR" VALUE="$MODULE_DIR$" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SHOULD_USE_SDK" VALUE="false" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="ALTERN_SDK_NAME" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="myPassParentEnvs" VALUE="true" />
+      <envs>
+        <env name="JRUBY_OPTS" value="-X+O" />
+      </envs>
+      <EXTENSION ID="BundlerRunConfigurationExtension" BUNDLE_MODE="AUTO" bundleExecEnabled="true" />
+      <EXTENSION ID="RubyCoverageRunConfigurationExtension" track_test_folders="true" runner="rcov" ENABLE_BRANCH_COVERAGE="true" ENABLE_FORKED_COVERAGE="true">
+        <COVERAGE_PATTERN ENABLED="true">
+          <PATTERN REGEXPS="/.rvm/" INCLUDED="false" />
+        </COVERAGE_PATTERN>
+      </EXTENSION>
+      <EXTENSION ID="org.jetbrains.plugins.ruby.rails.run.RailsRunConfigurationExtension" SCRATCH_USE_RAILS_RUNNER="false" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TESTS_FOLDER_PATH" VALUE="$MODULE_DIR$/spec" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATH" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATHS" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_RUNNER_PATH" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_FILE_MASK" VALUE="**/*_spec.rb" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_EXAMPLE_NAME" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="USE_EXAMPLE_MATCHES" VALUE="false" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="LINE_NUMBER_EXAMPLE_IDS" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_TEST_TYPE" VALUE="ALL_IN_FOLDER" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_ARGS" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUNNER_VERSION" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="USE_CUSTOM_SPEC_RUNNER" VALUE="false" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPRING" VALUE="false" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="FULL_BACKTRACE" VALUE="false" />
+      <method v="2" />
+    </configuration>
+    <configuration name="Unnamed" type="RSpecRunConfigurationType" factoryName="RSpec" nameIsGenerated="true">
+      <module name="solid_queue_mongoid" />
+      <predefined_log_file enabled="true" id="RUBY_RSPEC" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUBY_ARGS" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="WORK DIR" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SHOULD_USE_SDK" VALUE="false" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="ALTERN_SDK_NAME" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="myPassParentEnvs" VALUE="true" />
+      <EXTENSION ID="BundlerRunConfigurationExtension" BUNDLE_MODE="AUTO" bundleExecEnabled="true" />
+      <EXTENSION ID="RubyCoverageRunConfigurationExtension" track_test_folders="true" runner="rcov" ENABLE_BRANCH_COVERAGE="true" ENABLE_FORKED_COVERAGE="true">
+        <COVERAGE_PATTERN ENABLED="true">
+          <PATTERN REGEXPS="/.rvm/" INCLUDED="false" />
+        </COVERAGE_PATTERN>
+      </EXTENSION>
+      <EXTENSION ID="org.jetbrains.plugins.ruby.rails.run.RailsRunConfigurationExtension" SCRATCH_USE_RAILS_RUNNER="false" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TESTS_FOLDER_PATH" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATH" VALUE="$MODULE_DIR$/spec/solid_queue_mongoid_spec.rb" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATHS" VALUE="$MODULE_DIR$/spec/solid_queue_mongoid_spec.rb" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_RUNNER_PATH" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_FILE_MASK" VALUE="**/*_spec.rb" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_EXAMPLE_NAME" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="USE_EXAMPLE_MATCHES" VALUE="false" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="LINE_NUMBER_EXAMPLE_IDS" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_TEST_TYPE" VALUE="TEST_SCRIPT" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_ARGS" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUNNER_VERSION" VALUE="" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="USE_CUSTOM_SPEC_RUNNER" VALUE="false" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPRING" VALUE="false" />
+      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="FULL_BACKTRACE" VALUE="false" />
+      <method v="2" />
+    </configuration>
+    <recent_temporary>
+      <list>
+        <item itemvalue="RSpec.All specs in spec: solid_queue_mongoid" />
+      </list>
+    </recent_temporary>
+  </component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-js-predefined-d6986cc7102b-3bd3a6803838-JavaScript-RM-261.22158.284" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="SpringUtil" SPRING_PRE_LOADER_OPTION="true" RAKE_SPRING_PRE_LOADER_OPTION="true" RAILS_SPRING_PRE_LOADER_OPTION="true" />
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="0db87873-4844-479c-9630-707075e3936d" name="Changes" comment="" />
+      <created>1709835909198</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1709835909198</updated>
+      <workItem from="1771884800365" duration="984000" />
+      <workItem from="1772027623938" duration="3911000" />
+      <workItem from="1772032095816" duration="7274000" />
+      <workItem from="1774875815039" duration="26961000" />
+      <workItem from="1775756584942" duration="17331000" />
+      <workItem from="1775842470364" duration="3731000" />
+      <workItem from="1775988596194" duration="179000" />
+    </task>
+    <task id="LOCAL-00001" summary="initial commit udpate">
+      <option name="closed" value="true" />
+      <created>1772036577668</created>
+      <option name="number" value="00001" />
+      <option name="presentableId" value="LOCAL-00001" />
+      <option name="project" value="LOCAL" />
+      <updated>1772036577668</updated>
+    </task>
+    <task id="LOCAL-00002" summary="initial commit udpate 2 some more specs and test fixes">
+      <option name="closed" value="true" />
+      <created>1772039692870</created>
+      <option name="number" value="00002" />
+      <option name="presentableId" value="LOCAL-00002" />
+      <option name="project" value="LOCAL" />
+      <updated>1772039692870</updated>
+    </task>
+    <task id="LOCAL-00003" summary="initial commit udpate 3 should al lbe fixes">
+      <option name="closed" value="true" />
+      <created>1774992658037</created>
+      <option name="number" value="00003" />
+      <option name="presentableId" value="LOCAL-00003" />
+      <option name="project" value="LOCAL" />
+      <updated>1774992658037</updated>
+    </task>
+    <task id="LOCAL-00004" summary="commit 3, should be on parity with solid_queue">
+      <option name="closed" value="true" />
+      <created>1775823236207</created>
+      <option name="number" value="00004" />
+      <option name="presentableId" value="LOCAL-00004" />
+      <option name="project" value="LOCAL" />
+      <updated>1775823236207</updated>
+    </task>
+    <task id="LOCAL-00005" summary="commit 3, should be on parity with solid_queue">
+      <option name="closed" value="true" />
+      <created>1775823276452</created>
+      <option name="number" value="00005" />
+      <option name="presentableId" value="LOCAL-00005" />
+      <option name="project" value="LOCAL" />
+      <updated>1775823276452</updated>
+    </task>
+    <task id="LOCAL-00006" summary="commit 4, should be on parity with solid_queue 1.4 now.">
+      <option name="closed" value="true" />
+      <created>1775825394426</created>
+      <option name="number" value="00006" />
+      <option name="presentableId" value="LOCAL-00006" />
+      <option name="project" value="LOCAL" />
+      <updated>1775825394426</updated>
+    </task>
+    <task id="LOCAL-00007" summary="0.2.0 commit, see README and CHANGELOG">
+      <option name="closed" value="true" />
+      <created>1775825725408</created>
+      <option name="number" value="00007" />
+      <option name="presentableId" value="LOCAL-00007" />
+      <option name="project" value="LOCAL" />
+      <updated>1775825725408</updated>
+    </task>
+    <task id="LOCAL-00008" summary="0.2.0 commit, see README and CHANGELOG">
+      <option name="closed" value="true" />
+      <created>1775842856878</created>
+      <option name="number" value="00008" />
+      <option name="presentableId" value="LOCAL-00008" />
+      <option name="project" value="LOCAL" />
+      <updated>1775842856878</updated>
+    </task>
+    <task id="LOCAL-00009" summary="0.2.0 commit, see README and CHANGELOG">
+      <option name="closed" value="true" />
+      <created>1775843002306</created>
+      <option name="number" value="00009" />
+      <option name="presentableId" value="LOCAL-00009" />
+      <option name="project" value="LOCAL" />
+      <updated>1775843002306</updated>
+    </task>
+    <task id="LOCAL-00010" summary="0.2.0 commit, see README and CHANGELOG">
+      <option name="closed" value="true" />
+      <created>1775843184405</created>
+      <option name="number" value="00010" />
+      <option name="presentableId" value="LOCAL-00010" />
+      <option name="project" value="LOCAL" />
+      <updated>1775843184405</updated>
+    </task>
+    <task id="LOCAL-00011" summary="0.2.0 commit, see README and CHANGELOG">
+      <option name="closed" value="true" />
+      <created>1775843323123</created>
+      <option name="number" value="00011" />
+      <option name="presentableId" value="LOCAL-00011" />
+      <option name="project" value="LOCAL" />
+      <updated>1775843323123</updated>
+    </task>
+    <task id="LOCAL-00012" summary="CI fixes">
+      <option name="closed" value="true" />
+      <created>1775843771409</created>
+      <option name="number" value="00012" />
+      <option name="presentableId" value="LOCAL-00012" />
+      <option name="project" value="LOCAL" />
+      <updated>1775843771409</updated>
+    </task>
+    <task id="LOCAL-00013" summary="fixed rubcop checks">
+      <option name="closed" value="true" />
+      <created>1775843990017</created>
+      <option name="number" value="00013" />
+      <option name="presentableId" value="LOCAL-00013" />
+      <option name="project" value="LOCAL" />
+      <updated>1775843990017</updated>
+    </task>
+    <task id="LOCAL-00014" summary="fixed rubcop checks">
+      <option name="closed" value="true" />
+      <created>1775847032971</created>
+      <option name="number" value="00014" />
+      <option name="presentableId" value="LOCAL-00014" />
+      <option name="project" value="LOCAL" />
+      <updated>1775847032971</updated>
+    </task>
+    <task id="LOCAL-00015" summary="fixed rubcop checks">
+      <option name="closed" value="true" />
+      <created>1775847637059</created>
+      <option name="number" value="00015" />
+      <option name="presentableId" value="LOCAL-00015" />
+      <option name="project" value="LOCAL" />
+      <updated>1775847637059</updated>
+    </task>
+    <option name="localTasksCounter" value="16" />
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+  <component name="Vcs.Log.Tabs.Properties">
+    <option name="TAB_STATES">
+      <map>
+        <entry key="MAIN">
+          <value>
+            <State />
+          </value>
+        </entry>
+      </map>
+    </option>
+  </component>
+  <component name="VcsContentAnnotationSettings">
+    <option name="myLimit" value="2678400000" />
+  </component>
+  <component name="VcsManagerConfiguration">
+    <MESSAGE value="initial commit udpate" />
+    <MESSAGE value="initial commit udpate 2 some more specs and test fixes" />
+    <MESSAGE value="initial commit udpate 3 should al lbe fixes" />
+    <MESSAGE value="commit 3, should be on parity with solid_queue" />
+    <MESSAGE value="commit 4, should be on parity with solid_queue 1.4 now." />
+    <MESSAGE value="0.2.0 commit, see README and CHANGELOG" />
+    <MESSAGE value="CI fixes" />
+    <MESSAGE value="fixed rubcop checks" />
+    <option name="LAST_COMMIT_MESSAGE" value="fixed rubcop checks" />
+  </component>
+  <component name="XSLT-Support.FileAssociations.UIState">
+    <expand />
+    <select />
+  </component>
+  <component name="com.intellij.coverage.CoverageDataManagerImpl">
+    <SUITE FILE_PATH="coverage/solid_queue_mongoid@All_specs_in_spec__solid_queue_mongoid.rcov" NAME="All specs in spec: solid_queue_mongoid Coverage Results" MODIFIED="1772039391662" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="rcov" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" MODULE_NAME="solid_queue_mongoid" />
+    <SUITE FILE_PATH="coverage/solid_queue_mongoid@solid_queue_mongoid_spec.rcov" NAME="solid_queue_mongoid_spec Coverage Results" MODIFIED="1772032125659" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="rcov" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" MODULE_NAME="solid_queue_mongoid" />
+  </component>
+  <component name="github-copilot-workspace">
+    <instructionFileLocations>
+      <option value=".github/instructions" />
+    </instructionFileLocations>
+    <promptFileLocations>
+      <option value=".github/prompts" />
+    </promptFileLocations>
+  </component>
+</project>

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,47 @@
+AllCops:
+  TargetRubyVersion: 3.2
+  NewCops: disable
+  SuggestExtensions: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+# Internal library classes don't need doc comments
+Style/Documentation:
+  Enabled: false
+
+# Class vars are used intentionally via mattr_accessor
+Style/ClassVars:
+  Enabled: false
+
+# RSpec blocks are inherently long; rake tasks too
+Metrics/BlockLength:
+  Exclude:
+    - "spec/**/*"
+    - "lib/tasks/**/*"
+    - "**/*.gemspec"
+
+# Some methods are inherently complex (MongoDB transaction stubs, etc.)
+Metrics/MethodLength:
+  Max: 25
+
+Metrics/AbcSize:
+  Max: 25
+
+Metrics/CyclomaticComplexity:
+  Max: 12
+
+Metrics/PerceivedComplexity:
+  Max: 12
+
+Metrics/ClassLength:
+  Max: 200
+
+Metrics/ModuleLength:
+  Max: 150
+
+Metrics/ParameterLists:
+  Max: 7

data/ARCHITECTURE.md

@@ -0,0 +1,91 @@
+# Architecture
+
+## Overview
+
+`solid_queue_mongoid` provides Mongoid-based models that mirror the structure of SolidQueue's ActiveRecord models. This allows SolidQueue to work with MongoDB instead of PostgreSQL/MySQL/SQLite.
+
+## Design Approach
+
+### Why Not Adapter Pattern?
+
+SolidQueue's models inherit from `ActiveRecord::Base` and use ActiveRecord-specific features throughout (transactions, locking, `insert_all`, etc.). An adapter pattern would be extremely complex and fragile.
+
+### Model Replacement Strategy
+
+Instead, we:
+
+1. **Reimplement models** using Mongoid that match SolidQueue's API surface
+2. **Load before SolidQueue** and prevent SolidQueue's AR models from loading
+3. **Maintain API compatibility** so business logic works unchanged
+4. **Mirror structure** so updates from SolidQueue can be easily ported
+
+## Staying in Sync with SolidQueue
+
+### When SolidQueue Updates
+
+1. Check SolidQueue's CHANGELOG
+2. For **business logic changes** in model methods → port to our models
+3. For **new fields** → add to our Mongoid field definitions
+4. For **new indexes** → add Mongoid index declarations
+5. For **new models** → create equivalent Mongoid model
+
+### What We Don't Need to Port
+
+- Database migrations (we use Mongoid schema)
+- ActiveRecord-specific code (transactions, locking strategies)
+- SQL-specific optimizations
+
+### Testing Compatibility
+
+Run SolidQueue's test suite against our Mongoid models to ensure API compatibility.
+
+## Key Differences from ActiveRecord
+
+### Transactions
+MongoDB transactions require replica sets. We fall back to non-transactional operation when not available.
+
+### Locking
+- `FOR UPDATE SKIP LOCKED` → Not available in MongoDB
+- We use atomic operations (`$inc`, `findAndModify`) instead
+
+### Bulk Operations
+- `insert_all` → Individual inserts (MongoDB has `insertMany` but Mongoid doesn't expose it the same way)
+- `upsert_all` → Individual find_one_and_replace operations
+
+### IDs
+- ActiveRecord uses `bigint` IDs
+- Mongoid uses `BSON::ObjectId`
+- This affects foreign key relationships
+
+## Module Structure
+
+```
+lib/solid_queue_mongoid/
+  models/
+    record.rb                    # Base model (replaces AR::Base)
+    job.rb                       # Job model
+    job/
+      executable.rb              # Mirrors SolidQueue::Job::Executable
+      clearable.rb              # Mirrors SolidQueue::Job::Clearable
+      ...
+    execution.rb                 # Base execution
+    ready_execution.rb           # Ready jobs
+    claimed_execution.rb         # In-progress jobs
+    ...
+```
+
+Each file mirrors its SolidQueue counterpart in `app/models/solid_queue/`.
+
+## Version Compatibility
+
+| SolidQueue Version | solid_queue_mongoid Version | Status |
+|--------------------|----------------------------|---------|
+| 1.0.x - 1.3.x     | 0.1.0                      | Initial implementation |
+
+## Contributing
+
+When porting changes from SolidQueue:
+
+1. Reference the SolidQueue commit/PR
+2. Explain any deviations due to MongoDB differences
+3. Update this document if architectural changes are needed

data/CHANGELOG.md

@@ -0,0 +1,27 @@
+## [Unreleased]
+
+## [0.3.0] - 2026-04-10
+
+### Changed
+- `fixed CI.yml`
+- `fixed Rubocop settings and results.`
+
+## [0.2.0] - 2026-04-10
+
+### Added
+- `RecurringTask.create_dynamic_task(key, **options)` — create recurring tasks at runtime without restarting the scheduler (solid_queue 1.4.0 parity)
+- `RecurringTask.delete_dynamic_task(key)` — remove a dynamic recurring task at runtime
+- `RecurringTask.dynamic` scope — query tasks created dynamically (`static: false`)
+- `RecurringTask` validates that `class_name` resolves to an existing class (`ensure_existing_job_class`)
+- `Record.use_index(*indexes)` — translates solid_queue MySQL index hints to MongoDB `.hint()` calls via a per-model `INDEX_HINTS` mapping; no-op for unknown index names
+
+### Changed
+- `RecurringTask.from_configuration` now accepts `static:` option (defaults `true`); previously hardcoded
+- `BlockedExecution` indexes updated to match solid_queue 1.4.0 schema: `(concurrency_key, priority, job_id)` for release queries and `(expires_at, concurrency_key)` for maintenance
+- `BlockedExecution::INDEX_HINTS` maps solid_queue MySQL index names to their MongoDB equivalents so `use_index` hints are applied correctly
+- `BlockedExecution.release_one` no longer wraps in an outer `Mongoid.transaction` (MongoDB does not support nested sessions; `#release` already manages its own transaction)
+- Minimum `solid_queue` version tightened from `~> 1.0` to `>= 1.4.0, < 2.0`
+
+## [0.1.0] - 2026-02-23
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations