auto-velog 초안 파이프라인

플러그인 루트를 $PLUGIN, 데이터 디렉토리를 ~/.auto-velog이라 한다.

0. 사전 체크

• ~/.auto-velog/PAUSE 파일이 존재하면 아무것도 하지 않고 종료한다.
• ~/.auto-velog/config.json을 읽는다 (없으면 "먼저 /auto-velog:setup 실행 필요" 로그 후 종료).
• ~/.auto-velog/queue/*.jsonl에서 "status":"pending" row를 모은다 (.processed.jsonl 제외). 없으면 종료.

1. 글감 심사 (worthiness gate)

각 pending row에 대해 10점 척도로 채점한다:

점수와 근거 한 줄을 draft frontmatter에 기록한다. 완결성 0점이면 즉시 skip (status: skipped로 처리하고 다음 row로).

2. 세션 분석

row의 transcriptPath를 Read하여 (200줄 초과 시 Grep으로 위치 파악 후 범위 Read):

• 문제의 최초 증상 (에러 메시지, 이상 동작 — 원문 인용할 것)
• 시도한 것들 — 실패한 시도 포함 (삽질 과정이 글의 진정성을 만든다)
• 결정적 해결 (실제 실행한 코드/명령어와 그 출력)
• 배운 점 / 일반화 가능한 교훈

code-refs가 가리키는 파일이 로컬에 있으면 해당 부분을 읽어 소스 예시로 쓴다.

3. 집필 (스타일 프로필)

config.style.referencePosts에 URL이 있으면 WebFetch로 말투·구성을 분석해 few-shot으로 쓴다. 없으면 아래 기본 프로필을 따른다:

기본 스타일 프로필:

• 구어체 존댓말 혼합. 개인 경험·고민으로 도입한다 (예: "저도 정확히 그 지점에서 헷갈렸습니다", "선발되면 열심히 해보고, 안 되면 …까지 생각했다")
• 핵심 결론을 앞에 제시한다 ("먼저 결론부터 봅시다")
• 소제목은 질문형·관찰형 ("린트 규칙은 어디까지 잡아야 할까")
• 시행착오와 심리를 구체적으로 기록한다 ("별것 아닌 내용이어도 긴장됐다")
• 세션에서 실제 실행한 코드·명령어·출력을 코드블록으로 인용한다
• 마무리는 배운 점 + 다음 목표/독자 제안

보충 리서치 (허용): 세션 내용만으로 본문이 빈약하거나 배경 설명이 필요하면 WebSearch/WebFetch로 조사한 내용을 정리해 추가해도 된다. 단:

• 보충은 심사를 통과한 글감을 살찌우는 용도다 — 완결성 0점 글감을 리서치로 살려내지 말 것 (심사 기준은 그대로)
• 세션에서 실제 겪은 일과 외부 자료를 뒤섞어 "내가 겪은 것처럼" 쓰지 말 것. 경험은 경험대로, 배경지식은 배경지식대로 자연스럽게 구분되게
• 외부 자료를 근거로 쓴 부분은 출처 링크를 남긴다

금지: AI 공문체("~에 대해 알아보겠습니다", "~하는 것이 중요합니다"), 서론/본론/결론 명시, 과한 밈체, 세션에 없던 사실 지어내기.

분량: config.style.targetLength (기본 3000자) 내외, 소제목 4~6개.

~/.auto-velog/drafts/YYYY-MM-DD-<slug>.md로 저장 (slug는 topic을 영문 소문자 케밥으로: a-z·0-9·-만. 한글 제목도 slug는 영문으로 옮겨 쓴다 — 자동 발행 명령은 jev-gate 허용 목록에서 ASCII 파일 이름만 통과한다):

---
title: <제목>
tags: <태그1>, <태그2>, <태그3>
session: <row.sessionId>
score: <심사 점수>
status: pending
---
<본문 — H1 없이 바로 시작>

4. 시크릿/PII 스캔 (블로킹 — 발행 전 필수)

node "$PLUGIN/scripts/secret-scan.mjs" ~/.auto-velog/drafts/<파일>.md

• exit 1 (탐지): findings의 각 항목을 보고, 글이 성립하는 선에서 레드액션 (192.168.0.42 → 192.168.x.x, 키 → sk-... 마스킹, 이메일 → 제거)한 뒤 재스캔한다. 레드액션이 불가능하면 frontmatter status: blocked로 바꾸고 발행하지 않는다.
• exit 0이어도 LLM 패스를 한 번 수행한다: 회사 내부 정보, 미공개 프로젝트명, 타인의 개인정보, 보안 사고의 미공개 세부사항이 본문에 없는지 스스로 검토하고, 있으면 제거하거나 blocked 처리한다.

5. 발행 결정

다음을 모두 만족할 때만 발행한다:

• config.publish.mode == "auto"
• score >= config.publish.minScore
• 오늘 발행 수(publish-log.jsonl에서 오늘 날짜 카운트) < config.publish.dailyCap

발행: skills/publish/SKILL.md의 절차를 따르되 자동 발행 명령(--auto)을 쓴다 (로그인 체크 → 발행 → 재시도 1회). publish.mjs는 시크릿 스캔·중복 발행 가드를 내부에서도 강제하므로(exit 3 = BLOCKED, STATUS:ALREADY_PUBLISHED), 이 절차를 건너뛰어도 유출·중복 발행은 일어나지 않는다 — 그래도 절차대로 사전 스캔을 해야 레드액션 기회가 생긴다. 발행하면 frontmatter status: published, 상한 초과면 status: deferred, approve 모드면 status: pending 유지.

6. 마무리 (row마다)

• 처리한 row를 원본 큐 파일에서 제거하고, status를 갱신해 ~/.auto-velog/queue/.processed.jsonl에 append한다 (dedup 시드로 쓰이므로 필수). 큐 파일 수정은 Write/Edit 도구로 한다 (headless 실행은 셸 파일 조작 권한이 없음).
• ~/.auto-velog/log.jsonl에 {ts, event, session, draft, score, status, url?} append.
• macOS 알림 (best-effort, 실패 무시):

  osascript -e 'display notification "<제목> — <status>" with title "auto-velog"' 2>/dev/null || true