Slack에 링크 하나를 던지면,
Notion 콘텐츠가 완성된다

메시지 wrapper에 없는 채널 ID·스레드 ts를 로컬 세션 상태 파일에서 읽어 보완합니다.

핵심 코드 · read_last_slack_ctx.mjs// Slack 이벤트 메타에는 채널ID·ts가 없을 때가 있다 → 세션 상태 파일에서 직접 읽는다
const p = path.join(os.homedir(), '.openclaw', 'agents',
  'notion-codex-writer', 'sessions', 'sessions.json');
const entry = JSON.parse(fs.readFileSync(p, 'utf8'))[sessionKey];

// "channel:C012..." 형태에서 채널 ID만 정규식으로 추출
const slackChannelId = parseChannelId(entry.lastTo);
const slackThreadTs  = String(entry.lastThreadId).trim();

일반 URL은 web_fetch, 본문 추출이 불안정한 도메인은 Firecrawl로 폴백. 짧거나 nav/footer만 오면 실패로 간주하고 재시도합니다.

핵심 코드 · firecrawl_scrape_markdown.mjs// Firecrawl(MCP)을 CLI로 호출. 결과 JSON을 모델에 통째로 주지 않는다
const res = spawnSync('mcporter', ['call', 'firecrawl.firecrawl_scrape',
  '--args', argsJson, '--output', 'json']);

// jq는 응답 속 제어문자에서 깨진다 → 직접 제거 후 파싱하는 게 안전
const clean = String(res.stdout).replace(/[\u0000-\u001F]/g, '');
const md = JSON.parse(clean).markdown ?? '';   // markdown 본문만 뽑음

원문을 읽고 한글 제목·요약·TL;DR 5개·섹션별 본문·이미지 아이디어를 구조화된 JSON으로 만듭니다.

산출물 · tmp_plan.json (LLM이 이 계약을 채운다)// 스크립트에 넘길 유일한 "데이터 계약". Slack에 JSON 전문을 붙이지 않는다
{
  "title_ko": "'읽지 않은 코드도 배포한다'는 선언 …",
  "author": "요즘IT · 트파원",       // 원문 저자 (요청자 아님)
  "tldr_bullets": [ /* 정확히 5개 */ ],
  "sections": [{ "h1": …, "toggle_title": …,
     "image_placeholders": [/* 페이지 전체 3~5개 */],
     "bullets": [ … ] }]
}

제어문자를 제거하고 파싱 가능 여부를 확인합니다. jq가 제어문자에 깨지는 문제를 회피하는 전용 도구.

핵심 코드 · json_minify_sanitize.mjs// 제어문자를 지운 뒤 파싱 → 성공해야 다음 단계로 넘어간다
const clean = String(raw).replace(/[\u0000-\u001F]/g, '');
try { var obj = JSON.parse(clean); }
catch (e) { process.exit(1); }        // 파싱 실패 = 검증 실패

process.stdout.write(JSON.stringify(obj));  // 한 줄(minify)로 출력

Slack ctx 로드 + --planFile 전달 + 실패 시 재시도 + "최종 실패 댓글 1개만" 정책을 담당합니다.

핵심 코드 · run_notion_apply_from_files.mjslet r1 = runApply({ planFilePath: planFile });
if (r1.status === 0) process.exit(0);           // 성공하면 그대로 종료

// 'Invalid plan JSON'일 때만 sanitize 후 1회 재시도 (그 외엔 재시도 안 함)
if (shouldRetryPlanParse) r2 = runApply({ planFilePath: planMinPath });

// 끝내 실패하면 스레드에 실패 댓글을 "1개만" 남긴다 (중간 실패는 숨김)
await slackPostMessage({ token, channelId, threadTs, text });

URL 중복 체크 → 페이지 생성 → 속성/본문 블록 작성 → 소요시간 기록 → Slack 완료 보고. LLM 호출 없음.

핵심 코드 · notion_apply.mjsconst existing = await queryByUrl(notionKey, dbid, url, props.URL);
if (existing) {                       // 같은 URL이면 스킵 (업데이트도 금지)
  return { action: 'skipped', reason: 'URL_EXISTS' };
}
// 가드레일: 저자가 요청자와 같으면 버리고, 없으면 '알수없음'
if (authorNorm === requestedByNorm) author = '';
if (!author) author = '알수없음';
if (tldr.length !== 5) die('TL;DR must have exactly 5 bullets');

플레이스홀더 문단을 찾아 이미지를 생성(Gemini) → GitHub 레포에 커밋·푸시 → raw URL 200 검증 → Notion 이미지 블록으로 교체.

핵심 코드 · notion_images_replace.mjs// 본문에서 "[이미지 플레이스홀더]"로 시작하는 문단만 골라낸다
const targets = children.filter(b =>
  b.type === 'paragraph' && isImagePlaceholderText(b.text));

// 생성 → GitHub 커밋/푸시 후, raw URL이 200일 때만 Notion에 삽입
if (await verifyHttp200WithRetry(s.rawUrl) !== 200) die('raw url not 200');
await insertAfterInPage(notionKey, pageId, s.placeholderId, imgBlock);
await notionRequest(notionKey, 'DELETE', `/blocks/${s.placeholderId}`); // 자리표시자 제거