gitea-axi/.claude/tasks/0003-issue-view-and-truncation.md at 1d184722970f52a43a962e82e7ef1a089ba0fb7d

Files

alexion d03a079854 docs: adopt Conventional Commits and land planning docs

- CONVENTIONAL-COMMITS.md: vendored spec (v1.0.0); CLAUDE.md requires
  agent-written commits to follow it
- tasks 0002-0020: remaining task breakdown of the gitea-axi spec
  (0019 reframed around the three-tier test taxonomy: unit,
  integration, end-to-end)
- spec, CONTEXT.md, and ADRs 0006/0007/0011: pending design
  refinements from the planning sessions

2026-07-11 07:14:39 -04:00

2.1 KiB

Raw Blame History

spec, blocked-by

spec	blocked-by
gitea-axi	0001-scaffold-and-issue-list-core

What to build

issue view <n> as a detail command, introducing the content-truncation and cleanBody machinery that later slices reuse. Default output: number, title, state, author, created, body (truncated at 500 chars), plus comment_count. --comments renders all comments with no count cap, each body truncated at 800 chars with cleanBody applied. --full suppresses all truncation in the output — issue body and comment bodies alike. cleanBody runs only when the raw body exceeds the truncation limit: it normalizes Gitea issue/PR URLs on the detected hostname to Issue#N/PR#N, strips markdown image embeds, removes long URLs, and collapses email-style quoted blocks; if cleaning brings the body under the limit the cleaned body is returned with a note, otherwise it is truncated with the inline hint. Type guard: viewing a PR number fails with VALIDATION_ERROR ("issue #N is a pull request") and a pr view <n> help line. No type field and no sub-issue augmentation.

Acceptance criteria

issue view <n> renders the default detail fields plus comment_count via renderDetail
Bodies over 500 chars are cleaned then truncated with the inline hint "... (truncated, N chars total - use --full to see complete body)"; bodies at or under the limit pass through untouched
cleanBody normalizes issue/PR URLs using the detected hostname, strips image embeds and long URLs, and collapses quoted blocks
--comments renders every comment (no cap), each body cleaned and truncated at 800 chars
--full returns raw, untruncated body and comment bodies
A PR number yields VALIDATION_ERROR (exit 2) with the "is a pull request" message and a pr view <n> help line, detected via the fetched object's pull_request field
A nonexistent issue yields ISSUE_NOT_FOUND (exit 1)
Single-entity next-step suggestions fill the actual issue number rather than a placeholder
Fixture-server tests cover truncation boundaries, cleanBody transforms, --comments, --full, and the type guard

2.1 KiB Raw Blame History

What to build

Acceptance criteria

2.1 KiB

Raw Blame History