# dsg-core

This repository contains the code for the core functionalities of the DSG backend: metadata, data, version-control.

## Docs

- `docs/query-item-graph-api.md`
- `docs/extend-query-item-graph.md`
- `docs/alignment-background-isolation-2026-04.md` — April 2026 notes on background alignment traffic, auth hardening, and why some graph/search failures were actually auth-admission failures.

## Init Auth

This service has a dependency on the auth service. To register this service in the auth service, run the following command:

``` bash
# ORG_UID is the organization_uid of the organization that this service belongs to
# AUTH_SERVICE_TOKEN is the token generated by the auth service to register this service
make init-auth ORG_UID="0000-0000-0000-0000" AUTH_SERVICE_TOKEN="token"
```

## Coverage Summary

To print a readable summary from the committed Cobertura report in [tests/coverage.xml](/Users/server/GitHub/dsg/dsg-core/tests/coverage.xml), run:

```bash
make coverage-summary
```
