Skip to content

Changelog

All notable changes to the Central developer documentation / API baseline are recorded here.

The format is based on Keep a Changelog, and this project uses Semantic Versioning for the documented API surface.

Historical SemVer tags for Central alone could not be determined from the repository. Parent git history shows incremental Central features (portal UI, discovery, admin navigation, PATs) under mixed monorepo commits, but not a Central-specific version series. This changelog therefore initializes at 1.0.0 as of the documentation inventory date.

1.0.0 - 2026-07-15

Added

  • Developer documentation set under docs/
  • OpenAPI 3.1 description of the verified HTTP API
  • Documented runtime configuration surface (listen, web root, DB, session TTL, admin bootstrap, catalog cache, base path, cookie domain, shared UI root)
  • Documented PostgreSQL schema created by EnsureSchema
  • Documented cookie session auth and personal access tokens (agp_...)
  • Documented portal card, catalog, identity, and admin ACL APIs
  • Documented sibling acugis CLI mappings for Central login/whoami/catalog/search

Known limitations (verified)

  • No in-tree Docker/Compose/Nginx packaging for Central
  • Stub endpoints /api/maps, /api/reports, /api/forms, /api/datasets return empty collections
  • Discovery service URLs are hard-coded
  • No background workers, metrics endpoint, or versioned DB migrator
  • /api/health is liveness-only