Skip to content

skills: sync Immediate.Jobs through ee5f51d - #2

Open
dukesteen wants to merge 1 commit into
mainfrom
skills/sync-immediate-jobs-2026-08-12
Open

skills: sync Immediate.Jobs through ee5f51d#2
dukesteen wants to merge 1 commit into
mainfrom
skills/sync-immediate-jobs-2026-08-12

Conversation

@dukesteen

@dukesteen dukesteen commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Synchronize the Immediate.Jobs preview guidance with source range be75408..ee5f51d (20 commits).
  • Update all seven existing Jobs skills for cancellation, skipped history, dashboard operations, nullable metadata, root-namespace registration, renamed APIs, stable-name triggering, and the fluent configuration model.
  • Add $immediate-jobs:test-storage-provider for the public, framework-neutral storage behavior catalog.
  • Bump only the Jobs plugin to 0.1.0-preview.2; it remains NOT_AVAILABLE, and all eight preview skills keep implicit invocation disabled.
  • Expand activation coverage from 30 to 31 repository skills and record fresh forward-test evidence.
  • Reduce jargon and sentence load while preserving exact API names and safety rules.

Forward-test findings

Fresh-context tests covered custom Redis conformance tests, distributed EF Core configuration, and stable-name recurring dispatch. They refined fixture cleanup, fake-time imports, tag behavior, readiness mapping, and the temporary ee5f51d health-check options bridge.

Validation

  • python3 scripts/validate.py
  • Skill-creator quick validation for all eight Immediate.Jobs skills
  • Three read-only fresh-context forward tests checked against Immediate.Jobs ee5f51d
  • git diff --check

Summary by CodeRabbit

  • New Features

    • Added the test-storage-provider skill for validating custom storage implementations with conformance tests.
    • Added guidance for job cancellation, recurring-job scheduling, dashboard operations, storage configuration, and workflow monitoring.
    • Updated the Immediate.Jobs plugin to preview version 0.1.0-preview.2.
  • Documentation

    • Clarified job contracts, provider capabilities, scheduling behavior, authorization, health checks, testing patterns, and execution outcomes.
    • Added forward-test results and activation coverage documentation for the Jobs skills.

@coderabbitai

coderabbitai Bot commented Aug 12, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

The PR updates Immediate.Jobs preview documentation across registration, storage, scheduling, operations, and testing. It adds the test-storage-provider skill, updates activation prompts, records preview 0.1.0-preview.2, and documents coverage for 31 skills.

Changes

Immediate.Jobs guidance

Layer / File(s) Summary
Registration and storage contracts
plugins/immediate-jobs/skills/configure-storage/..., plugins/immediate-jobs/skills/create-job/...
The documentation now defines generated registration, one-time fluent storage configuration, provider capabilities, persistence shapes, and handler dependencies.
Batch and scheduling workflows
plugins/immediate-jobs/skills/build-workflow/..., plugins/immediate-jobs/skills/schedule-job/..., plugins/immediate-jobs/skills/create-recurring-job/...
The workflows now cover batch outcomes, durable cancellation, fair queues, recurring dispatch, startup reconciliation, tags, and overlap policies.
Operations and observability
plugins/immediate-jobs/skills/operate-jobs/...
The operations guidance now documents dashboard setup, operator authorization, mutations, monitoring, execution history, telemetry, and readiness checks.
Application and storage testing
plugins/immediate-jobs/skills/test-job/..., plugins/immediate-jobs/skills/test-storage-provider/..., tests/activation-prompts.json, tests/README.md
The testing guidance separates in-memory application tests from custom storage-provider conformance tests. It adds the new skill and its activation coverage.
Preview and roadmap metadata
plans/skills.md, plugins/immediate-jobs/.codex-plugin/plugin.json
The roadmap records the eighth skill, preview version 0.1.0-preview.2, invocation restrictions, and activation coverage.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the synchronization of Immediate.Jobs skills through the specified source commit.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch skills/sync-immediate-jobs-2026-08-12

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@tests/README.md`:
- Line 51: Update the test-storage-provider row in the Markdown table so “Queue
| Recurring” does not create an extra column; escape the pipe or represent the
two terms with separate code spans while preserving the existing cell content.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 719e3f5d-fb54-4129-840e-e7ae6645cfdd

📥 Commits

Reviewing files that changed from the base of the PR and between b345995 and b205999.

📒 Files selected for processing (21)
  • plans/skills.md
  • plugins/immediate-jobs/.codex-plugin/plugin.json
  • plugins/immediate-jobs/skills/build-workflow/SKILL.md
  • plugins/immediate-jobs/skills/build-workflow/references/workflow-graphs.md
  • plugins/immediate-jobs/skills/configure-storage/SKILL.md
  • plugins/immediate-jobs/skills/configure-storage/references/storage-matrix.md
  • plugins/immediate-jobs/skills/create-job/SKILL.md
  • plugins/immediate-jobs/skills/create-job/references/job-contract.md
  • plugins/immediate-jobs/skills/create-recurring-job/SKILL.md
  • plugins/immediate-jobs/skills/create-recurring-job/references/recurring-patterns.md
  • plugins/immediate-jobs/skills/operate-jobs/SKILL.md
  • plugins/immediate-jobs/skills/operate-jobs/references/operations-patterns.md
  • plugins/immediate-jobs/skills/schedule-job/SKILL.md
  • plugins/immediate-jobs/skills/schedule-job/references/scheduling-patterns.md
  • plugins/immediate-jobs/skills/test-job/SKILL.md
  • plugins/immediate-jobs/skills/test-job/references/testing-patterns.md
  • plugins/immediate-jobs/skills/test-storage-provider/SKILL.md
  • plugins/immediate-jobs/skills/test-storage-provider/agents/openai.yaml
  • plugins/immediate-jobs/skills/test-storage-provider/references/conformance-suite.md
  • tests/README.md
  • tests/activation-prompts.json

Comment thread tests/README.md

| Skill | Scenario | Result | Guidance refined from the test |
| --- | --- | --- | --- |
| `$immediate-jobs:test-storage-provider` | xUnit catalog for a custom Redis provider with queue and recurring support | Correctly selected `Queue | Recurring` and produced one test row per case | Name the fake-time namespace/package and keep connection, data identifier, service provider, and cleanup in one fixture. |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Escape the pipe in the Markdown table cell.

The Queue | Recurring text is parsed as a fifth column. markdownlint reports five cells for this row, so the guidance column is malformed. Use separate code spans or escape the pipe.

Proposed fix
-  | `$immediate-jobs:test-storage-provider` | xUnit catalog for a custom Redis provider with queue and recurring support | Correctly selected `Queue | Recurring` and produced one test row per case | Name the fake-time namespace/package and keep connection, data identifier, service provider, and cleanup in one fixture. |
+  | `$immediate-jobs:test-storage-provider` | xUnit catalog for a custom Redis provider with queue and recurring support | Correctly selected the `Queue` and `Recurring` capabilities and produced one test row per case | Name the fake-time namespace/package and keep connection, data identifier, service provider, and cleanup in one fixture. |
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
| `$immediate-jobs:test-storage-provider` | xUnit catalog for a custom Redis provider with queue and recurring support | Correctly selected `Queue | Recurring` and produced one test row per case | Name the fake-time namespace/package and keep connection, data identifier, service provider, and cleanup in one fixture. |
| `$immediate-jobs:test-storage-provider` | xUnit catalog for a custom Redis provider with queue and recurring support | Correctly selected the `Queue` and `Recurring` capabilities and produced one test row per case | Name the fake-time namespace/package and keep connection, data identifier, service provider, and cleanup in one fixture. |
🧰 Tools
🪛 markdownlint-cli2 (0.23.2)

[warning] 51-51: Table column count
Expected: 4; Actual: 5; Too many cells, extra data will be missing

(MD056, table-column-count)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@tests/README.md` at line 51, Update the test-storage-provider row in the
Markdown table so “Queue | Recurring” does not create an extra column; escape
the pipe or represent the two terms with separate code spans while preserving
the existing cell content.

Source: Linters/SAST tools

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant