feat(frontend): typed API client generated from the OpenAPI spec + gen-verify CI

[AgentWrapper]

Why (scope change)

This PR originally added the code-first OpenAPI generator + a frontend client. The backend generator has since landed on main (via #68/#65) and now covers projects and sessions — superseding this branch's backend work. Rather than duplicate it, this PR is repurposed to the parts main still lacks.

What's here

• frontend/src/api/schema.d.ts — generated from backend/internal/httpd/apispec/openapi.yaml via openapi-typescript (npm run gen:api). Covers projects, sessions, and orchestrators.
• frontend/src/api/client.ts — a small openapi-fetch client typed by that schema, so the renderer's request/response types come from the daemon contract instead of being hand-maintained.
• gen-verify CI job — regenerates the spec from Go and the TS client from the spec, failing if either committed artifact is stale. Backend drift is already covered by the apispec tests; this additionally guards the frontend artifact, which nothing else checks.

Verification

frontend: npm run gen:api ✓   npm run typecheck ✓
pipeline: go generate ./... + npm run gen:api reproduce the committed files with no drift

Rebased on current main; no overlap with the backend codegen or the recent CLI PRs.

🤖 Generated with Claude Code

[greptile-apps]

Greptile Summary

This PR introduces a typed openapi-fetch client for the Electron renderer, a generated schema.d.ts from the backend's OpenAPI YAML, and a gen-verify CI job that re-runs the full code-first pipeline and fails if committed artifacts are stale.

• frontend/src/api/client.ts + schema.d.ts: openapi-fetch client parameterized by the generated path and component types; eliminates hand-maintained request/response types and keeps the frontend in sync with the daemon contract via the CI gate.
• .github/workflows/go.yml: New gen-verify job runs go generate ./... then npm run gen:api, then git diff --exit-code to catch any drift between Go types, the OpenAPI spec, and the TS schema; also widens the workflow trigger to include frontend/**.

Confidence Score: 4/5

Safe to merge with one fix: the hardcoded daemon port needs to be read from the runfile before the client is wired up to real callers.

The client hardcodes http://127.0.0.1:3001 but the runfile package was explicitly designed to publish the daemon's actual bound port to the Electron main process — if 3001 is occupied and the daemon binds elsewhere, every API call will target a dead address. The CI job and the generated schema are clean.

frontend/src/api/client.ts — the baseUrl should derive the port from the runfile rather than hardcoding 3001.

Important Files Changed

Filename	Overview
frontend/src/api/client.ts	Typed openapi-fetch client wrapping the generated schema; baseUrl is hardcoded to port 3001 rather than being read from the runfile port-discovery mechanism that already exists in the backend.
frontend/src/api/schema.d.ts	Auto-generated TypeScript types from the OpenAPI spec covering projects, sessions, and orchestrators. No manual changes; safe as-is.
.github/workflows/go.yml	Adds gen-verify CI job that regenerates openapi.yaml and schema.d.ts end-to-end and fails on any diff; also extends the workflow trigger to include frontend/** changes. Logic is correct.
frontend/package.json	Adds openapi-fetch runtime dependency and openapi-typescript dev dependency, plus gen:api script; dependency placement is correct.

Sequence Diagram

sequenceDiagram
    participant Dev as Developer
    participant Go as Go Backend
    participant Spec as openapi.yaml
    participant TS as schema.d.ts
    participant CI as gen-verify CI

    Dev->>Go: modify contract type
    Dev->>Go: go generate ./...
    Go->>Spec: regenerate openapi.yaml
    Dev->>TS: npm run gen:api
    Spec->>TS: regenerate schema.d.ts
    Dev->>CI: push / open PR
    CI->>Go: go generate ./...
    Go->>Spec: regenerate openapi.yaml
    CI->>TS: npm run gen:api
    Spec->>TS: regenerate schema.d.ts
    CI->>CI: git diff --exit-code
    alt committed files match regenerated output
        CI-->>Dev: pass
    else committed files are stale
        CI-->>Dev: fail — regenerate and commit
    end

Loading

_{Reviews (5): Last reviewed commit: "feat(frontend): typed API client generat..." | Re-trigger Greptile}

[neversettle17-101]

Changes LGTM