브라우저 핸드오프(A안)로 MCP 전용 토큰을 발급받고, 선택한 워크스페이스/프로젝트를 현재 레포(루트)별로 저장한다.

브라우저 창이 열리면 평소처럼 로그인(Google·로컬 모두 가능)한 뒤 '연결 허용'을 누른다. 인증 토큰은 사용자 단위로 공유되고, 워크스페이스/프로젝트는 이 레포에만 적용된다. → 레포마다 한 번씩 gdc_login하면 레포별로 다른 프로젝트를 자동으로 쓴다.

현재 레포(루트)에 적용되는 워크스페이스/프로젝트 컨텍스트를 반환한다.

create_task/list 등에서 어떤 프로젝트가 쓰일지 확인하는 용도. roots 미지원 환경에서는 글로벌 fallback 값을 반환한다.

현재 사용자가 접근 가능한 워크스페이스 목록(전환용).

지정 워크스페이스의 프로젝트 목록(전환용).

현재 레포 컨텍스트 워크스페이스의 고객사 목록을 조회한다.

create_task/update_task의 customer를 이름으로 지정하기 전에 후보를 확인하는 용도. search를 주면 이름·대표자·담당자 이름으로 부분 검색한다(생략 시 전체). 반환된 id 또는 name을 customer 인자로 넘기면 된다.

권한(고객사 열람) 없는 워크스페이스는 서버가 빈 목록을 주므로 count=0이면 고객사가 없거나 열람 권한이 없는 것이다.

현재 레포의 워크스페이스/프로젝트를 전환한다(재인증 없이, 토큰 유지).

이미 로그인된 상태에서 작업 대상 프로젝트만 바꿀 때 사용한다.

프로젝트별 커스텀 status/priority/task_type enum을 조회한다.

status는 category(planned/in_progress/done)를 포함한다. 완료 상태 = category=='done', 미완료 상태 = 그 보집합. 태스크 생성/수정/필터 전에 유효한 값과 '미완료 집합'을 확인하는 용도.

현재 사용자(assignee/creator/participant)의 태스크 목록을 조회한다.

조회 대상 프로젝트는 현재 레포에서 gdc_login으로 선택한 프로젝트(레포별 컨텍스트)로 고정된다. 그 프로젝트의 미완료 집합으로 서버측 필터링하므로 정확하다. 저장된 프로젝트가 없으면 부득이 mine 전체에서 클라이언트 필터링한다(첫 페이지만 보므로 누락 가능).

• not_finished=True: 완료(category=='done')가 아닌 상태만

• overdue=True: 계획 종료일이 지난 것만

• undated=True: 계획 종료일이 없는(날짜 미정) 것만 (주간 싱크의 '날짜 미정'과 동일)

특정 담당자의 태스크를 현재 레포 프로젝트에서 조회한다.

assignee는 user id 또는 멤버 이름(full_name/username) — 자동으로 id로 해석한다. 조회 프로젝트는 현재 레포에서 gdc_login으로 저장한 프로젝트로 고정한다(미설정 시 오류). 필터는 list_my_tasks와 동일: not_finished(미완료만)/overdue(마감 지남)/undated(날짜 미정). "내" 태스크는 list_my_tasks를, 특정 담당자는 이 도구를 쓴다.

현재 레포 프로젝트에서 키워드·필터로 태스크를 검색한다.

조회 범위는 현재 레포에서 gdc_login/set_context로 선택한 프로젝트로 고정된다(미설정 시 오류). "내 태스크"는 list_my_tasks, "특정 담당자 태스크"는 list_tasks가 더 간단하다 — 이 도구는 키워드나 여러 조건을 조합할 때 쓴다.

• query: 제목·본문·댓글(멘션) 통합 검색어. 생략 가능(필터만으로도 조회된다). 주의: 서버가 결과를 번호 내림차순(고정 태스크 우선)으로 재정렬하므로 관련도순이 아니다 — 매칭이 많으면 "가장 관련 있는 N건"이 아니라 "매칭 중 최신 N건"이 온다. 응답의 total_matched로 전체 매칭 수를 확인하고, 필요하면 필터를 좁히거나 limit을 올린다.

• query는 root_only와 함께 쓸 수 없다(검색이 매칭한 하위 태스크가 통째로 걸러진다).

• status/priority/task_type: 상태·우선순위·유형 이름 목록(합집합). 값은 get_project_enums 참고.

• assignee/participant/customer: user id 또는 멤버 이름, 고객사 id 또는 고객사 이름 허용.

• planned_end_from/planned_end_to: 계획 종료일 범위(YYYY-MM-DD).

• not_finished: 완료(category=='done')가 아닌 상태만. status를 직접 주면 그 값이 우선한다. 기본값은 False라 완료된 태스크도 함께 나온다(끝난 태스크를 찾는 것도 검색의 목적이다). list_my_tasks/list_tasks는 반대로 미해결만 보는 도구라 기본값이 True다 — "미완료만" 검색하려면 not_finished=True를 명시해야 한다.

• overdue: 계획 종료일이 지난 것만(서버 필터). not_finished와 독립이다.

• undated: 계획 종료일이 없는 것만. 서버 필터가 없어 200건을 받아 거르므로, 200건을 넘는 프로젝트에서는 누락될 수 있다.

• ordering: number/title/status/priority/progress/created_at/updated_at/planned_*/actual_* 중 하나 (내림차순은 '-' 접두, 예: '-planned_end_date'). 생략 시 서버 기본(번호 내림차순).

• 응답: count(반환 건수)·total_matched(서버 전체 매칭 수)·tasks(요약 목록).

태스크를 생성한다. 필수: project(프로젝트 ID), title.

[입력 수집 권장 흐름 — Desktop·Code 공통] 호출 전에 사용자에게 컬럼을 선택지로 하나씩 물어보고 고른 값을 넘긴다:

1. get_context로 현재 프로젝트 확인 → get_project_enums로 status/priority/task_type/members 조회.

2. 제목·내용(description)·예상 시작/종료일만 자유 입력으로 받는다.

3. status/priority/task_type/관련자는 **선택 질문(AskUserQuestion)**으로 제시 — 보기는 한글 label, 각 질문에 반드시 "건너뛰기" 포함(실제 값 최대 3개, 나머지는 "기타"로). 고른 값의 name(관련자는 user id)을 넘긴다.

4. 담당자(assignee)는 묻지 않는다(생략 시 로그인 사용자로 자동 등록 = 작성자와 동일).

[description — 라벨 섹션 템플릿(평문)] 본문은 평문 한 문단으로 넣지 말고 아래 템플릿으로 작성해 넘긴다. 도구가 GDC 리치텍스트(HTML)로 변환한다(라벨→볼드 문단, -→목록, 섹션 사이 빈 문단). [요약] 요청 내용 한두 줄 요약

[AS-IS]        ← 선택(TO-BE와 짝): 구현 전 상황이 실제로 드러날 때만
구현 전 상황

[TO-BE]        ← 선택(AS-IS와 짝)
구현 후 상황

[작업 내용]
- 실제 산출물 단계를 블렛(`-`)으로 한 줄씩

※ [요약]·[작업 내용]=필수, [AS-IS]/[TO-BE]=선택(짝) — 전/후 상황이 불명확하면 생략(추측·빈말 금지). ※ 체크박스 표시([ ]/[x])는 넣지 않는다(진행 상태는 progress 필드가 담당). ※ 빌드·타입체크·검증·테스트·lint·커밋·배포·버전 범프·'INDEX.md 이력 추가' 같은 프로세스 메타 단계는 넣지 않는다(실제 산출물 단계만). ※ 이미 HTML(태그로 시작)을 넘기면 변환 없이 그대로 저장된다.

값 형식: status/priority/task_type은 해당 프로젝트 enum의 'name', 날짜는 'YYYY-MM-DD'. assignee·participant_ids는 user id 또는 멤버 이름(full_name/username)을 넘기면 자동으로 id로 해석한다.

확장 필드(사용자가 명시할 때만 전달 — 질문으로 강요하지 않음): parent(상위 태스크 id), customer(고객사 id 또는 이름 — 이름은 현재 워크스페이스에서 자동 해석, 모호하면 후보 안내), actual_start_date/actual_end_date, progress(0~100), weight(비중 % — WBS 프로젝트 전용, 비WBS는 호출 전 차단. 형제 그룹 비중 합 100 초과는 서버가 검증).

태그는 지정할 수 없다 — 서버가 태스크의 태그를 본문·댓글의 tagMention에서만 동기화하므로 태그 id를 보내도 무시된다(읽기는 get_task의 tags로 가능).

제약(미충족 시 호출 전 ValueError로 안내·차단): 예상/실제 시작일 ≤ 종료일, 실제 종료일 미래 불가, 담당자/관련자는 해당 프로젝트 멤버만 지정 가능.

완료 보정: status가 완료 계열(category=='done')이면 progress=100·실제 종료일=오늘을 자동 주입한다 (progress/actual_end_date를 직접 전달한 경우 그 값이 우선).

태스크를 부분 수정(PATCH)한다. 전달한 필드만 갱신된다.

[description — 라벨 섹션 템플릿(평문)] 본문을 교체할 때는 평문 한 문단이 아니라 create_task와 동일한 라벨 섹션 템플릿으로 넘긴다: [요약](필수) → 선택·짝인 [AS-IS]/[TO-BE] → [작업 내용](필수, - 블렛 한 줄씩). 도구가 GDC 리치텍스트(HTML)로 변환한다(이미 태그로 시작하는 HTML이면 그대로 통과). 체크박스([ ]/[x])와 빌드·검증·테스트·커밋·배포·버전 범프 같은 프로세스 메타 단계는 넣지 않는다. ※ 이 도구는 본문을 통째로 교체한다 — 일부 섹션만 고치거나 블렛만 덧붙일 때는 edit_task_description(replace_section/append_work)을 써서 인라인 이미지 유실을 막는다.

사용자가 수정 권한을 가진 모든 편집 필드를 노출한다(읽기전용 id/number/creator 제외). status/priority/task_type은 해당 프로젝트 enum 'name'(get_project_enums로 확인), 날짜는 'YYYY-MM-DD', parent는 ID. 태그는 수정할 수 없다 — 서버가 본문·댓글의 tagMention에서만 태그를 동기화한다(읽기는 get_task). assignee·participant_ids는 user id 또는 멤버 이름(full_name/username)을 넘기면 자동으로 id로 해석한다. customer는 고객사 id 또는 이름 — 이름은 현재 워크스페이스에서 검색해 정확 일치를 자동 채택, 모호하면 후보 목록으로 안내한다. weight(비중 %)는 WBS 프로젝트 전용 — 비WBS 태스크에 전달하면 호출 전 차단. parent 변경 시 서버가 weight를 자동 초기화한다(weight를 함께 전달하면 그 값 적용). 완료 상태(category=='done')로 전환하면 백엔드가 progress=100·actual_end_date를 자동 보정할 수 있다.

필드 해제(비우기): clear_fields에 필드명 리스트를 전달 — 가능: parent, assignee, customer, planned_start_date, planned_end_date, actual_start_date, actual_end_date, weight. 예) 실제 종료일 비우기 → clear_fields=["actual_end_date"], 고객사 해제 → clear_fields=["customer"]. 같은 필드에 값과 해제를 동시에 전달하면 오류. 관련자 전체 해제는 participant_ids=[].

제약(미충족 시 ValueError로 안내·차단): 예상/실제 시작일 ≤ 종료일, 실제 종료일은 미래 불가, 담당자/관련자는 해당 프로젝트 멤버만 지정 가능.

태스크 본문(description)을 통째 덮어쓰지 않고 최소 편집한다(인라인 이미지 보존).

본문을 재구성해 통째로 PATCH하면 <img data-attachment-id> 인라인 이미지가 유실된다. 이 도구는 현재 본문 HTML을 받아 필요한 부분만 편집해 PATCH하므로 편집 대상 밖 이미지가 자동 보존된다. 반영(문서→태스크) 흐름에서 추가 작업/내용 변경을 본문에 적용할 때 쓴다.

mode:

• "append_work": [label](기본 '작업 내용') 섹션 목록에 bullets를 <li>로 추가한다 (섹션/목록이 없으면 신설). 기존 내용·이미지 100% 보존. bullets 필수.

• "replace_section": [label] 섹션 본문만 new_body_html로 교체한다(라벨 문단·타 섹션 보존). 섹션에 인라인 이미지가 있으면 keep_media=True(기본)는 이미지를 섹션 끝으로 옮겨 보존, keep_media=False는 함께 삭제. new_body_html 필수(라벨 문단 제외한 본문 HTML).

task_id는 id(정수) 또는 제목(문자열). 편집 결과가 현재와 같으면 PATCH하지 않고 그대로 반환.

태스크 웹 화면을 Chrome 새 탭으로 연다.

목록에 표시되는 URL을 클릭하면 VSCode 내장 브라우저로 열릴 수 있으므로, 이 도구는 chrome.exe를 직접 실행해 항상 Chrome으로 연다(미설치 시 기본 브라우저).

태스크 상세를 조회한다(작업 요청 문서 생성·연동용).

task_id는 태스크 id(정수) 또는 제목(문자열) — 제목이면 현재 프로젝트에서 검색해 해석한다(정확 1건이면 채택, 다수면 후보 안내, 0건이면 오류).

제목/내용/상태/우선순위/유형/날짜/진행률/담당자 등 문서 작성에 필요한 필드와 함께 상위 태스크(parent)·하위 태스크(sub_tasks)·연관 태스크(related_tasks) 를 반환한다.

• sub_tasks: 이 태스크의 하위 태스크 요약 목록(휴지통 제외, 서버 가시성 필터 적용).

• related_tasks: outgoing/incoming 링크를 방향 유지로 통합({direction, link_type, task}).

• parent: 직속 상위 태스크 요약(없으면 null).

• update_task로 쓸 수 있는 값도 함께 읽는다 — actual_start_date/actual_end_date(실제 날짜), customer/customer_name(고객사), weight(비중, WBS 전용), is_pinned(고정), participants(관련자). 수정 전 현재 값 확인과 수정 후 반영 확인에 쓴다.

• 그 밖에 creator_name(작성자)·tags(태그 이름)·mention_count(댓글 수)·is_archived(숨김)· created_at/updated_at을 함께 반환한다. 상세 API 1회 호출로 모두 받으므로 추가 왕복이 없다(제목 해석 시 검색 1회 추가).

기존 태스크를 기존 작업 요청 문서와 연동한다.

문서 frontmatter에 task_id/task_url을 기록(upsert)하므로, 이후 sync_doc_progress·훅이 이 문서의 Phase/체크박스 진행률을 해당 태스크에 동기화한다. (새 태스크를 만들지 않음)

작업 요청 문서의 Phase 진척을 읽어 연결된 태스크 진행률·상태·실제 날짜를 동기화한다.

progress = 완료 Phase 수 / 전체 Phase 수 × 100 (한 Phase는 하위 체크박스가 전부 [x]일 때 완료). task_id 생략 시 문서 frontmatter의 task_id를 사용한다. 최초 진행 시 '진행'+실제 시작일, 100% 시 '완료'+실제 종료일로 자동 전이된다. description 전달 시 진행률 PATCH에 태스크 본문(description)도 함께 반영한다 — 문서 본문이 수정됐을 때 호출 에이전트가 '[작업 내용]' 요약을 재생성해 넘기는 용도(자동 훅은 진행률 전용). 이때 본문은 create_task와 동일한 라벨 섹션 템플릿(평문) 으로 넘긴다 — [요약](필수) → 선택·짝인 [AS-IS]/[TO-BE] → [작업 내용](필수, - 블렛). 도구가 GDC 리치텍스트(HTML)로 변환하며(태그로 시작하는 HTML은 그대로 통과), 체크박스·프로세스 메타 단계는 넣지 않는다.

작업 요청 문서로 태스크를 생성하고, 문서 frontmatter에 task_id/task_url을 기록한다.

• 제목: 문서의 첫 '# ' 헤딩에서 추출.

• description(필수): 호출하는 에이전트가 아래 라벨 섹션 템플릿(평문)으로 작성해 전달한다. 도구가 GDC 리치텍스트(HTML)로 변환해 저장한다(라벨→문단, 블렛→목록, 섹션 사이 빈 문단). [요약] 문서 "요청 내용" 한두 줄 요약

  [AS-IS] ← 선택(TO-BE와 짝): '요청 내용'·'배경'에서 구현 전 상황이 실제로 드러날 때만 구현 전 상황

  [TO-BE] ← 선택(AS-IS와 짝) 구현 후 상황

  [작업 내용]

  • 작업 결과 단계를 블렛(-)으로 간단히 요약 (각 단계 한 줄) ※ [요약]·[작업 내용]=필수, [AS-IS]/[TO-BE]=선택(짝). 전/후 상황이 불명확하면 생략(추측·빈말 금지) — 신규 기능·문서 작업엔 보통 빠진다. ※ 체크박스 표시([ ]/[x])는 넣지 않는다. 진행 상태는 태스크 progress 필드가 담당한다. ※ 빌드·타입체크·검증·테스트·lint·커밋·배포/동작 확인·'INDEX.md 이력 추가' 같은 프로세스 메타 단계는 넣지 않는다(실제 산출물 단계만). 넣더라도 도구가 자동 제거한다.

• status: 생략 시 문서 메타데이터 표의 상태를 보고 매핑한다 — done → '완료'(완료/closed 계열), partial → '진행'(in_progress). 그 외 값은 자동 매핑하지 않고 기본 상태로 둔다. status 인자를 주면 그 값이 우선한다.

• 완료 보정: 최종 status가 완료 계열(category=='done')이면 progress=100·실제 종료일=오늘을 자동 주입한다.

• task_type: 호출하는 에이전트가 문서 유형/본문을 근거로 프로젝트 enum에 맞춰 매칭해 전달한다(get_project_enums 참고).

• project: 생략 시 현재 레포에서 gdc_login으로 저장한 프로젝트(레포별 컨텍스트)를 사용.

• 담당자(assignee): 항상 로그인 사용자로 자동 등록(create_task와 동일).

태스크의 댓글(멘션) 목록을 조회한다. 최신순 상위 limit개를 시간순(오래된→최신)으로 반환.

서버 페이지네이션(PAGE_SIZE=20, page_size 미지원)상 한 요청으로 최대 20개만 받는다 — limit>20을 줘도 20개까지만 반환된다(가장 최근 댓글 우선). count는 태스크의 전체 댓글 수.

각 댓글: id, author_name(작성자 실명), text(HTML을 벗긴 평문), is_edited(수정됨 여부), created_at.

태스크에 댓글(멘션)을 작성한다. 필수: task_id, content(본문).

content는 평문으로 넘기면 GDC 리치텍스트(HTML)로 변환해 저장한다(이미 HTML이면 통과). mentions에 멤버 이름 또는 user id 리스트를 주면 각 멤버를 해석해 본문 맨 앞에 하이라이트 멘션 한 줄(GDC 에디터와 동일한 멘션 노드 — 화면에 볼드+강조색으로 표시)을 붙인다 → 서버가 이를 파싱해 멘션 알림을 발송한다. (멘션은 본문 선두에만 배치되며, 본문 중간 커서 위치 삽입은 지원하지 않는다.) 비멤버를 멘션하면 가능한 멤버 목록과 함께 오류로 안내한다.

댓글(멘션) 본문을 수정한다. 본인이 작성한 댓글만 수정 가능(아니면 오류).

주의: 서버가 새 content로 멘션을 다시 파싱해 덮어쓴다. 기존 멘션을 유지하려면 mentions 인자로 함께 넘겨야 하며, mentions 없이 수정하면 이전 멘션 알림 대상이 사라진다. mentions는 add_task_comment와 동일하게 본문 선두 하이라이트 멘션 한 줄로 삽입된다 (이미 멘션된 사용자에게 중복 알림은 가지 않는다 — 서버가 신규 멘션 델타만 발송). content는 평문→HTML 자동 변환(이미 HTML이면 통과).

댓글(멘션)을 삭제한다. 본인이 작성한 댓글만 삭제 가능(아니면 오류).

태스크를 숨기거나(archived=True) 숨김 해제한다(archived=False). 토글 API를 멱등 래핑한다.

task_id는 태스크 id(정수) 또는 제목(문자열) — 제목이면 현재 프로젝트에서 검색해 해석한다. 숨기면 모든 하위 태스크가 함께 숨김되고 고정(pin)은 자동 해제된다. WBS 프로젝트는 숨김 기능을 지원하지 않는다(안내). 숨김 해제는 상위가 숨김 상태면 막힌다(먼저 상위 숨김 해제).

확인 게이트: confirm=False(기본)면 대상과 현재/목표 상태만 미리보기로 반환하고 실행하지 않는다. confirm=True로 다시 호출해야 실제로 토글한다. 이미 원하는 상태면 호출 없이 그대로 둔다(멱등).

태스크를 삭제한다(소프트 삭제 → 휴지통 이동, 복구 가능). 관리자 이상 권한 필요.

task_id는 태스크 id(정수) 또는 제목(문자열) — 제목이면 현재 프로젝트에서 검색해 해석한다. 하위 태스크 처리: WBS 프로젝트는 하위 전체 연쇄 삭제, 비WBS는 직속 하위를 최상위로 승격 후 본체만 삭제한다(손자는 승격된 부모 밑 유지). 복구는 restore_task, 목록은 list_trashed_tasks.

확인 게이트: confirm=False(기본)면 삭제 대상과 하위 영향만 미리보기로 반환하고 삭제하지 않는다. confirm=True로 다시 호출해야 실제 삭제한다.

휴지통의 삭제된 태스크를 복구한다. 관리자 이상 권한 필요.

task_id는 태스크 id(정수) 또는 제목(문자열) — 삭제 태스크는 일반 검색에서 빠지므로 현재 프로젝트 휴지통에서 제목을 매칭한다. 존재하지 않거나 삭제되지 않은 태스크는 안내한다.

주의: 첨부 파일은 함께 복구되지만 연쇄 삭제된 하위 태스크는 복구되지 않고 휴지통에 남는다 (단건 + 자기 첨부만 복구). WBS 태스크는 원래 부모 밑이 아니라 최상위로 분리되고 비중(weight)이 해제된 상태로 복구된다.

확인 게이트: confirm=False(기본)면 대상·부작용만 미리보기로 반환하고 복구하지 않는다. confirm=True로 다시 호출해야 실제 복구한다.

현재 프로젝트 휴지통(삭제된 태스크) 목록을 조회한다. 복구(restore_task) 대상 식별용.

삭제된 태스크는 일반 조회(list_my_tasks/get_task)에서 빠지므로, 복구하려면 이 목록에서 id/제목을 확인한다. 각 항목에 삭제 시각(deleted_at)·삭제자(deleted_by)를 포함한다. 현재 레포 프로젝트로 스코프되며(project 명시 전송), 관리자 이상만 유효한 결과를 받는다. 한 요청으로 최대 100개까지 받아 최신 삭제순 상위 limit개를 반환한다(count는 전체 삭제 수).

내 알림 목록을 조회한다(조회 전용 — 읽음 처리는 하지 않는다).

멘션·담당자 변경·댓글·상태 변경 등 나를 수신자로 하는 알림을 최신순으로 반환하고, 미읽음 총 개수(unread_count)를 함께 준다.

• unread_only=True면 읽지 않은 알림만 조회한다.

• limit은 최대 99(서버 상한). 그보다 많이 요청해도 99로 자른다.

• 워크스페이스/프로젝트 스코프가 없다 — 서버가 수신자 기준으로만 거르므로 다른 워크스페이스의 알림이 섞여 온다. 항목의 project_name으로 구분한다.

• 각 항목의 url로 get_task/open_task를 이어서 호출할 수 있다.

나와 관련된 댓글 멘션 목록을 최신순으로 조회한다(조회 전용).

알림(list_my_notifications)과 달리 댓글 본문을 훑는 용도다 — 어떤 태스크에서 무슨 이야기가 오갔는지 확인할 때 쓴다.

• mention_type: 'mentioned'(나를 언급한 것)/'authored'(내가 쓴 것)/'both'(기본).

• 스코프: 현재 레포 컨텍스트의 워크스페이스 + 프로젝트를 기본 적용한다. project_id를 직접 주면 그 프로젝트로 바꿔 조회한다.

• date_from/date_to: 작성일 범위(YYYY-MM-DD). search: 댓글 본문 부분 일치.

• preview는 서버가 100자로 자른 조각을 평문화한 값이라 문장이 중간에서 끊길 수 있다. 전체 내용은 url이나 list_task_comments(task_id)로 확인한다.