Sonjapgo

pd_documents의 line_id를 기준으로 일부만 preview하거나 apply합니다. 먼저 mode=preview로 변경점을 확인한 뒤 사용자가 적용을 원할 때 mode=apply를 호출하세요. preview와 apply 모두 mcp_write 및 해당 프로젝트 owner/maintainer 권한이 필요합니다. 그 밖의 working 문서는 관리자 전용이며 전체 문서를 다시 쓰지 않습니다.

방금 적용한 최신 pd_documents patch를 기존 inverse operation으로 되돌립니다. 후속 patch가 있으면 안전을 위해 거부됩니다. mcp_write 및 해당 프로젝트 owner/maintainer 권한이 필요하며, 그 밖의 working 문서는 관리자 전용입니다.

기존 pd_documents 문서를 제목·ID로 찾습니다. 본인 Sondocs·본인 작업판·공용 안내, 승인된 프로젝트 작업지시서만 권한 범위에서 읽고 그 밖의 working 문서는 관리자 전용입니다. 작업지시서는 project_{project_id}_task_{task_id}_instruction을 먼저 검색하세요.

사용자 작업 요청(예: 손잡고 문서에 저장해줘)에 맞는 Skill.SonE·Template.SonE 정본 절차를 찾아 짧은 실행 순서를 반환합니다. 필요 MCP 도구 이름·입력·보호 경계·완료 확인만 담으며 장문 설명은 하지 않습니다. 실행·쓰기는 document_patch 등 기존 도구로 진행하고 how_to_do는 조회 전용입니다. skill_name으로 정확히 지정하거나 request로 자연어 검색하세요.

Meaning.SonE canonical 의미 정본을 name으로 정확히 한 건 조회합니다. 키워드·목록 탐색은 meaning_search를 사용하세요. 정본 miss 시 not_found, canonical lane 미가용 시 fail closed.

Meaning.SonE canonical 의미 정본을 q로 검색합니다. exact=true이면 이름 exact match 필터, false(기본)이면 부분 검색입니다. 단일 정본 name 조회는 meaning_get을 사용하세요. canonical lane 미가용 시 canonical_unavailable, legacy SonEson fallback 금지.

손잡고에 이미지·영상 미디어를 한 번 업로드해 canonical media_id와 URL로 저장합니다. content_base64에 파일 바이트(base64)를 넣습니다. data URL 접두사도 허용합니다. 이미지는 기존 prepare/upload/commit 파이프라인과 variant URL을 재사용합니다. 영상 v1은 mp4/webm/quicktime 단일 파일 저장만 지원합니다. owner_id 등 작성자 식별자는 입력으로 받지 않으며 OAuth actor만 사용합니다. mcp_write scope가 필요합니다.

Store an expiring personal notification for the authenticated user. Storage does not confirm app display or reading.

손잡고에 새 프로젝트를 실제로 생성합니다. 로그인한 OAuth 사용자 본인 명의로 등록하며 mcp_write scope가 필요합니다. owner는 서버가 OAuth actor로 주입하며 타인 owner_id는 지정할 수 없습니다. 손잡고 프로젝트는 누구나 등록할 수 있습니다. 운영정책 위반, 신고 또는 문제가 확인된 프로젝트는 블라인드 처리될 수 있습니다. 대화·참조문서만으로 판단했을 때 새 프로젝트가 필요해도, 사용자에게 「{제목}」을 새 프로젝트로 생성하시겠습니까? 형태로 먼저 확인하고 명시적 승인을 받은 뒤에만 호출하세요. 승인 전에는 호출하지 마세요. 기존 project_search·project_get으로 동일 제목·주제 프로젝트가 없는지 먼저 조회하세요.

프로젝트 핵심·참여 요약·상세 ref를 읽습니다. include_details=true로 기존 참여 맥락·AI 지침·메타 전문을 읽습니다. detail_sections로 필요한 상세 필드만 선택할 수 있습니다. Task는 참여 가능성의 경계가 아닌 발견된 필요의 지도입니다.

프로젝트 참여 신청 공개 wrapper. 기본 mode=preview로 저장 예정 내용·모집 상태·알림 효과를 먼저 보여 줍니다. 사용자가 preview를 확인하고 명시적으로 참여 의사를 밝힌 뒤에만 mode=apply, confirmed=true, 동일 preview_revision으로 호출하세요. actor는 OAuth 본인만 가능하며 user_id 주입은 거절됩니다. pending 저장이며 자동 승인·공식 출전 명단 확정·Wanted 대표 선정이 아닙니다. 모집 상태는 응답 recruitment와 participation_context.ai_action_guidance.action_kind로 구분하세요. recruitment_closed여도 AI 탐색(participation_context)은 유지될 수 있습니다.

프로젝트 탐색. 이름을 모르면 scope=my로 OAuth 본인의 소유·승인된 참여 목록을 조회합니다(query 생략 가능). 기본 scope=discover는 검색어 필수. 기본은 핵심 요약과 상세 ref이며 include_details=true로 기존 전체 응답을 읽습니다. count는 전체 일치 수, items는 limit까지입니다.

손잡고 프로젝트 작업을 기존 submit→verify workflow로 완료합니다. 담당자는 submit, 운영자(owner/maintainer)는 verify 또는 한 번에 submit 후 verify합니다. DB status를 직접 done으로 바꾸지 않습니다.

손잡고 프로젝트에 AI 작업안(제안)을 등록합니다. 소유자 호출이어도 즉시 실행 작업이 되지 않으며, 사람이 수정·확정(confirm)한 뒤 참여·실행합니다. 연결된 사용자의 propose 권한이 있어야 합니다. title은 참여자용 자연어(목적이 드러나는 한국어)로 작성한다. 테스트명·코드명·내부 식별자를 그대로 title에 넣지 않는다. 내용·우선순위 등이 동일한 생성 요청의 재시도는 기존 제안을 반환하며, 등록 후 수정·확정된 요청은 충돌로 안내할 수 있습니다.

프로젝트 작업 시작(담당 수락). 기본 mode=preview로 작업 제목·설명·마감·책임자 효과를 먼저 보여 주세요. 사용자가 preview 내용을 확인하고 실제 시작 의사를 밝힌 뒤에만 mode=apply, confirmed=true, 동일 preview_revision으로 호출하세요. confirmed/preview_revision은 동의의 증거가 아닙니다. 멤버십 자동 승인·공식 출전 대표가 아닙니다.

손잡고 프로젝트의 project_tasks(실행 정본)를 OAuth 사용자 기준으로 읽습니다. GET /api/projects/{id}/tasks 와 동일 데이터이며, is_my_share·home_bucket 으로 「내 몫」과 「남은 일」을 구분합니다. task_id를 주면 해당 작업만 반환합니다. 데이터를 변경하지 않습니다.

본인 owner·maintainer 권한으로 기존 프로젝트의 소개·상태·태그·협업 목적 메타를 부분 수정합니다. mcp_write scope가 필요합니다. project_get으로 현재 값을 확인한 뒤 사용자가 요청한 필드만 보내세요. 생략한 필드는 보존됩니다. 대표 미디어만 null로 연결을 해제할 수 있습니다. owner 변경·멤버십·운영·대회 카탈로그 필드는 수정할 수 없습니다. 수정 후 project 필드에 read-after-write 조회 결과가 포함됩니다.

SonEson 현재 작업(current-work) 요약을 조회합니다. active/next는 읽기 권한 있는 공개·프로젝트 기록의 요약이며 내 소유 목록이 아닙니다. 사용자 전체의 서버 지금 이 순간 판단(current_moment)을 함께 읽습니다. project_id를 지정하면 프로젝트 범위로 조회합니다.

SonEson 단건 상세. work_report status는 기록된 보고 상태이며 attributes.확인은 검토 상태입니다. 보고 기록·status_symbol은 Task 완료 증거가 아닙니다. 기본 structured, include_raw=true는 원문. BOOT 키: ChatGPT_부팅디스크_v0.1_현행본. 무결성 경고는 보존합니다.

최근 작업보고의 요약·주소 목록. 본문·결과·검증은 soneson_get(name)으로 읽습니다.

SonEson 데이터셋을 검색하고 project_id·task_id·doc_scope와 기존 dataset 필드로 좁힙니다. 기본 doc_scope=baseline(현행본·운영기준). work_report·과거 문서는 doc_scope=work_reports 또는 all을 명시. 세션 시작·연속 맥락은 q=부팅디스크 또는 BOOT_CURRENT 로 부팅디스크 현행본을 찾습니다.

새 SonTool 제작 초안을 시작합니다. 생성된 초안은 아직 공개되지 않으며, 반환된 session_id를 사용해 sontool_update로 내용을 편집하고 sontool_publish로 발행할 수 있습니다. preview_url은 소유자 로그인용 고정 미리보기 링크이며 장면 저장 후 확인합니다.

SonTool draft를 target=sceneplay|post 대상에 명시적으로 발행합니다. create/update와 공개 책임을 분리하며 owner/revision 권한을 재검증합니다. scene 초안의 post target은 지정된 기존 게시글에 연결하고 제목·본문을 보존합니다. 일반 초안의 post target은 기존대로 새 게시글을 만듭니다.

session_id 기준 SonTool draft를 부분 수정합니다. 반환된 preview_url을 사용자에게 제공하세요. 인증된 소유자만 같은 링크에서 최신 장면 초안을 확인하며 미리보기는 발행하지 않습니다. draft 본문(command) 또는 연결 media 참조(media_ids) 중 하나 이상을 갱신하며, base_revision으로 동시 수정(stale write)을 막습니다. scene={post_id,source_sha256,snapshot}으로 기존 게시글에 연결할 장면을 저장할 수 있으며 scene은 현재 base_revision과 함께 단독 편집합니다. 공개는 sontool_publish target=post에서 다시 검증합니다.

SonEson 원장에 type=thought_branch 생각의 가지를 생성합니다. 기본 비공개(@무)이며 author_user_id는 OAuth 인증 사용자에서 서버가 주입합니다. 조회는 soneson_search·soneson_get을 사용하세요.

소유자의 thought_branch를 allowlist 필드만 수정합니다. seed_text·source_type·source_id·source_excerpt·created_at·author_user_id 등 origin 필드는 변경할 수 없습니다. 링크는 links 배열로 갱신하세요.

지정한 프로젝트와 작업을 진행할 수 있도록 Work.SonE 작업판을 준비합니다. 목표, 현재 단계와 선택한 참고자료를 하나의 작업 맥락으로 묶으며 기존 다른 작업판은 삭제하거나 교체하지 않습니다. 추가 참고자료가 필요한 경우 soneson_search·soneson_get으로 찾은 결과를 canonical_hints로 전달할 수 있습니다.

OAuth 본인 Work.SonE. work_address/work_bundle_id로 선택. since_revision 없으면 full, 있으면 변경 필드만; resync_required면 revision 없이 재조회. 읽기는 다른 작업판을 변경하지 않습니다.

SonEson(SonE) 원장에 type=work_report 작업 보고를 실제로 생성합니다. 프로젝트 멤버만 작성할 수 있으며, project_id·task_id(선택)가 블록에 고정됩니다. 조회 전용이 아니라 SonEson.SonE 데이터셋에 새 보고 블록이 추가됩니다.

대상 Work.SonE bundle 변경분을 CAS(base_revision)로 갱신합니다. work_bundle_id 또는 work_address(작업 관점)로 대상 bundle을 지정합니다. 다른 bundle revision과 독립입니다.