# Document the seeder's exported surface · pingdotgg/t3code

[View on GitCafe](https://git.cafe/pingdotgg/t3code/commit/974d68356e15df03584924c18f280991943c7fb9)

Repository: [pingdotgg/t3code](https://git.cafe/pingdotgg/t3code)

Visibility: public

Requested revision: 974d68356e15df03584924c18f280991943c7fb9

Requested commit: 974d68356e15df03584924c18f280991943c7fb9

Commit: 974d68356e15df03584924c18f280991943c7fb9

Tree: 50293b15c0e7f4418111037cb9dff75bddba9c4a

Author: Theo Browne

Committer: Theo Browne

## Message

```
Document the seeder's exported surface

CodeRabbit flagged docstring coverage. Added docs where a caller would
actually need them — that `seedDevDatabase` is destructive and not
incremental, that it validates before opening anything so a rejected run
leaves the target intact, that the caller still owns the attachment
files, and that `DevSeedError.hint` is the actionable half the CLI prints
separately.

Left the self-describing internals (`placeholders`, `hasTable`,
`columnsOf`, `stateDbPath`) alone: the surrounding scripts/ code documents
about 2% of its declarations, so padding to an 80% tool default would
read as noise rather than convention.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

```

## Parents

- [e7ac40404fe794716e66ada80aae5c130b854757](https://git.cafe/pingdotgg/t3code/commit/e7ac40404fe794716e66ada80aae5c130b854757?format=markdown)

[Source at this commit](https://git.cafe/pingdotgg/t3code/tree/974d68356e15df03584924c18f280991943c7fb9?format=markdown)