project create/update --description has undocumented 255-char hard cap

[jrschumacher]

Version: linear 2.0.0

linear project create --description <text> and linear project update --description <text> reject descriptions longer than 255 characters with the API error description must be shorter than or equal to 255 characters. The 255-char limit is not mentioned in --help output.

Repro

$ linear project create \
    --name "F-FOO" \
    --team ABNL \
    --description "$(printf 'word %.0s' {1..60})"
✗ Failed to create project: description must be shorter than or equal to 255 characters

The limit comes from the Linear API. Linear's web UI does not enforce a 255-char cap on project descriptions (longer descriptions are accepted via the UI), so this appears to be either an API endpoint difference or a stale schema constraint in the CLI's wrapper.

Expected

Either:

• Document the limit in --help and in the schipt/CLI docs, OR
• Use whichever API endpoint the Linear web app uses for longer descriptions, OR
• Accept --description-file (like --content-file on document create) so users can pass a path and bypass the shell quoting / length problem.

Workaround

Keep project descriptions ≤255 chars and link out to a Linear Document for the full context.