test: add worker metrics tests and coverage infrastructure

[guibeira]

• Add worker-metrics and otel-worker-gauges unit tests for Node SDK
• Add worker_metrics and otel_worker_gauges unit tests for Python SDK
• Configure vitest coverage (v8 provider, 70% thresholds) for Node SDK
• Configure pytest-cov (70% threshold) for Python SDK
• Update CI workflow to run tests with coverage reporting
• Add coverage output directories to .gitignore

Original pr:
iii-hq/sdk#37

Summary by CodeRabbit

• Tests

  • Added extensive tests for worker metrics collection and OTEL gauge integration across Node.js and Python SDKs.

• Chores

  • CI updated to run coverage-enabled tests (step renamed to "Run tests with coverage").
  • Coverage tooling and configuration added with a 70% threshold for Node.js and Python.
  • Ignore rules added to exclude coverage artifacts.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5849d107-8937-4af4-b0bc-97654febe998

📥 Commits

Reviewing files that changed from the base of the PR and between 1741f4d and eebd446.

⛔ Files ignored due to path filters (1)

• pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

📒 Files selected for processing (4)

• .github/workflows/ci.yml
• .gitignore
• sdk/packages/node/iii/package.json
• sdk/packages/python/iii/pyproject.toml

🚧 Files skipped from review as they are similar to previous changes (1)

• .gitignore

---

📝 Walkthrough

Walkthrough

Adds test coverage tooling and configs, updates CI to run coverage-enabled tests, extends .gitignore for coverage outputs, and introduces Node and Python unit tests for worker metrics and OTEL gauge behavior.

Changes

Cohort / File(s)	Summary
CI & Ignore \.github/workflows/ci.yml, \.gitignore	Renamed CI test steps to run coverage-enabled commands; added .coverage, coverage/, and htmlcov/ to .gitignore.
Node SDK — Scripts & Coverage Config sdk/packages/node/iii/package.json, sdk/packages/node/iii/vitest.config.ts	Added test:coverage script and @vitest/coverage-v8 devDependency; configured Vitest coverage provider, reporters, output dir, excludes, and 70% thresholds.
Node SDK — Tests sdk/packages/node/iii/tests/otel-worker-gauges.test.ts, sdk/packages/node/iii/tests/worker-metrics.test.ts	Added unit tests for OTEL worker gauge registration/observation and WorkerMetricsCollector collection/stop lifecycle, including edge cases and mocked metrics.
Python SDK — Coverage Config sdk/packages/python/iii/pyproject.toml	Added pytest-cov dev dependency and tool.pytest.ini_options for coverage flags and fail-under 70%.
Python SDK — Tests sdk/packages/python/iii/tests/test_worker_metrics.py	Added tests for platform-specific memory reads, CPU/uptime calculations, caching, and gauge registration/lifecycle using monkeypatching and test doubles.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• WIP feat: support additional HTTP methods in API route registration #100 — Adds tests for OTEL worker gauges and worker-metrics covering similar registration and collection behavior.

Suggested reviewers

• sergiofilhowz
• andersonleal

Poem

🐇 I nibble bytes where coverage blooms at night,

I hop through tests to make the metrics right.
Gauges buzz, collectors keep the pace,
From Node to Python I bound in grace —
A fluffy stamp for signals passing bright.

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'test: add worker metrics tests and coverage infrastructure' accurately and concisely describes the main changes: adding unit tests for worker metrics and setting up coverage infrastructure for both Node and Python SDKs.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch improve-test-coverage-sdk

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[ytallo]

The new test coverage is useful, but making --cov-fail-under=70 part of global pytest addopts will affect every local test invocation. Please move that coverage gate to CI or a dedicated coverage command so focused local runs do not fail for unrelated reasons.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
iii-docs	Ready	Preview, Comment	Mar 9, 2026 11:20pm
motia-docs	Ready	Preview, Comment	Mar 9, 2026 11:20pm