feat: v0.5.0 — machine-readable API docs: GET /api/version + OpenAPI 3.1 spec at /api/openapi; AGENTS.md points agents at the live spec

e2e/api.spec.ts

@@ -0,0 +1,24 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { test, expect } from '@playwright/test';
+
+// Read at test time so the assertions track package.json automatically.
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8')) as { version: string };
+
+test('GET /api/version returns the app version from package.json', async ({ page }) => {
+  const res = await page.request.get('/api/version');
+  expect(res.status()).toBe(200);
+  expect(res.headers()['content-type']).toContain('application/json');
+  const body = (await res.json()) as { version: string };
+  expect(body.version).toBe(pkg.version);
+});
+
+test('GET /api/openapi serves the spec with both endpoints and the package.json version', async ({ page }) => {
+  const res = await page.request.get('/api/openapi');
+  expect(res.status()).toBe(200);
+  expect(res.headers()['content-type']).toContain('application/json');
+  const spec = (await res.json()) as { info: { title: string; version: string }; paths: Record<string, unknown> };
+  expect(spec.info.title).toBe('Flight Ops API');
+  expect(spec.info.version).toBe(pkg.version);
+  expect(Object.keys(spec.paths).sort()).toEqual(['/api/airports', '/api/version']);
+});