38 lines
1.9 KiB
Markdown
38 lines
1.9 KiB
Markdown
|
---
|
||
|
|
brief: 2
|
||
|
|
convoy: owner-cockpit-v02
|
||
|
|
role: role-implementer
|
||
|
|
title: Owner completion artifacts — summary + gallery
|
||
|
|
status: ready
|
||
|
|
priority: P1
|
||
|
|
slice_dependencies: []
|
||
|
|
recommended_model: qwen-coder
|
||
|
|
model_tier: local
|
||
|
|
---
|
||
|
|
|
||
|
|
# Brief 2 — `Epic-owner-completion-artifacts` (Epic 11)
|
||
|
|
|
||
|
|
## Goal
|
||
|
|
|
||
|
|
When `merged/published → released` (`human-gate-3`), generate completion summary markdown + optional screenshot placeholder, list in gallery for owner review. No browser automation v1 — screenshot is upload placeholder.
|
||
|
|
|
||
|
|
## Files
|
||
|
|
|
||
|
|
- `packages/database/src/schema/completion_artifacts.ts` NEW — `id uuid PK, workspace_id fk, convoy_id fk objects.id, summary_md text, screenshot_url text nullable, created_by fk users, created_at`. Or reuse `objects content.completionSummary` — pick minimal table for gallery query.
|
||
|
|
- `apps/web/server/routers/convoys.ts` — add `complete` mutation (`doc_review→published→released` or `pr_review→merged→released`) that writes artifact + transitions `released` as `human-gate-3`; `listArtifacts` query for gallery.
|
||
|
|
- `apps/web/app/(app)/[workspaceSlug]/artifacts/page.tsx` NEW — gallery grid, click → detail with summary + PR link + convoy timeline (`convoy_events`).
|
||
|
|
- `packages/shared/src/worker` — generate summary template: `## Summary\nConvoy ${slug} ${classification} — ${successMetric}\nBriefs: ...\nModel: ... Harness: ...`.
|
||
|
|
|
||
|
|
## Acceptance
|
||
|
|
|
||
|
|
- Completing `doc_review→published→released` creates artifact row visible in `/artifacts`; screenshot upload placeholder shows.
|
||
|
|
- `pnpm lint && pnpm type-check` pass.
|
||
|
|
|
||
|
|
## Prompt
|
||
|
|
|
||
|
|
You are `role-implementer` brief 2. Read `plans/Plan-automation-foundation/Epic-owner-completion-artifacts/Epic-owner-completion-artifacts.md`, `packages/shared/src/convoy-lifecycle/state-machine.ts:122`, `apps/web/server/routers/convoys.ts:237`. Keep artifact generation deterministic, no LLM call v1 (template only).
|
||
|
|
|
||
|
|
## Depends
|
||
|
|
|
||
|
|
None — disjoint from webhooks.
|