Skip to content

[DEV-103] Show tracker task description on run details and link runs to their tracker ticket - #91

Open
danii1 wants to merge 1 commit into
mainfrom
feature/dev-103
Open

[DEV-103] Show tracker task description on run details and link runs to their tracker ticket#91
danii1 wants to merge 1 commit into
mainfrom
feature/dev-103

Conversation

@danii1

@danii1 danii1 commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Task: DEV-103

Summary: Show tracker task description on run details and link runs to their tracker ticket

Implementation Details

I have a full picture now. Let me set up a plan and check remaining pieces (dashboard-api tests, docs).
Now implementing. Starting with backend: new ticket-url.ts derivation module.
Let me simplify that module — the builder map is awkward:
Now the run-recorder changes — description snapshot column, ticket metadata on RunMeta, and a setRunTicket/recordRunTicket helper:
Now the createRun insert and the new store method:
Now the row mapping and module-level helper:
Now add the description-markdown builder to TaskFormatter:
I made an editing mistake — let me check and fix:
Now wire it into the pipeline in index.ts:
Now add the import and the description snapshot after formatTaskDetails:
Now update dashboard-api.ts to keep the list payload light while detail returns full description:
Backend done. Now the frontend — api.ts type first, then new components:
Now the TaskDescription component with markdown rendering, truncation, and placeholder:
Now wire both into RunDetailView:
Now the runs list work cell — make it use TicketKey for list/detail consistency:
Now tests. Backend first — ticket URL derivation and run-recorder coverage:
Now extend run-recorder.test.ts with ticket/description coverage:
Now the UI component tests, following the RunResult.test.tsx pattern:
Now run the relevant test suites and typechecks:
All 48 dashboard-ui tests pass (including the 8 new ones). Now the code package tests:
The failure is my test expecting strict no-clobber; COALESCE preserves existing values only against null updates (which is what "cannot erase" means). Fixing the test to match the actual semantics:
All green. Now format, lint, typecheck:
Now update the user-facing docs (docs/code/dashboard.md):
Final verification — full workspace build plus re-run of both affected test suites:
DEV-103 is implemented. Summary:

Backend (@getdevintern/code)

  • src/lib/ticket-url.ts (new): derives ticket web URLs from tracker config + key for Jira, GitHub, GitLab, Azure DevOps, Asana, and Trello; returns undefined for Linear (needs org slug), markdown files, synthetic scheduled keys, or missing config — so the UI can fall back to plain text.
  • run-recorder.ts: RunMeta gains ticketKey/ticketUrl (persisted at createRun); additive task_description TEXT migration (same pattern as attempt/ticket_key); new setRunTicket/recordRunTicket snapshot the description (null-safe via COALESCE, blank→null, capped at 20 000 chars like MAX_DETAIL_LENGTH).
  • index.ts: beginRun records the derived URL (skipped for markdown/scheduled runs); after formatTaskDetails, the ticket description is snapshotted at run start via new TaskFormatter.buildTaskDescriptionMarkdown (reuses rendered-HTML → turndown and ADF conversion paths used by prompts).
  • dashboard-api.ts: /api/runs/:id serves the snapshot; /api/runs strips it to keep the 5-second polling payload light.

Frontend (@devintern/dashboard-ui)

  • New TicketKey component (linked/new-tab vs plain-text fallback) used by both the run detail header and the runs-list "Work" cell — consistent behavior in both views.
  • New TaskDescription card on run detail: markdown rendering, explicit "No description provided." placeholder, >1500-char collapse with show more/less; hidden entirely for non-ticket runs (PR mentions).

Verification: 1002 code tests + 48 dashboard-ui tests pass (18 new: URL derivation, persistence/capping/migration, API passthrough, linked/unlinked keys, placeholder/truncation); build, lint, format, and typecheck all clean. Docs updated in docs/code/dashboard.md.


This PR was automatically created by @devintern/code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant