gofasta g field

Adds a single column to an existing resource — patches the model struct, the DTOs (Create / Update / Response), and emits a paired .up.sql / .down.sql migration in one command. The DTO patches are opt-out via flags so you can keep a column out of CreateRequest (server-set) or out of the Response (write-only).

Uses dst for AST patching, so comments, tag ordering, and import grouping are preserved.

Usage


gofasta g field <Resource> <name>:<type> [flags]

The resource must already exist (see gofasta g scaffold). The field is given in the same name:type shorthand the scaffold accepts.

Flags

Flag	Default	Description
`--no-dto`	`false`	Skip every DTO patch — only the model + migration are updated.
`--no-create`	`false`	Skip the `CreateRequest` DTO patch (use for server-set fields like `archived_at`).
`--no-update`	`false`	Skip the `UpdateRequest` DTO patch (use for immutable fields like `created_by`).
`--no-response`	`false`	Skip the `Response` DTO patch (use for write-only fields like `password_hash`).
`--dry-run`	`false`	Preview the patches + migration without writing. Honors `--json` for a structured plan.

Supported types

Same set as g scaffold — see Field Types. The SQL type is driver-aware: string → VARCHAR(255) on Postgres / VARCHAR(255) on MySQL / TEXT on SQLite / NVARCHAR(255) on SQL Server / String on ClickHouse. Picked from database.driver in config.yaml.

Examples

Add an archive_reason text column with full DTO coverage:


gofasta g field Order archive_reason:string

Result:

app/models/order.model.go — appends ArchiveReason string \gorm:“not null”“
app/dtos/order.dtos.go — appends ArchiveReason string \json:“archive_reason”`toOrderCreateRequest, OrderUpdateRequest, OrderResponse`
db/migrations/NNNNNN_add_archive_reason_to_orders.up.sql — ALTER TABLE orders ADD COLUMN archive_reason VARCHAR(255);
db/migrations/NNNNNN_add_archive_reason_to_orders.down.sql — ALTER TABLE orders DROP COLUMN archive_reason;

Add a write-only password_hash field (omit from responses):


gofasta g field User password_hash:string --no-response

Add a server-set archived_at timestamp (omit from Create + Update):


gofasta g field Order archived_at:time --no-create --no-update

Model-only column (no DTO changes at all):


gofasta g field Order internal_notes:text --no-dto

Preview without writing:


gofasta g field Order shipped_at:time --dry-run

What it patches

File	Change
`app/models/<snake>.model.go`	Appends the field to the `<Resource>` struct with the appropriate GORM tag. Adds `time` / `github.com/google/uuid` imports when the field type needs them.
`app/dtos/<snake>.dtos.go`	Appends the field (with `json:"..."` tag, no GORM tag) to `<Resource>CreateRequest`, `<Resource>UpdateRequest`, and `<Resource>Response` — minus any opt-outs. Missing variants (e.g. you don’t have an `UpdateRequest`) are silently skipped.
`db/migrations/NNNNNN_add_<field>_to_<plural>.up.sql`	`ALTER TABLE <plural> ADD COLUMN <field> <sql-type>;`
`db/migrations/NNNNNN_add_<field>_to_<plural>.down.sql`	`ALTER TABLE <plural> DROP COLUMN <field>;`

NNNNNN is the next available 6-digit migration version.

Naming conventions

Field input	Go field name	JSON tag	SQL column
`archive_reason:string`	`ArchiveReason`	`archive_reason`	`archive_reason`
`userID:uuid`	`UserID`	`userID`	`user_id`
`is_active:bool`	`IsActive`	`is_active`	`is_active`

The PascalCase / camelCase / snake_case conversions are deterministic — same rules as the scaffold.

Idempotency

If the model struct already has the field, the command returns FIELD_ALREADY_EXISTS without touching anything. The DTOs and migrations are not checked the same way — but the migration filename includes a fresh version prefix, so re-running creates a duplicate migration rather than overwriting.

Error codes

Code	When
`RESOURCE_NOT_FOUND`	The model file is missing. Run `gofasta g scaffold <Resource>` first.
`FIELD_ALREADY_EXISTS`	The model struct already has a field by that name. Pick a different name or remove the existing field first.
`AST_PARSE_FAILED`	The model or DTO file has a syntax error.

gofasta g scaffold
Generate a complete CRUD resource with all layers including model, repository, service, controller, routes, DTOs, migration, and DI provider.
gofasta g model
Generate a GORM database model with typed fields and a corresponding migration pair.
gofasta g repository
Generate a model, migration, repository interface, and repository implementation for database access.
gofasta g service
Generate a service interface and implementation containing business logic, plus every prerequisite layer (model, migration, repository, DTOs, Wire provider).
gofasta g controller
Generate a REST controller (with CRUD handlers) plus every prerequisite layer — model, migration, repository, service, DTOs, Wire provider, and routes.
gofasta g dto
Generate request and response Data Transfer Objects (DTOs) for a resource.
gofasta g migration
Generate a `.up.sql` / `.down.sql` migration pair under `db/migrations/` for a database table — with per-driver SQL flavor (postgres,...
gofasta g route
Generate a per-resource chi routes file under `app/rest/routes/` — the registration function (`<Resource>Routes(r chi.Router)`) that the index router mounts.
gofasta g resolver
Patch the GraphQL resolver root to add a service dependency for an existing resource — appends the service field, regenerates Wire...
gofasta g provider
Generate a Google Wire dependency-injection provider set for a resource — the small `wire.NewSet(...)` glue that ties the service,...
gofasta g method
Add a new method to an existing service interface + impl.
gofasta g repo-method
Add a method to an existing repository — the repository-layer twin of `g method`.
gofasta g endpoint
Add a single REST endpoint to an existing resource — patches the controller (handler stub), routes file (chi registration), and...
gofasta g middleware
Wrap an existing chi route's handler with a middleware.
gofasta g relation
Add a GORM association between two resources — belongs_to, has_many, or has_one.
gofasta g rename
Cross-file rename of a field on a resource — model, DTOs, service, tests, repository, plus a rename migration.
gofasta g job
Generate a scheduled background job that implements the scheduler.Job interface.
gofasta g task
Generate an asynq-backed async task — emits a `Task<Name>` constant, a `<Name>Payload` struct, a `Handle<Name>` handler, and an `Enqueue<Name>` helper.
gofasta g email-template
Generate an HTML email template with a matching Go template file under app/emails/templates/ and a registration entry so the pkg/mailer renderer can find it by name.
gofasta g mock
Generate a testify/mock implementation that satisfies a Go interface.
`gofasta migrate up`