# Repository Inventory

## Summary

The canonical list of Aetos repositories covered by the CI and versioning
standards, with the artifact each one produces, its version source, and its
Drone shape. Every entry maps to the contract in
[91 – Versioning & Changelog](91_versioning_and_changelog.md) and the three CI
files in [90 – Drone Pipelines](90_drone_pipelines.md).

The same data is published machine-readably as the `registry://repos` MCP
resource (and the `list_repos` tool), sourced from `standards/src/repos.json`.
Paths are relative to the `aetos/` workspace root.

---

## Packages (Type A — PyPI)

A wheel + sdist published to the private index. Version source is
`pyproject.toml`; Drone file is `python-lib.yaml` (tag-triggered).

| Repo | Path | Docs | MCP server |
|------|------|------|------------|
| `dagpipe` | `dagpipe` | lib, wiki | `dagpipe:8006` |
| `doc-forge` | `doc-forge` | lib, wiki | `docforge:8001` |
| `hexa` | `hexa` | lib, wiki | `hexa:8008` |
| `mail-intake` | `mail-intake` | lib, wiki | `mail_intake:8002` |
| `mongo-ops` | `mongo-ops` | lib, wiki | `mongo_ops:8007` |
| `omniread` | `omniread` | lib, wiki | `omniread:8003` |
| `openapi-first` | `openapi-first` | lib, wiki | `openapi_first:8004` |
| `py-jwt` | `py-jwt` | lib, wiki | `jwtlib:8005` |

---

## Packages (Type B — npm)

A package published to the private npm registry (`npm.aetoskia.com`). Version
source is `package.json`; Drone file is `npm-lib.yaml` (tag-triggered).

| Repo | Path | Docs | MCP server |
|------|------|------|------------|
| `doc-weaver` | `doc-weaver` | lib, wiki | `doc-weaver:8010` |
| `react-auth` | `react/react-auth` | lib, wiki | `react-auth:8011` |
| `react-openapi` | `react/react-openapi` | lib, wiki | `react-openapi:8012` |

---

## Services (Type C)

A container image pushed to the registry and run on the Docker host. Version
source is the `VERSION` file; Drone file is `service-docker.yaml`.

| Repo | Path | Trigger | Docs |
|------|------|---------|------|
| `auth-server` | `auth-server` | tag | api, lib, wiki |

Tag-triggered and enforces `tag == VERSION`.

---

## Required files per repo

| Type | Version source | Changelog | Drone |
|------|----------------|-----------|-------|
| package (PyPI) | `pyproject.toml` | `CHANGELOG.md` | `python-lib.yaml` |
| package (npm) | `package.json` | `CHANGELOG.md` | `npm-lib.yaml` |
| service | `VERSION` | `CHANGELOG.md` | `service-docker.yaml` |

Every covered repository must be able to satisfy `tag == version`:
the version file (never a commit id) is bumped in the release MR, the MR is
merged, and the tag is created on the merged commit.

---

## Reading this at runtime

- Resource: `registry://repos`
- Tool: `list_repos()`
- Humans: this page (mirror of `standards/src/repos.json`).

---

## Related

- [90 – Drone Pipelines](90_drone_pipelines.md) · [91 – Versioning & Changelog](91_versioning_and_changelog.md) · [93 – Library Registry](93_library_registry.md)