Skip to content

docs: document how our job system works#259

Merged
SgtPooki merged 11 commits intofix/jobs-lock-fixfrom
docs/job-documentation
Feb 11, 2026
Merged

docs: document how our job system works#259
SgtPooki merged 11 commits intofix/jobs-lock-fixfrom
docs/job-documentation

Conversation

@SgtPooki
Copy link
Collaborator

@SgtPooki SgtPooki commented Feb 10, 2026

Summary

  • Added docs/jobs.md to describe how pg-boss jobs work in dealbot, including schedule state, queues, polling, concurrency, and backpressure.
  • Clarified the split between dealbot’s custom scheduler and pg-boss durable queues/worker execution.
  • Documented pg-boss storage/retention behavior and the worker API version mismatch (subscribe vs work).
  • Trimmed docs/runbooks/jobs.md to SOP-only content and added references to the new overview.

Changes

  • Added: docs/jobs.md
  • Updated: docs/runbooks/jobs.md

Notes

  • No code behavior changes; docs-only.
  • pg-boss details reflect current version usage (6.1.0) and note v12 worker API (work/offWork).

fixes #245

@FilOzzy FilOzzy added this to FOC Feb 10, 2026
@github-project-automation github-project-automation bot moved this to 📌 Triage in FOC Feb 10, 2026
@SgtPooki SgtPooki self-assigned this Feb 10, 2026
@rjan90 rjan90 moved this from 📌 Triage to 🔎 Awaiting review in FOC Feb 11, 2026
@rjan90 rjan90 added this to the M4.1: mainnet ready milestone Feb 11, 2026
@rjan90 rjan90 linked an issue Feb 11, 2026 that may be closed by this pull request
* fix: log full pieceCid, CID, and providerAddresses

* chore: fix lint
@BigLep BigLep self-requested a review February 11, 2026 16:01
SgtPooki and others added 9 commits February 11, 2026 11:15
Bumps [tailwind-merge](https://github.com/dcastil/tailwind-merge) from 2.6.0 to 3.4.0.
- [Release notes](https://github.com/dcastil/tailwind-merge/releases)
- [Commits](dcastil/tailwind-merge@v2.6.0...v3.4.0)

---
updated-dependencies:
- dependency-name: tailwind-merge
  dependency-version: 3.4.0
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
…updates (#255)

* chore(deps): bump the npm-dependencies group

Bumps the npm-dependencies group in /apps/backend with 9 updates:

| Package | From | To |
| --- | --- | --- |
| [@nestjs/common](https://github.com/nestjs/nest/tree/HEAD/packages/common) | `11.1.6` | `11.1.13` |
| [@nestjs/config](https://github.com/nestjs/config) | `4.0.2` | `4.0.3` |
| [@nestjs/core](https://github.com/nestjs/nest/tree/HEAD/packages/core) | `11.1.6` | `11.1.13` |
| [@nestjs/platform-express](https://github.com/nestjs/nest/tree/HEAD/packages/platform-express) | `11.1.6` | `11.1.13` |
| [@nestjs/schedule](https://github.com/nestjs/schedule) | `6.0.0` | `6.1.1` |
| [@nestjs/swagger](https://github.com/nestjs/swagger) | `11.2.0` | `11.2.6` |
| [axios](https://github.com/axios/axios) | `1.11.0` | `1.13.5` |
| [undici](https://github.com/nodejs/undici) | `7.16.0` | `7.21.0` |
| [@nestjs/testing](https://github.com/nestjs/nest/tree/HEAD/packages/testing) | `11.1.6` | `11.1.13` |


Updates `@nestjs/common` from 11.1.6 to 11.1.13
- [Release notes](https://github.com/nestjs/nest/releases)
- [Commits](https://github.com/nestjs/nest/commits/v11.1.13/packages/common)

Updates `@nestjs/config` from 4.0.2 to 4.0.3
- [Release notes](https://github.com/nestjs/config/releases)
- [Commits](nestjs/config@4.0.2...4.0.3)

Updates `@nestjs/core` from 11.1.6 to 11.1.13
- [Release notes](https://github.com/nestjs/nest/releases)
- [Commits](https://github.com/nestjs/nest/commits/v11.1.13/packages/core)

Updates `@nestjs/platform-express` from 11.1.6 to 11.1.13
- [Release notes](https://github.com/nestjs/nest/releases)
- [Commits](https://github.com/nestjs/nest/commits/v11.1.13/packages/platform-express)

Updates `@nestjs/schedule` from 6.0.0 to 6.1.1
- [Release notes](https://github.com/nestjs/schedule/releases)
- [Commits](nestjs/schedule@6.0.0...6.1.1)

Updates `@nestjs/swagger` from 11.2.0 to 11.2.6
- [Release notes](https://github.com/nestjs/swagger/releases)
- [Commits](nestjs/swagger@11.2.0...11.2.6)

Updates `axios` from 1.11.0 to 1.13.5
- [Release notes](https://github.com/axios/axios/releases)
- [Changelog](https://github.com/axios/axios/blob/v1.x/CHANGELOG.md)
- [Commits](axios/axios@v1.11.0...v1.13.5)

Updates `undici` from 7.16.0 to 7.21.0
- [Release notes](https://github.com/nodejs/undici/releases)
- [Commits](nodejs/undici@v7.16.0...v7.21.0)

Updates `@nestjs/testing` from 11.1.6 to 11.1.13
- [Release notes](https://github.com/nestjs/nest/releases)
- [Commits](https://github.com/nestjs/nest/commits/v11.1.13/packages/testing)

---
updated-dependencies:
- dependency-name: "@nestjs/common"
  dependency-version: 11.1.13
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-dependencies
- dependency-name: "@nestjs/config"
  dependency-version: 4.0.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-dependencies
- dependency-name: "@nestjs/core"
  dependency-version: 11.1.13
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-dependencies
- dependency-name: "@nestjs/platform-express"
  dependency-version: 11.1.13
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-dependencies
- dependency-name: "@nestjs/schedule"
  dependency-version: 6.1.1
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: npm-dependencies
- dependency-name: "@nestjs/swagger"
  dependency-version: 11.2.6
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: npm-dependencies
- dependency-name: axios
  dependency-version: 1.13.5
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: npm-dependencies
- dependency-name: undici
  dependency-version: 7.21.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: npm-dependencies
- dependency-name: "@nestjs/testing"
  dependency-version: 11.1.13
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: npm-dependencies
...

Signed-off-by: dependabot[bot] <support@github.com>

* chore: update pnpm lock file

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Russell Dempsey <1173416+SgtPooki@users.noreply.github.com>
Bumps [@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node) from 22.19.3 to 25.2.2.
- [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases)
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node)

---
updated-dependencies:
- dependency-name: "@types/node"
  dependency-version: 25.2.2
  dependency-type: direct:development
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Bumps [jsdom](https://github.com/jsdom/jsdom) from 27.4.0 to 28.0.0.
- [Release notes](https://github.com/jsdom/jsdom/releases)
- [Changelog](https://github.com/jsdom/jsdom/blob/main/Changelog.md)
- [Commits](jsdom/jsdom@27.4.0...28.0.0)

---
updated-dependencies:
- dependency-name: jsdom
  dependency-version: 28.0.0
  dependency-type: direct:development
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
* chore(deps): bump pg-boss from 6.2.2 to 12.9.0 in /apps/backend

Bumps [pg-boss](https://github.com/timgit/pg-boss) from 6.2.2 to 12.9.0.
- [Release notes](https://github.com/timgit/pg-boss/releases)
- [Commits](timgit/pg-boss@6.2.2...12.9.0)

---
updated-dependencies:
- dependency-name: pg-boss
  dependency-version: 12.9.0
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>

* fix: use new pg-boss version

* chore: rename batchSize vars

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Russell Dempsey <1173416+SgtPooki@users.noreply.github.com>
@SgtPooki SgtPooki merged commit 051a658 into fix/jobs-lock-fix Feb 11, 2026
6 checks passed
@github-project-automation github-project-automation bot moved this from 🔎 Awaiting review to 🎉 Done in FOC Feb 11, 2026
@BigLep
Copy link
Contributor

BigLep commented Feb 11, 2026

I'm reviewing this in #247

@SgtPooki SgtPooki deleted the docs/job-documentation branch February 11, 2026 22:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: 🎉 Done

Development

Successfully merging this pull request may close these issues.

Document job "design/architecture"

3 participants