<!-- canonical: https://docs.axelabs.ai/ops/reports -->
<!-- source: content/ops/reports/index.mdx -->

---
title: 리포트 (upstream 제출 draft)
description: AXE Labs 운영 중 발견한 함정·feature request 의 upstream 보고 draft. 운영자가 검토 후 support / GitHub issue / PR 로 제출.
---

## 1. 본 섹션의 목적

AXE Labs 가 운영 중 발견한 함정 또는 feature request 중:

- **AXE 자체 fix 가 부분 fix 인 경우** (예: client-side workaround)
- **upstream 측 영구 fix 가 본질** (예: 라이브러리 자체 패치 필요)
- **다른 사용자도 영향 받을 함정** (i18n, accessibility, edge case)

해당하는 사안의 **self-contained 보고 draft** 를 본 섹션에 보관. 운영자가 검토 후 다음 채널 중 적절한 곳으로 제출:

- Vendor email support
- GitHub issue / discussion
- GitHub pull request
- 표준 단체 (RFC 등) — 해당 시

## 2. 현재 보유 reports

| ID (filename) | 제목 | 대상 | 상태 | 작성일 |
|---|---|---|---|---|
| [`claudeapp-fd-leak-2026-05`](/ops/reports/claudeapp-fd-leak-2026-05) | Claude Desktop PTY/fd leak | Anthropic | Draft — 운영자 검토 대기 | 2026-05-28 |
| [`anthropic-connector-input-attrs-2026-05`](/ops/reports/anthropic-connector-input-attrs-2026-05) | claude.ai Custom Connector input identifiers | Anthropic | Draft — 운영자 검토 대기 | 2026-05-28 |
| [`timshel-vaultwarden-upstream-pr-2026-05`](/ops/reports/timshel-vaultwarden-upstream-pr-2026-05) | Timshel/vaultwarden mainline backport (bw 2026.4+ compatibility) | Timshel/vaultwarden GitHub | Draft — 운영자 검토 대기 | 2026-05-28 |

## 3. 신규 보고 작성 가이드

새 함정·feature request 의 upstream 보고 draft 작성 시:

### 파일 명명

`<descriptive-slug>-YYYY-MM.mdx` (예: `claudeapp-fd-leak-2026-05.mdx`)

- slug = upstream system + 함정 type
- YYYY-MM = 발견 또는 작성 시점

### 권장 섹션 구조 (10 섹션, self-contained)

1. **Summary** — 1-2 문장 요약
2. **Environment** — OS, app version, hardware, uptime 등 repro 환경
3. **Symptom** — failure mode + reproduction steps + diagnostic commands
4. **Workarounds** — 현재 사용 가능한 우회 + AXE 측 자체 fix (있다면)
5. **Suspected root cause** — 분석 + 증거
6. **Impact** — 영향 범위 (user 수, scenario 등)
7. **Requested fix** — upstream 측에 요청하는 변경 (가능하면 code 또는 spec 단위)
8. **Attachments** — diagnostic logs, screenshots, code refs (path)
9. **Channels** — 어디 제출할지 (email, GitHub repo URL, etc.)
10. **Status** — draft → submitted → response → resolved

### MDX 주의사항

- code 는 fenced block 안
- placeholder `<tenant>` `<name>` 등은 backtick 안 또는 `&lt;...&gt;` escape
- frontmatter title 은 사람 읽기 쉬운 한 문장

### _meta.js 등재

파일 생성 후 `/Users/axe/axelabs-docs/content/ops/reports/_meta.js` 에 entry 추가:

```javascript
"new-report-slug-YYYY-MM": "사람 읽기 쉬운 제목"
```

## 4. backlog 연계

본 섹션의 모든 report 는 backlog 의 대응 항목과 cross-link 권장:

- backlog entry → report link (entry 본문에 `→ /ops/reports/<slug>` 명시)
- report frontmatter → backlog link (optional, history 추적용)

수락/회신 시 status 업데이트:

- 본 페이지 표의 "상태" 열 갱신
- backlog 의 ✅ Done 으로 이동 시점 = upstream 측 수락 또는 운영자가 close 결정