API 요청·응답·완료 의미 참조

이 문서는 261개 등록 operation의 wire 입력, 직접 JSON variant, 오류와 완료 경계를 handler AST와 route registration에서 색인한다. 공유 handler의 method branch와 기존 required 후보 56개는 source control-flow를 별도로 대조했다. 그 밖의 field requiredness와 helper/derived schema는 P/U이며, route 261개를 field-level semantic 완료율로 사용하지 않는다. C는 해당 행의 직접 branch/shape를 확인했다는 뜻이고 P는 일부 helper/derived type이 남았으며 U는 직접 shape를 확정하지 못했다는 뜻이다. 실행 성공이나 외부 효과 완료를 뜻하지 않는다.

공통 wire 규칙

• /api/auth/*와 /api/health는 공통 middleware에서 면제된다. change-password는 handler에서 JWT와 현재 암호를 다시 검사한다.
• extractToken은 route/method와 무관하게 Bearer header → artex_token cookie → query token 순으로 JWT를 고른다. 공통 middleware가 보호하는 256개 operation과 middleware 면제지만 handler가 재검증하는 change-password 1개, 합계 257개가 query token을 실제로 수락한다. SSE 전용 제한은 구현돼 있지 않다. auth status/init/login과 health 4개는 JWT를 요구하지 않는다.
• 일반 JSON 오류는 { "error": string }이다. 일부 stream/file/helper 경로는 다른 body 또는 이미 쓴 응답을 가질 수 있어 operation별 상태를 본다.
• 공통 requireAuth가 보호하는 256개 operation은 handler 전에 token 누락 401 {"error":"未授权"}, invalid/expired 401 {"error":"token 无效或已过期"}를 반환할 수 있다. operation 표의 handler 직접 오류와 합쳐 해석한다.
• s.pg(w)를 직접 호출하는 operation은 PostgreSQL handle이 없을 때 helper가 503 {"error":"PostgreSQL 不可用"}를 쓰고 handler를 중단한다. 적용 operation은 아래 협력자와 오류 표에 표시하며 실제 DB health는 실행하지 않았다.
• encoding/json decoder는 field 존재 자체를 강제하지 않는다. non-pointer field의 누락/null 구별은 보존되지 않고 Go zero value가 남는다. pointer field는 absent/null 모두 nil일 수 있다. “필수”는 absent/zero check가 error response와 return으로 이어지는 control-flow를 확인한 field만 표시한다. default/alias 변환, 제공 시 검증, all-empty patch는 각각 선택 또는 그룹 조건이다.
• unknown-field 거부는 DisallowUnknownFields를 호출한 handler만 해당한다. 그 외 JSON object의 미등록 key는 decoder 단계에서 무시될 수 있다.
• path/query/header는 HTTP wire에서 string이다. 정수·boolean·enum 변환과 범위는 validation 식 또는 helper가 소유하며 미해석 helper는 P/U로 남긴다.
• write response의 omitempty field는 조건부다. map literal key는 해당 variant에서 존재하지만 다른 status/branch의 variant에는 없을 수 있다.

공유 nested type

Operation field가 아래 type을 참조하면 이 표가 알려진 JSON member를 소유한다. custom unmarshal/validation은 consumer handler가 추가할 수 있다.

db.TrafficRef

notify.Filter

server.chatAttachment

server.taskInterceptRuleReq

GET /api/auth/status

구현: authStatus · server/auth.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: pg == nil

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: pg.GetSetting; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/auth/init

구현: authInit · server/auth.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: err != nil \|\| req.Password == ""

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: []byte, bcrypt.GenerateFromPassword, err.Error, pg.GetSetting, pg.SetSetting, signJWT; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/auth/login

구현: authLogin · server/auth.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: req.Username != "ARTEX"

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: []byte, bcrypt.CompareHashAndPassword, pg.GetSetting, signJWT; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/auth/change-password

구현: authChangePassword · server/auth.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: req.NewPassword == ""

응답·오류

응답 schema 판정: C · 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: []byte, bcrypt.CompareHashAndPassword, bcrypt.GenerateFromPassword, err.Error, extractToken, pg.GetSetting, pg.SetSetting, verifyJWT; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/health

구현: health · server/server.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정.

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: handler AST에서 별도 collaborator call 미발견; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/stats

구현: stats · server/server.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: err == nil · g.State == "met" · in.State == "running" · t == nil · taskParam != "" && taskParam != "active" · tr != nil

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: task.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: r.URL.Query, r.URL.Query().Get, s.engine.ActiveLLMCalls, s.engine.IsPaused, s.engine.LastActivity, s.engine.Ready, s.engine.ReadyFor, s.engine.Started, s.m.Assets, s.m.Assets().CountsByType, s.m.ResolveTask, s.m.Traffic, t.Store.ListByKind, t.Store.Stats, tr.Count; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/logs

구현: getLogs · server/server.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 parse/default: atoiDefault(r.URL.Query().Get("limit"), 500) · atoiDefault(r.URL.Query().Get("since"), 0)

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: limit, since.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: atoiDefault, logSink.recent, r.URL.Query, r.URL.Query().Get; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/logs/history

구현: getLogsHistory · server/server.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: before <= 0 · err != nil · limit > 500 · s.m.pg == nil 직접 parse/default: atoiDefault(r.URL.Query().Get("before"), 0) · atoiDefault(r.URL.Query().Get("limit"), 200)

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: before, limit.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: atoiDefault, err.Error, r.CreatedAt.Format, r.URL.Query, r.URL.Query().Get, s.m.pg.ListLogsBefore, s.m.pg.RecentLogs; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/logs/stream

구현: streamLogs · server/server.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · cursor > since · l.Seq <= since 직접 parse/default: atoiDefault(r.URL.Query().Get("since"), 0)

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: since.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: SSE 연결 수립; event lifecycle은 stream별 cursor/메모리 상태를 확인.
• 직접 협력자/실행 단서: atoiDefault, ctx.Done, flusher.Flush, fmt.Fprint, fmt.Fprintf, logSink.recent, logSink.subscribe, ping.Stop, r.Context, r.URL.Query, r.URL.Query().Get, send, unsub, w.Header, w.Header().Set; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/update/check

구현: updateCheck · server/update.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !comparable · !rel.PublishedAt.IsZero() · err != nil · ok · selfupdate.InDocker()

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: bootUpdateState, err.Error, r.Context, r.URL.Query, r.URL.Query().Get, rel.FindAsset, rel.PublishedAt.Format, rel.PublishedAt.IsZero, relCache.get, s.m.GlobalProxy, selfupdate.AssetName, selfupdate.CompareVersions, selfupdate.HasBackup, selfupdate.InDocker, selfupdate.NewClient; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/update/apply

구현: updateApply · server/update.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !comparable · !updHub.begin(rel.TagName) · cmp >= 0 · err != nil

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: download/apply worker 시작 후 process restart; 새 health/version이 완료 기준.
• 직접 협력자/실행 단서: err.Error, func() { err := selfupdate.Stage(s.ctx, client, rel, current, func(ph selfupdate.Phase, pct int, msg string) { updHub.publish(ph, pct, msg) }) updHub.finish(err) if err != nil { log.Printf("[update] 更新失败：%v", err) return } log.Printf("[update] %s → %s 已暂存，即将退出以完成换装", current, rel.TagName) time.Sleep(1500 * time.Millisecond) requestRestart() }, log.Printf, r.Context, relCache.get, requestRestart, s.m.GlobalProxy, selfupdate.CompareVersions, selfupdate.NewClient, selfupdate.Stage, updHub.begin, updHub.finish, updHub.publish; direct go statement는 발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/update/rollback

구현: updateRollback · server/update.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: err != nil · running

응답·오류

응답 schema 판정: C · 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: rollback stage 후 restart 요청; 재기동 version이 완료 기준.
• 직접 협력자/실행 단서: err.Error, func() { time.Sleep(500 * time.Millisecond) requestRestart() }, log.Printf, requestRestart, selfupdate.Rollback, updHub.snapshot; direct go statement는 발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/update/stream

구현: updateStream · server/update.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: SSE 연결 수립; event lifecycle은 stream별 cursor/메모리 상태를 확인.
• 직접 협력자/실행 단서: ctx.Done, flusher.Flush, fmt.Fprint, fmt.Fprintf, ping.Stop, r.Context, send, unsub, updHub.snapshot, updHub.subscribe, w.Header, w.Header().Set; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/tasks

구현: listTasks · server/server.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: live > dto.LastActivity · t != nil

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: applyTaskArchiveBlocker, s.engine.LastActivity, s.m.ActiveTask, s.m.List, s.m.PG, s.m.PG().TaskArchiveBlockers, s.m.PG().TaskListMetricsAll, taskDTO, tokenTotalDTO; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/tasks

구현: createTask · server/server.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: len(req.LLMProfileIDs) == 0 && req.LLMProfileID != nil · len(req.SourceTaskIDs) > db.MaxTaskSourceCount · req.TimeoutSeconds < 0 · strings.TrimSpace(req.Description) == "" 직접 parse/default: strconv.ParseInt(strings.TrimSpace(raw), 10, 64)

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: task/exploration 저장 후 engine launch; 201은 탐색 완료가 아님.
• 직접 협력자/실행 단서: buildTaskInterceptRules, db.NormalizeTaskCompanyIDs, err.Error, json.NewDecoder, json.NewDecoder(r.Body).Decode, log.Printf, s.m.CreateTaskWithOptions, s.m.Task, taskDTO; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/task-categories

구현: pgListTaskCategories · server/task_categories.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: err != nil · pg == nil

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: err.Error, pg.ListTaskCategories; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/task-categories

구현: pgCreateTaskCategory · server/task_categories.go · 정확한 handler 근거

요청

요청 body 상한: 16 KiB (16384 bytes) · source server/task_categories.go::decode/direct category request · 초과/decoder 경로 413 "请求正文过大".

요청 판정: C/P · unknown field 거부 미설정. 공유 decoder/helper: decodeTaskCategoryRequest; helper 내부 size/presence validation은 같은 source evidence에서 확인하며 operation 단독 AST 판정은 P.

응답·오류

공통 helper 오류 분기: writeTaskCategoryError (server/task_categories.go::writeTaskCategoryError: 400/409/404/500), decodeTaskCategoryRequest (server/task_categories.go::decodeTaskCategoryRequest: 400). Status union은 helper control-flow를 정적으로 펼친 P이며 runtime DB 결과는 관찰하지 않았다.

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: decodeTaskCategoryRequest, pg.CreateTaskCategory, writeTaskCategoryError; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

PATCH /api/task-categories/{id}

구현: pgRenameTaskCategory · server/task_categories.go · 정확한 handler 근거

요청

요청 body 상한: 16 KiB (16384 bytes) · source server/task_categories.go::decode/direct category request · 초과/decoder 경로 413 "请求正文过大".

요청 판정: C/P · unknown field 거부 미설정. 공유 decoder/helper: decodeTaskCategoryRequest; helper 내부 size/presence validation은 같은 source evidence에서 확인하며 operation 단독 AST 판정은 P.

응답·오류

공통 helper 오류 분기: writeTaskCategoryError (server/task_categories.go::writeTaskCategoryError: 400/409/404/500), decodeTaskCategoryRequest (server/task_categories.go::decodeTaskCategoryRequest: 400). Status union은 helper control-flow를 정적으로 펼친 P이며 runtime DB 결과는 관찰하지 않았다.

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: decodeTaskCategoryRequest, pathInt, s.m.RenameTaskCategory, writeTaskCategoryError; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

DELETE /api/task-categories/{id}

구현: pgDeleteTaskCategory · server/task_categories.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !deleted · !ok · err != nil

응답·오류

공통 helper 오류 분기: writeTaskCategoryError (server/task_categories.go::writeTaskCategoryError: 400/409/404/500). Status union은 helper control-flow를 정적으로 펼친 P이며 runtime DB 결과는 관찰하지 않았다.

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음.
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: pathInt, s.m.DeleteTaskCategory, writeTaskCategoryError; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/tasks/category/batch

구현: updateTasksCategoryBatch · server/task_categories.go · 정확한 handler 근거

요청

요청 body 상한: 16 KiB (16384 bytes) · source server/task_categories.go::decode/direct category request · 초과/decoder 경로 413 "请求正文过大".

요청 판정: C/P · unknown field 거부 미설정.

응답·오류

공통 helper 오류 분기: writeTaskCategoryError (server/task_categories.go::writeTaskCategoryError: 400/409/404/500). Status union은 helper control-flow를 정적으로 펼친 P이며 runtime DB 결과는 관찰하지 않았다.

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, errors.As, normalizeBatchTaskIDs, parseCategoryIDField, s.m.SetTasksCategory, s.m.Task, writeTaskCategoryError; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/task-templates

구현: pgListTaskTemplates · server/task_templates.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: err != nil · pg == nil

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: err.Error, pg.ListTaskTemplates; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/task-templates

구현: pgCreateTaskTemplate · server/task_templates.go · 정확한 handler 근거

요청

요청 body 상한: 512 KiB (524288 bytes) · source server/task_templates.go::decodeTaskTemplateRequest · 초과/decoder 경로 413 "请求正文过大".

요청 판정: C/P · unknown field 거부 미설정. 공유 decoder/helper: decodeTaskTemplateRequest; helper 내부 size/presence validation은 같은 source evidence에서 확인하며 operation 단독 AST 판정은 P.

응답·오류

공통 helper 오류 분기: writeTaskTemplateErr (server/task_templates.go::writeTaskTemplateErr: 400/409/404/500). Status union은 helper control-flow를 정적으로 펼친 P이며 runtime DB 결과는 관찰하지 않았다.

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: buildTaskInterceptRules, decodeTaskTemplateRequest, err.Error, pg.CreateTaskTemplate, stringValue, validateTaskTemplateRequest, writeTaskTemplateErr; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

PATCH /api/task-templates/{id}

구현: pgUpdateTaskTemplate · server/task_templates.go · 정확한 handler 근거

요청

요청 body 상한: 512 KiB (524288 bytes) · source server/task_templates.go::decodeTaskTemplateRequest · 초과/decoder 경로 413 "请求正文过大".

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: req.Name == nil && req.Description == nil && req.Goal == nil && !catPresent && !rulesPresent 공유 decoder/helper: decodeTaskTemplateRequest; helper 내부 size/presence validation은 같은 source evidence에서 확인하며 operation 단독 AST 판정은 P.

응답·오류

공통 helper 오류 분기: writeTaskTemplateErr (server/task_templates.go::writeTaskTemplateErr: 400/409/404/500). Status union은 helper control-flow를 정적으로 펼친 P이며 runtime DB 결과는 관찰하지 않았다.

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: buildTaskInterceptRules, decodeTaskTemplateRequest, err.Error, pathInt, pg.PatchTaskTemplate, validateTaskTemplateRequest, writeTaskTemplateErr; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

DELETE /api/task-templates/{id}

구현: pgDeleteTaskTemplate · server/task_templates.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !deleted · !ok · err != nil · pg == nil

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음.
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, pathInt, pg.DeleteTaskTemplate; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/tasks/{id}

구현: getTask · server/server.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: applyTaskArchiveBlocker, r.PathValue, s.m.PG, s.m.PG().TaskArchiveBlockers, s.m.Task, taskDTO; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

PATCH /api/tasks/{id}

구현: updateTaskMetadata · server/task_metadata.go · 정확한 handler 근거

요청

요청 body 상한: 16 KiB (16384 bytes) · source server/task_metadata.go::updateTaskMetadata · 초과/decoder 경로 413 "请求正文过大".

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: request.Name != nil · request.Name == nil && request.Pinned == nil

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, errors.As, r.PathValue, s.m.Task, s.m.UpdateTaskMetadata, taskDTO, utf8.RuneCountInString; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

PATCH /api/tasks/{id}/category

구현: updateTaskCategory · server/task_categories.go · 정확한 handler 근거

요청

요청 body 상한: 16 KiB (16384 bytes) · source server/task_categories.go::decode/direct category request · 초과/decoder 경로 400 err.Error().

요청 판정: C/P · unknown field 거부 미설정.

응답·오류

공통 helper 오류 분기: writeTaskCategoryError (server/task_categories.go::writeTaskCategoryError: 400/409/404/500). Status union은 helper control-flow를 정적으로 펼친 P이며 runtime DB 결과는 관찰하지 않았다.

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, parseCategoryIDField, r.PathValue, s.m.SetTaskCategory, s.m.Task, taskDTO, writeTaskCategoryError; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/tasks/{id}/intercept-rules

구현: taskInterceptListRules · server/task_intercept.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok \|\| taskID <= 0 · err != nil · pg == nil · rules == nil

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: err.Error, pathInt, pg.Assets, pg.Assets().ListTaskInterceptRules; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/tasks/{id}/intercept-rules

구현: taskInterceptCreateRule · server/task_intercept.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정.

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, pathInt, pg.Assets, pg.Assets().CreateTaskInterceptRule, validateTaskInterceptRuleReq; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

PUT /api/tasks/{id}/intercept-rules/{rid}

구현: taskInterceptUpdateRule · server/task_intercept.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정.

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, pathInt, pg.Assets, pg.Assets().UpdateTaskInterceptRule, validateTaskInterceptRuleReq; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

DELETE /api/tasks/{id}/intercept-rules/{rid}

구현: taskInterceptDeleteRule · server/task_intercept.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok \|\| ruleID <= 0 · !ok \|\| taskID <= 0 · err != nil · pg == nil

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음.
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, pathInt, pg.Assets, pg.Assets().DeleteTaskInterceptRule; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/tasks/{id}/intercept-rules/{rid}/toggle

구현: taskInterceptToggleRule · server/task_intercept.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정.

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, pathInt, pg.Assets, pg.Assets().ToggleTaskInterceptRule; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/tasks/control/batch

구현: controlTasksBatch · server/task_control.go · 정확한 handler 근거

요청

요청 body 상한: 256 KiB (262144 bytes) · source server/task_control.go::controlTasksBatch · 초과/decoder 경로 400 "bad json: " + err.Error().

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: req.Action != "pause" && req.Action != "resume"

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, json.NewDecoder, json.NewDecoder(r.Body).Decode, normalizeBatchTaskIDs, s.m.Task; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/task-archives

구현: listTaskArchives · server/task_archives.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: err != nil

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: page, q, size.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: err.Error, r.URL.Query, r.URL.Query().Get, s.m.pg.ListTaskArchives; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/task-archives/{id}

구현: getTaskArchive · server/task_archives.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · err != nil · item == nil

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: err.Error, pathInt, s.m.pg.GetTaskArchive; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/tasks/{id}/archive

구현: queueTaskArchive · server/task_archives.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · err != nil 직접 parse/default: strconv.ParseInt(id, 10, 64)

응답·오류

Helper 오류 분기: writeArchiveError · server/task_archives.go::writeArchiveError · 위 404, 409, 500 status는 helper control-flow를 정적으로 펼친 P이며 호출 전/후 DB 효과는 operation별로 확인한다.

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: persistent archive/restore/delete queue 접수; archive row의 state/phase가 완료 기준.
• 직접 협력자/실행 단서: canonicalTaskID, r.PathValue, s.m.pg.QueueTaskArchive, writeArchiveError; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/tasks/archive/batch

구현: queueTaskArchivesBatch · server/task_archives.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 parse/default: strconv.ParseInt(id, 10, 64)

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: persistent archive/restore/delete queue 접수; archive row의 state/phase가 완료 기준.
• 직접 협력자/실행 단서: err.Error, normalizeBatchTaskIDs, s.m.pg.QueueTaskArchive; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/task-archives/{id}/restore

구현: queueTaskArchiveRestore · server/task_archives.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · err != nil

응답·오류

Helper 오류 분기: writeArchiveError · server/task_archives.go::writeArchiveError · 위 404, 409, 500 status는 helper control-flow를 정적으로 펼친 P이며 호출 전/후 DB 효과는 operation별로 확인한다.

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: persistent archive/restore/delete queue 접수; archive row의 state/phase가 완료 기준.
• 직접 협력자/실행 단서: pathInt, s.m.pg.QueueTaskArchiveRestore, writeArchiveError; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/task-archives/restore/batch

구현: restoreTaskArchivesBatch · server/task_archives.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: normalizeArchiveIDs: len 1..100, every id > 0; duplicate ids removed preserving first occurrence

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: persistent archive/restore/delete queue 접수; archive row의 state/phase가 완료 기준.
• 직접 협력자/실행 단서: normalizeArchiveIDs, s.m.pg.QueueTaskArchiveRestore; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

DELETE /api/task-archives/{id}

구현: queueTaskArchiveDelete · server/task_archives.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · err != nil

응답·오류

Helper 오류 분기: writeArchiveError · server/task_archives.go::writeArchiveError · 위 404, 409, 500 status는 helper control-flow를 정적으로 펼친 P이며 호출 전/후 DB 효과는 operation별로 확인한다.

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음.
• Side effect/completion: 202 접수; 후속 state/API를 확인.
• 직접 협력자/실행 단서: pathInt, s.m.pg.QueueTaskArchiveDelete, writeArchiveError; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/task-archives/delete/batch

구현: deleteTaskArchivesBatch · server/task_archives.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: normalizeArchiveIDs: len 1..100, every id > 0; duplicate ids removed preserving first occurrence

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: persistent archive/restore/delete queue 접수; archive row의 state/phase가 완료 기준.
• 직접 협력자/실행 단서: normalizeArchiveIDs, s.m.pg.QueueTaskArchiveDelete; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/tasks/{id}/coverage

구현: taskCoverage · server/server.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · !t.CoverageEnabled · as == nil · err != nil 직접 parse/default: strconv.ParseInt(t.ID, 10, 64)

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: as.TaskCoverageWithSources, err.Error, r.PathValue, s.m.Assets, s.m.Task; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/tasks/{id}/coverage-graph

구현: taskCoverageGraph · server/server.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · as == nil · err != nil 직접 parse/default: strconv.ParseInt(t.ID, 10, 64)

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: as.BuildCoverageGraph, err.Error, r.PathValue, s.m.Assets, s.m.Task; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/tasks/{id}/asset-refs

구현: taskAssetRefs · server/server.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · assetID <= 0 · err != nil 직접 parse/default: strconv.ParseInt(r.URL.Query().Get("asset_id"), 10, 64)

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: coverageAssetRefDTO, err.Error, r.PathValue, r.URL.Query, r.URL.Query().Get, s.m.Task, t.Store.AssetRefsWithSources; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/tasks/{id}/assets

구현: attachTaskAssets · server/task_assets.go · 정확한 handler 근거

요청

요청 body 상한: 512 KiB (524288 bytes) · source server/task_assets.go::attachTaskAssets · 초과/decoder 경로 413 "请求正文过大".

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: request.Scope != nil · request.Scope != nil && len(request.AssetIDs) > 0

응답·오류

공통 helper 오류 분기: writeTaskAssetError (server/task_assets.go::writeTaskAssetError: 400/404/500). Status union은 helper control-flow를 정적으로 펼친 P이며 runtime DB 결과는 관찰하지 않았다.

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, errors.As, parseTaskID, r.PathValue, s.m.Assets, s.m.Assets().AttachAssetsToTask, s.m.Assets().RegisterTaskAssetScopes, s.m.Task, task.Notify, writeTaskAssetError; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

DELETE /api/tasks/{id}/assets/{assetID}

구현: detachTaskAsset · server/task_assets.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !detached · !ok · err != nil

응답·오류

공통 helper 오류 분기: writeTaskAssetError (server/task_assets.go::writeTaskAssetError: 400/404/500). Status union은 helper control-flow를 정적으로 펼친 P이며 runtime DB 결과는 관찰하지 않았다.

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음.
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: parseTaskID, pathInt, r.PathValue, s.m.Assets, s.m.Assets().DetachAssetFromTask, s.m.Task, task.Notify, writeTaskAssetError; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/tasks/{id}/intent-assets

구현: taskIntentAssets · server/task_assets.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · err != nil

응답·오류

공통 helper 오류 분기: writeTaskAssetError (server/task_assets.go::writeTaskAssetError: 400/404/500). Status union은 helper control-flow를 정적으로 펼친 P이며 runtime DB 결과는 관찰하지 않았다.

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: parseTaskID, r.PathValue, s.m.Assets, s.m.Assets().IntentAssets, s.m.Task, writeTaskAssetError; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/workspace/list

구현: wsList · server/workspace.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !fi.IsDir() · !ok · err != nil · out[i].Dir != out[j].Dir

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: e.Info, e.IsDir, e.Name, err.Error, fi.IsDir, filepath.Join, info.ModTime, info.ModTime().UnixMilli, info.Size, os.ReadDir, os.Stat, r.URL.Query, r.URL.Query().Get, sort.Slice; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/workspace/read

구현: wsRead · server/workspace.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · bytes.IndexByte(data, 0) >= 0 \|\| !utf8.Valid(data) · err != nil · fi.IsDir() · fi.Size() > maxWorkspaceRead

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: bytes.IndexByte, err.Error, fi.IsDir, fi.Size, os.ReadFile, os.Stat, r.URL.Query, r.URL.Query().Get, utf8.Valid; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/workspace/write

구현: wsWrite · server/workspace.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정.

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: []byte, err.Error, fi.IsDir, filepath.Clean, filepath.Dir, os.MkdirAll, os.Stat, os.WriteFile; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/workspace/mkdir

구현: wsMkdir · server/workspace.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정.

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, filepath.Clean, os.MkdirAll; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

DELETE /api/workspace/delete

구현: wsDelete · server/workspace.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · abs == filepath.Clean(s.m.dir) · err != nil

응답·오류

응답 schema 판정: C · 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음.
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, filepath.Clean, os.RemoveAll, os.Stat, r.URL.Query, r.URL.Query().Get; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/workspace/download

구현: wsDownload · server/workspace.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · err != nil \|\| fi.IsDir()

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: fi.IsDir, filepath.Base, os.Stat, r.URL.Query, r.URL.Query().Get, sanitizeFilename, w.Header, w.Header().Set; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/workspace/upload

구현: wsUpload · server/workspace.go · 정확한 handler 근거

요청

요청 body 상한: 512 MiB (536870912 bytes) · source server/workspace.go::wsUpload · 초과/decoder 경로 400 "解析上传失败或超出大小限制：" + err.Error().

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · !okd · err != nil · err != nil \|\| !fi.IsDir() · len(files) == 0 · name == "" \|\| name == "." \|\| name == ".."

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, fi.IsDir, filepath.Base, filepath.Join, os.Stat, r.ParseMultipartForm, r.URL.Query, r.URL.Query().Get, saveUpload; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/tasks/{id}/scope

구현: taskScopeList · server/server.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · as == nil · err != nil 직접 parse/default: strconv.ParseInt(t.ID, 10, 64)

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: as.ListTaskScopeWithSources, err.Error, r.PathValue, s.m.Assets, s.m.Task; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/tasks/{id}/scope

구현: taskScopeAdd · server/server.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 parse/default: strconv.ParseInt(t.ID, 10, 64)

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: as.AddAgentScope, err.Error, json.NewDecoder, json.NewDecoder(r.Body).Decode, r.PathValue, s.m.Assets, s.m.Task; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

DELETE /api/tasks/{id}/scope/{sid}

구현: taskScopeDelete · server/server.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !deleted · !ok · as == nil · err != nil 직접 parse/default: strconv.ParseInt(r.PathValue("sid"), 10, 64) · strconv.ParseInt(t.ID, 10, 64)

응답·오류

응답 schema 판정: C · 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음.
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: as.DeleteTaskScope, err.Error, r.PathValue, s.m.Assets, s.m.Task; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/tasks/{id}/goals

구현: listGoals · server/goals_api.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · err != nil

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: err.Error, goalDTOs, r.PathValue, s.m.Task, t.Store.ListByKind; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/tasks/{id}/goals

구현: addGoal · server/goals_api.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정.

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, goalDTO, json.NewDecoder, json.NewDecoder(r.Body).Decode, r.PathValue, s.engine.beginTaskOperation, s.engine.decInflight, s.m.Task, t.NotifyGoal, t.Store.AddGoal, t.Store.GetNode, t.Store.Link, t.Store.OriginFactID; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

PATCH /api/tasks/{id}/goals/{gid}

구현: editGoal · server/goals_api.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 parse/default: strconv.ParseInt(r.PathValue("gid"), 10, 64)

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key/If-Match 없음; DB upsert/trigger/side effect 때문에 반복 의미를 handler별 확인(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, goalDTO, json.NewDecoder, json.NewDecoder(r.Body).Decode, r.PathValue, s.engine.beginTaskOperation, s.engine.decInflight, s.m.Task, t.NotifyGoalEdited, t.Store.GetNode, t.Store.UpdateGoalPayload; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

DELETE /api/tasks/{id}/goals/{gid}

구현: deleteGoal · server/goals_api.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · !s.engine.beginTaskOperation(t.ID) · err != nil · err != nil \|\| gid <= 0 · node == nil \|\| node.Kind != db.KindGoal 직접 parse/default: strconv.ParseInt(r.PathValue("gid"), 10, 64)

응답·오류

응답 schema 판정: C · 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key/If-Match 없음; 반복 시 응답/존재 검사가 달라질 수 있음.
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, goalDTO, r.PathValue, s.engine.beginTaskOperation, s.engine.decInflight, s.m.Task, t.NotifyGoalDeleted, t.Store.DeleteGoal, t.Store.GetNode; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

GET /api/tasks/{id}/constraints

구현: listConstraints · server/constraints_api.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정. 직접 validation: !ok · err != nil

응답·오류

응답 schema 판정: P · top-level key는 직접 추출했지만 derived/helper/opaque 또는 nested type이 남음.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: read/stream 요청; stream 재연결은 cursor 계약에 따름.
• Side effect/completion: 직접 조회/파일 전송 완료; 외부 조회가 있으면 응답 전 handler 결과만 보장.
• 직접 협력자/실행 단서: constraintDTOs, err.Error, r.PathValue, s.m.Task, t.Store.ListConstraints; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

POST /api/tasks/{id}/constraints

구현: addConstraint · server/constraints_api.go · 정확한 handler 근거

요청

요청 판정: C/P · unknown field 거부 미설정.

응답·오류

응답 schema 판정: C · 직접 scalar/static top-level key와 field type을 추출; nested 내부 schema는 별도 type 참조가 없으면 P.

목록·동시성·완료

• Pagination/filter/sort: 등록된 직접 query key 중 표준 paging/filter key 없음.
• Idempotency/concurrency: Idempotency-Key 없음; unique constraint 또는 상태 check가 있는 경우만 중복을 제한(P).
• Side effect/completion: handler의 직접 mutation/호출 후 응답; 외부 전달·agent 실행이 파생되면 별도 상태 확인(P).
• 직접 협력자/실행 단서: err.Error, json.NewDecoder, json.NewDecoder(r.Body).Decode, normalizeConstraintKind, r.PathValue, s.engine.beginTaskOperation, s.engine.decInflight, s.m.Task, t.Store.AddConstraint; direct go statement는 미발견. 이 목록은 helper 내부의 background launch나 transaction 경계를 펼치지 않으므로 그 부분은 P/U다.
• 종합 의미 판정: P/U; route/auth와 위에서 직접 확인한 branch·shape는 C지만, 모든 helper·derived response·중첩 DTO·외부 효과까지 완결됐다는 뜻은 아니다.

PATCH /api/tasks/{id}/constraints/{cid}

구현: editConstraint · server/constraints_api.go · 정확한 handler 근거

요청