DebtWatch

Track intentional technical debt before it becomes permanent.

npx debtwatch init
npx debtwatch scan

Declare a shortcut with a reason, an owner, and an expiration date:

// debtwatch:start
// id: DEBT-184
// owner: integrations
// expires: 2026-11-01
// reason: Temporary HubSpot v2 compatibility layer
// debtwatch:end

Then enforce it in CI:

npx debtwatch check

check fails on declarations missing an id, owner, reason, or expiration. It does not fail on overdue debt — a date passing is not a code change, and it should never turn someone else's unrelated pull request red. Expiry is enforced by a scheduled run:

npx debtwatch check --enforce-expiry

Full documentation: https://gitlab.com/jojithedev/debtwatch

Apache-2.0