mine-observability-deps
Mine observability-related package.json dependencies; read-only metrics
# mine-observability-deps
**Pro** read-only mining codemod. Inventories curated observability-related dependencies in `package.json` manifests. Does not modify source.
## Metrics
Emits `observability_finding` and `observability_finding_summary`.
### Shared cardinalities (`observability_finding`)
| Cardinality | Values / meaning |
|-------------|------------------|
| `category` | Always `deps` |
| `finding_type` | See table below |
| `severity` | `info`, `low`, `medium`, or `high` |
| `automatable` | Always `true` (manifest-only) |
| `priority_hint` | `15`–`90` |
| `migration_lane` | `keep`, `export_to_datadog`, `replace`, or `review` |
| `rule_id` | Always `DEPS-001` |
| `file`, `line` | Path to `package.json` and line of the dependency pair |
| `symbol` | npm package name |
| `package` | Owning workspace package path when recognizable |
| `dep_block` | `dependencies`, `devDependencies`, `optionalDependencies`, or `peerDependencies` |
| `declared_version` | Version range from the manifest |
`observability_finding_summary` keeps only `category`, `finding_type`, `severity`, `migration_lane`.
### `finding_type` values
| `finding_type` | Matched packages (examples) | Typical `migration_lane` |
|----------------|----------------------------|--------------------------|
| `dep_opentelemetry` | `@opentelemetry/*` | `export_to_datadog` |
| `dep_prom_client` | `prom-client` | `replace` |
| `dep_winston` | `winston`, `winston-transport` | `keep` |
| `dep_dd_trace` | `dd-trace` | `review` |
| `dep_datadog_sdk` | `@datadog/*`, `datadog-metrics` | `keep` / `review` |
| `dep_datadog_plugin` | `@roadiehq/backstage-plugin-datadog*` | `keep` |
| `dep_sentry` | `@sentry/*`, `@backstage-community/plugin-sentry*` | `review` |
| `dep_grafana_plugin` | `@backstage-community/plugin-grafana*` | `review` |
| `dep_jaeger_plugin` | `@backstage-community/plugin-jaeger*` | `replace` |
| `dep_newrelic_plugin` | `@backstage-community/plugin-newrelic*` | `replace` |