Align TrueForge agent names to hyphen-only 2–64 char and migration to enforce hyphen-only naming convention

[bhaveshpatel640]

Align TrueForge agent names to hyphen-only 2–64 char and migration to enforce hyphen-only naming convention

Summary

Closes #

Changes

How was this tested?

Checklist

• I have read the contributing guidelines
• pnpm build, pnpm test, pnpm typecheck, pnpm lint:ci, and pnpm format:check pass locally
• Tests added/updated where it makes sense
• No hand-edits to generated code (packages/trueforge-sdk, .github/fern/openapi/openapi.json, docs/openapi.json) — fork PRs omit SDK regen; maintainers regenerate after merge
• Docs / .env.example updated if configuration or behavior changed

---

Note

Medium Risk
Irreversible in-place renames can break integrations that still reference old agent names; collision suffixes may yield non-obvious names at the 64-character limit.

Overview
Introduces a dedicated AgentName OpenAPI/Zod type (lowercase, 2–64 chars, hyphens only—no . or _) and wires it through agent create/list APIs, schedule agent_name fields, and session agent-by-name references. ResourceName is unchanged for other resources (e.g. schedule names).

Adds an irreversible Postgres/SQLite migration that rewrites existing agent names containing . or _ via planAgentNameHyphenRenames (hyphenate, per-tenant collision suffixes, 64-char truncation) and updates denormalized session.agent_name. New POST /agents requests with dotted or underscored names return 400. SDK and OpenAPI specs are regenerated to use AgentName.

^{Reviewed by Cursor Bugbot for commit 123a95e. Bugbot is set up for automated code reviews on this repo. Configure here.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 123a95e

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@truefoundry/trueforge	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 91598c9. Configure here.}

[cursor]

Migration skips schedule name FK

High Severity

The hyphen-only migration updates agent.name and denormalized session.agent_name but never rewrites schedule.agent_name. schedule_agent_name_fk references agent(tenant_id, name) with ON DELETE CASCADE only, so renaming a parent that still has schedules fails immediately. Any tenant with a dotted or underscored agent that owns a schedule cannot finish this migration, and startup/upgrade stops.

Additional Locations (1)

• packages/trueforge/src/db/sqlite/migrations/20260901_000001_agent_name_hyphen_only.ts#L20-L32

 

^{Reviewed by Cursor Bugbot for commit 91598c9. Configure here.}