@cliphijack/santaclaude 1.0.30 → 1.0.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cliphijack/santaclaude",
-  "version": "1.0.30",
+  "version": "1.0.31",
   "publishConfig": { "access": "public" },
   "description": "SantaClaude 커넥터 — 클라우드 예약을 내 로컬 Claude(tmux)에 발사",
   "bin": { "santaclaude": "./santaclaude.js" },

package/santaclaude.js

@@ -423,6 +423,60 @@ description: 산타 Gbrain — 내 노트·문서·지식 폴더에서 답을
 - 큰 폴더면 grep으로 먼저 좁히고 **필요한 파일만 read**(토큰 절약).
 - 정리·요약 요청이면 여러 파일 read 후 종합 + 끝에 출처 목록.
 - 노트는 사용자 로컬에만 있고 우리 서버를 거치지 않는다(프라이버시).
+`
+  },
+  'santa-notion': {
+    'SKILL.md': `---
+name: santa-notion
+description: 산타클로드 노션 — 이 프로젝트를 노션으로 팔로우. "노션 읽기"는 이 프로젝트 PRD·기획·이 세션 활용법을 노션에서 찾아 브리핑, "노션 쓰기"는 이번 세션의 변경·패치를 보고형식으로 세션 페이지에 남김. 웹터미널 노션탭의 📖읽기·✍️쓰기 버튼이 이 스킬을 호출.
+---
+
+# 산타클로드 노션 — 프로젝트 팔로우
+
+이 세션이 맡은 프로젝트를 노션으로 추적한다. 유저는 노션으로 "이 프로젝트가 뭐고, 이 세션으로 뭘 할 수 있고, 지금까지 뭐가 바뀌었나"를 본다. 읽기=맥락 파악, 쓰기=진행 보고.
+
+## 인증
+- 자격증명은 \`~/.santaclaude/.env\`: \`NOTION_TOKEN\`(ntn_…), \`NOTION_PARENT_PAGE\`(부모 페이지 32자 id).
+- REST 직접 호출(정식 MCP 아님). 헤더: \`Authorization: Bearer <NOTION_TOKEN>\`, \`Notion-Version: 2022-06-28\`.
+- ⚠️ 부모 페이지에 통합을 **Connections로 연결** 안 하면 토큰이 있어도 403. 제일 흔한 실패 — 안 되면 이걸 먼저 의심·안내.
+
+## 📖 노션 읽기 — 프로젝트 맥락 브리핑
+유저가 "노션 읽기"를 트리거하면, 이 프로젝트와 이 세션 활용법을 노션에서 찾아 유저에게 읊는다.
+1. 유저가 특정 주제를 물었으면 그것 위주. 안 물었으면 이 프로젝트 **개요 → PRD → 이 세션으로 할 수 있는 일(활용법)** 순으로.
+2. \`POST /v1/search\` 로 관련 페이지·DB 검색(쿼리: 프로젝트명·"PRD"·"활용법"·"가이드"). 통합이 접근 가능한(=Connections 연결된) 것만 검색된다.
+3. 후보 페이지를 \`GET /blocks/{id}/children\` 로 본문 읽어 요약 브리핑. 각 핵심이 **어느 노션 페이지에서 왔는지** 밝힌다.
+4. 노션에 근거가 없으면 "노션에 해당 내용 없음"이라 말하고 **지어내지 말 것.**
+
+## ✍️ 노션 쓰기 — 프로젝트 변경 보고
+유저가 "노션 쓰기"를 트리거하면, **이번 세션에서 진행한 변경·패치를 보고 형식으로** 노션 이 세션 페이지에 남긴다. 즉흥 메모가 아니라 변경로그 틀을 지킨다.
+
+### 세션 페이지 잡기
+- \`~/.santaclaude/notion/<세션창이름>.id\` 가 있으면 그 page_id 재사용.
+- 없으면 부모(\`NOTION_PARENT_PAGE\`) 밑에 \`POST /v1/pages\` 로 \`🦌 <세션창>\` child_page 생성 → 받은 id를 \`~/.santaclaude/notion/<세션창>.id\` 에 캐시(파일명은 URL 인코딩). **매번 새로 만들면 안 됨 — 캐시 필수.**
+
+### 보고 형식 (이 블록 구성 그대로 append)
+- heading_3: \`📌 <YYYY-MM-DD> · <한 줄 제목>\`
+- bulleted_list_item × N: 변경·패치 요약 (한 일마다 한 줄)
+- paragraph(선택): \`영향: …\` 무엇이 바뀌어 무엇에 영향
+- paragraph(선택): \`다음: …\` 후속 작업
+
+append는 \`PATCH /blocks/<page_id>/children\` 의 children 배열로. 한 번에 100블록까지, rich_text 2000자 한계(길면 슬라이스). 맨 밑에 시간순 누적된다.
+
+### 절차
+1. 유저가 추가로 적을 내용을 말했으면 반영. 안 했으면 **이번 세션 작업 내역으로 초안을 잡아** 위 형식으로 보여주고 "이대로 남길까?" 확인받는다.
+2. 확인되면 세션 페이지에 append.
+3. 남긴 뒤 "노션에 남겼어 — <제목>" 한 줄. 웹터미널 노션탭 흐름 타임라인에 바로 뜬다.
+
+### 일석이조 — 세션 자기 기록도 함께
+노션은 **사람**을 위한 거지만, 이 세션이 자체 메모리·일지 관습을 가졌다면(프로젝트 CLAUDE.md·AGENTS 가이드에 메모리/일지 경로가 명시돼 있으면) **같은 변경 보고를 거기에도 남긴다.**
+- **일지**(daily/저널 폴더가 있으면): 오늘 날짜 일지에 같은 변경 요약을 한 단락 누적.
+- **메모리**(메모리 시스템이 있으면): 단, 메모리는 변경로그 전부가 아니라 이번에 **새로 확정된 결정·합의·바뀐 사실**만 선별해 저장(코드·git에서 자명한 건 제외).
+한 번의 "쓰기"로 **사람용(노션)과 세션용(메모리/일지)을 동시에** — 따로 또 적느라 일을 두 번 하지 않는다. 세션 관습이 없으면 노션만 남기면 된다.
+
+## 규칙
+- 토큰은 \`~/.santaclaude/.env\` 에서만 읽는다. 코드·로그·노션 본문에 토큰 노출 금지.
+- 모든 시각 한국(KST), 날짜 YYYY-MM-DD.
+- 노션은 유저 것 — 부모 페이지 밖을 함부로 건드리지 말 것.
 `
   }
 };