chore(deps): update all non-major dependencies (#3138)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore: update serena project configuration

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

chore(deps): update node.js to v24.14.0 (#3137)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

fix(deps): update all non-major dependencies (#3136)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

docs: publish documentation

chore(master): release 5.3.2 (#3130)

* chore(master): release 5.3.2

* [autofix.ci] apply automated fixes

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

chore(deps): lock file maintenance (#3134)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

test: use strict spy call count assertions in worker tests

chore(deps): update dependency rollup to ^4.59.0 (#3133)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

test: skip pool.destroy() in afterAll hooks on CI to avoid timeout

test: use ESM imports in worker threads files

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

test: skip shutdown tests on CI

test: add retry for flaky tests on CI

test: increase vitest timeouts to 240s for slow CI runners

test: use forks pool for better process isolation

test: increase vitest timeouts to 120s

ci(sonar): enable coverage for mjs sources

ci: fix invalid workflow syntax (remove zero-width spaces)

test(worker): add 22 tests for abstract-worker coverage

chore: update rollup to 4.59.0

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

build: rename coverage to test:coverage, remove redundant coverage:html

ci: avoid redundant test runs now that coverage includes build+test

build: add build step to coverage scripts

test: relax coverage thresholds and increase timeouts

docs: add JSDoc types and descriptions to vitest setup

test: fix async kill handler test for vitest compatibility

- Make test async and properly await kill handler completion
- Stub sendToMainWorker to prevent unhandled rejection
- Add assertions for sendToMainWorker call
- Remove sequence.hooks config (not needed)

test: add custom toMatchObject matcher for @std/expect compatibility

Implement custom Vitest matcher that replicates @std/expect's toMatchObject
semantics for arrays. The matcher handles sparse array subset matching where
only defined indices are compared, matching the behavior of @std/expect's
spread-based algorithm in _equal.ts.

This fixes 8 failing tests in queue test files that use toMatchObject with
sparse arrays created via new Array(capacity).

test: update queue test imports to .mjs files

test: update imports to .mjs files

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

fix(build): exclude vitest.config.ts from TypeScript build

The vitest.config.ts file was being included in the TypeScript
compilation via tsconfig.json's **/*.ts include pattern. This caused
rollup-plugin-dts to fail when looking for ./lib/index.d.ts.

Adding vitest.config.ts to the exclude array fixes the build.

test: migrate from mocha to vitest

docs: consolidate multiple task functions features in README

chore(deps): update ajv to 6.14.0

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

fix(deps): update all non-major dependencies (#3131)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

fix(test): use fake timers for sleep() test to avoid flakiness

docs: publish documentation

chore(master): release 5.3.1 (#3129)

* chore(master): release 5.3.1

* [autofix.ci] apply automated fixes

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

fix(iwrr): remove erroneous workerNodeId reset corrupting round-robin state

docs: publish documentation

chore(master): release 5.3.0 (#3125)

* chore(master): release 5.3.0

* [autofix.ci] apply automated fixes

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

chore: remove oh my opencode artifacts

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

chore(deps): security: update minimatch to 10.2.2

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

chore(deps): update all non-major dependencies (#3128)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

feat(pool): add agingFactor and loadExponent tunables to TasksQueueOptions

chore(deps): update all non-major dependencies (#3127)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore: make eslint works again

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

chore: update biome schema version

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

chore(deps): update ajv minimum version to 8.18.0

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

fix(deps): update all non-major dependencies (#3126)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): apply updates

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

docs: publish documentation

ci: add manual documentation publish workflow

ci: use protected token for documentation checkout

chore(master): release 5.2.0 (#3054)

* chore(master): release 5.2.0

* [autofix.ci] apply automated fixes

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

ci: migrate npm publish to OIDC Trusted Publisher

fix: validate workerNodeKeys on worker ready and remove misleading JSDoc

chore(deps): lock file maintenance (#3123)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): update all non-major dependencies (#3122)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

feat: task function worker node affinity  (#2269)

* feat: task function worker node affinity

closes #778

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* refactor: cleanup worker node affinity namespace

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* refactor: validate worker nodes affinity

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* refactor: refine worke nodes affinity validation

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* fix: check worker node keys affinity is part of pool worker nodes

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* fix: fix default task function properties handling

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* test: improve task function objects coverage

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* test: cleanup tests

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* test: fix mismerge

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* refactor: silence linter

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* refactor: code reformatting

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* refactor: code formatting

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* chore: merge eslint-plugin-perfectionist reformatting

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* chore: reenabled lint-staged

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* chore: fix mismerge

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* refactor: code formatting

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* [autofix.ci] apply automated fixes

* [autofix.ci] apply automated fixes (attempt 2/3)

* chore: fix mismerge

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* perf: lighter worker node keys validation on hot path

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* refactor: cleanups

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* [autofix.ci] apply automated fixes

* [autofix.ci] apply automated fixes

* refactor: early exit in worker choice strategies

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* refactor: align unique worker node affinity handling

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* Apply suggestion from @Copilot

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* [autofix.ci] apply automated fixes

* refactor: remove uneeded comment

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* perf: reorder conditions

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* refactor: remove uneeded conditions

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* Apply suggestion from @Copilot

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Apply suggestion from @Copilot

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Apply suggestion from @Copilot

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* perf: add missing optimization

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* refactor: cleanup worker nodes array validation code

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
* fix: add defensive checks for worker node affinity in selection strategies

- Add bounded loops to prevent infinite loops when no valid worker in affinity set
- Add empty/single-key checks in all strategies
- Add comprehensive tests for workerNodeKeys affinity

* fix: add empty array guard and fix iteration in worker node affinity strategies

* refactor(selection-strategies): extract getSingleWorkerNodeKey helper to reduce duplication

Consolidate the early-return pattern for single-element workerNodeKeys
array into a reusable protected method in AbstractWorkerChoiceStrategy.
All 7 selection strategies now use this helper instead of duplicating
the same check and isWorkerNodeReady call.

* fix(selection-strategies): correct affinity handling and optimize to O(1) lookup

- Fix WeightedRoundRobin: check affinity membership before using workerNodeKey
- Fix InterleavedWeightedRR: add wrap-around to find valid workers behind current position
- Optimize: change checkWorkerNodeKeys() to return Set<number> for O(1) .has() lookup
- Update all 7 strategies to use Set.has() instead of Array.includes()

* refactor(iwrr): remove unnecessary wrap-around logic

The retry mechanism in executeStrategy() already handles the case where
choose() returns undefined. Each call advances the position via
interleavedWeightedRoundRobinNextWorkerNodeId(), eventually covering
the entire (roundId, workerNodeId) space.

Removed the interleavedWeightedRoundRobinChoose() helper method and
inlined the logic directly in choose() for simplicity.

* refactor(api): rename workerNodes to workerNodeKeys for clarity

Rename the task function affinity property from 'workerNodes' to
'workerNodeKeys' to avoid confusion with pool.workerNodes (IWorkerNode[])
and align with internal naming conventions where keys refer to indices.

* test(selection-strategies): add workerNodeKeys affinity tests for all strategies

Add comprehensive tests for worker node keys affinity in choose() method:
- Empty workerNodeKeys returns undefined
- Single workerNodeKey returns that key if ready
- Multiple workerNodeKeys respects affinity constraint

Covers: RoundRobin, LeastUsed, LeastBusy, LeastElu, FairShare,
WeightedRoundRobin, InterleavedWeightedRoundRobin strategies

* test(pool): add workerNodeKeys validation and affinity tests

- Add checkValidWorkerNodes edge case tests
- Add addTaskFunction workerNodeKeys validation tests
- Add integration test for execute() workerNodeKeys affinity

* docs: improve workerNodeKeys JSDoc and error messages

- Expand JSDoc for workerNodeKeys parameter across selection strategies
- Improve error message clarity for invalid worker node keys
- Update tests to match improved error messages

* docs: harmonize workerNodeKeys JSDoc at getSingleWorkerNodeKey

* fix(weighted-round-robin): set nextWorkerNodeKey when staying on same worker

* fix(pool): check worker node affinity before returning dynamic worker

* docs: clarify worker node affinity validation behavior

* refactor: rename checkValidWorkerNodes to checkValidWorkerNodeKeys

Align function name, parameter name, and error messages with actual
semantics: the function validates worker node keys (numeric indices),
not worker node objects.

* refactor: eliminate unnecessary Set/Array allocations in worker node affinity hot paths

- Remove workerNodeKeys getter from IPool interface and AbstractPool
- Replace new Set(this.workerNodeKeys) validation with O(1) range checks
- Rename getTaskFunctionWorkerNodes() to getTaskFunctionWorkerNodeKeysSet()
  returning Set<number> directly from source
- Propagate Set<number> through execute() → executeStrategy() → choose()
  eliminating intermediate array-to-Set conversions
- Replace new Set(this.workerNodes.keys()) in sendTaskFunctionOperationToWorkers()
  with direct workerNodes.length/keys() usage

* fix(wrr): update state in single-element affinity shortcut

Reset nextWorkerNodeKey and workerNodeVirtualTaskExecutionTime in the
size === 1 path to maintain consistent round-robin state.

* fix: address Copilot review comments

- Check affinity before creating dynamic worker
- Add null to workerNodeKeys signature
- Fix anchor link and document length constraint

* chore: disable biome formatter in opencode

* perf(strategies): fast path for round-robin without affinity

* test: consolidate worker choice strategies test suite

* test: verify workerNodeKeys transmission from worker constructor

* fix: address Copilot review concerns for worker node affinity

- Snapshot workerNodeKeys in sendTaskFunctionOperationToWorkers to prevent race conditions
- Use ReadonlySet<number> for workerNodeKeysSet in selection strategies for type safety
- Compute workerNodeKeysSet lazily instead of storing in TaskFunctionProperties
- Allow null in workerNodeKeys type to explicitly disable affinity

* fix: improve error message grammar in addTaskFunction validation

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
* fix: validate worker node keys against max pool size and fix single-key state update

- Validate workerNodeKeys against maximumNumberOfWorkers instead of current
  pool size, allowing dynamic pools to reference future worker indices
- Only update nextWorkerNodeKey in RR/WRR single-key path when worker is
  ready, preventing state inconsistency on retry
- Clarify TaskFunctionObject.workerNodeKeys doc regarding null vs undefined

* feat: create dynamic workers to satisfy worker node affinity constraints

In dynamic pools, when a task's workerNodeKeys affinity references
worker nodes beyond the current pool size, automatically create
dynamic workers up to the maximum pool size to satisfy the affinity.

* test: harmonize variable naming in dynamic worker affinity test

* refactor: consolidate worker node keys validation into helper and enforce error types in tests

* fix: remove unused null from workerNodeKeys type and restore test suite title

* docs: mention worker node affinity feature in README

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
* refactor: use project max helper instead of Math.max

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
---------

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

chore(deps): bump markdown-it (#3120)

Bumps the npm_and_yarn group with 1 update in the / directory: [markdown-it](https://github.com/markdown-it/markdown-it).

Updates `markdown-it` from 14.1.0 to 14.1.1
- [Changelog](https://github.com/markdown-it/markdown-it/blob/master/CHANGELOG.md)
- [Commits](https://github.com/markdown-it/markdown-it/compare/14.1.0...14.1.1)

---
updated-dependencies:
- dependency-name: markdown-it
  dependency-version: 14.1.1
  dependency-type: indirect
  dependency-group: npm_and_yarn
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

chore(deps): update dependency typedoc to ^0.28.17 (#3121)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): update all non-major dependencies (#3119)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): lock file maintenance (#3118)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): update pnpm to v10.29.2 (#3117)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore: update biome configuration schema version

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

fix(deps): update all non-major dependencies (#3116)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

fix(deps): update all non-major dependencies (#3114)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

fix(deps): update dependency nodemailer to v8 (#3112)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): update all non-major dependencies (#3113)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): update all non-major dependencies (#3111)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): update all non-major dependencies (#3110)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): bump @isaacs/brace-expansion (#3109)

Bumps the npm_and_yarn group with 1 update in the / directory: @isaacs/brace-expansion.

Updates `@isaacs/brace-expansion` from 5.0.0 to 5.0.1

---
updated-dependencies:
- dependency-name: "@isaacs/brace-expansion"
  dependency-version: 5.0.1
  dependency-type: indirect
  dependency-group: npm_and_yarn
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

chore(deps): update autofix-ci/action digest to 7a166d7 (#3107)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

fix(deps): update all non-major dependencies (#3108)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): lock file maintenance (#3106)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): update all non-major dependencies (#3105)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore: update serena project configuration

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

chore: update biome configuration schema to 2.3.13

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

chore(deps): lock file maintenance (#3101)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

fix(deps): update all non-major dependencies (#3104)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

build: update biome to 2.3.12

chore(deps): update all non-major dependencies (#3103)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): update all non-major dependencies (#3102)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

fix(examples): type warnings at build

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

fix(deps): update all non-major dependencies (#3100)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore: remove npm registry-url from release-please workflow

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

chore(deps): lock file maintenance (#3099)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

Merge pull request #3098 from poolifier/renovate/all-minor-patch

chore(deps): update all non-major dependencies

chore(deps): update all non-major dependencies

chore(deps): update dependency @types/node to ^24.10.7 (#3097)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore: refine renovate configuration

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

chore(deps): update all non-major dependencies (#3095)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

Merge pull request #3096 from poolifier/renovate/eslint-plugin-jsdoc-62.x

chore(deps): update dependency eslint-plugin-jsdoc to v62

chore(deps): update dependency eslint-plugin-jsdoc to v62

chore: migrate biome configuration to 2.3.11

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

chore(deps): lock file maintenance (#3094)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

fix(deps): update all non-major dependencies (#3093)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): lock file maintenance (#3090)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): update dependency globals to v17 (#3092)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

chore(deps): update all non-major dependencies (#3091)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>