Files

T

koriweb fa397d7fa1 v2.2.268-291: /email 통합(브리핑·스캔·워처) + stocks 자동편입·매수알림 + 지식문서·메신저 중앙화

[/email — Gmail + 클래식 Outlook (신규 기능군)]
- 기본 명령: brief(PM 업무 허브 대시보드)·list·read·wikify·reply(Drafts만)·open(Outlook 창 열기)
- Gmail: 자체 OAuth gmail.readonly 스코프 추가 (재연결 1회 필요) / Outlook: COM(PowerShell), 전 계정(Store)·하위 폴더(120개 가드) 수집, To/CC 판별
- 브리핑: 상태 3분류(결정/회신/확인만)·P등급 영향·프로젝트 위험도·Today Focus·오늘 완료 예상·기간 명시 시 표시 범위 제한
- 영속 상태(email_state.json): 회신대기/공넘김 상태머신, 창 밖 미회신 보존, done old N 일괄정리
- 워처: 주기 자동 수집 + 미회신 임계 알림(기본 끔) + 데일리 브리핑 '답할 이메일' 섹션
- 전체 스캔(/email scan): 자동 위키화(회차 15건·레지스트리·파일삭제 감지 재생성)·진행 표시(streamProgress)
- 자동발신 필터 확장(Confluence·AWS·광고·[Notification]) + 라벨 오타 후처리(polishBriefLabels)

[/stocks]
- discover 자동 편입(stocks.json) + 매수권장가 224일선 자동 산출
- 매수사정권 진입 전이 감지 → 텔레그램 1회 알림 (직전신호 추적)
- 버그 수정: '미충족'이 .includes('충족')에 오탐되던 필터 판정

[지식 문서 파이프라인 통일 (wikiFormat/wikiSave)]
- PC 로컬 직접 저장 (NAS 볼륨 미아 문제 해소) — 설정 폴더 → 두뇌 → 워크스페이스
- 이메일 전용 Email_Wiki 분리(email.wikifySavePath) + 봉투(frontmatter) 자동 통일
- 정본 프롬프트 단일 빌더(buildKnowledgeWikiPrompt) — web/email 래퍼화, 템플릿 fetch 일원화
- 이메일 문서 시점 3중 방어: 기준시점 헤더·제목=메일 최신일·날짜 없는 현재형 금지
- docs/WIKI_DOC_PIPELINE.md 개발 규약

[텔레그램 메신저 중앙화 (messageFormat)]
- 단일 렌더러 renderTelegram — 5개 발신 빌더(주식보고·매수시그널·Top5·데일리·미회신) 통일
- 주식 보고 시각 하드코딩 제거(messenger.stocksReportTimes CSV) + 알림 토글 2종
- 설정 패널 '메신저' 탭 신설 · '이메일' 토글 섹션(Gmail/Outlook on/off)

테스트 803개 통과 (이메일 상태머신·CC판별·포맷·매수전이·봉투 등 60+ 신규)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-03 18:57:12 +09:00

3.2 KiB

Raw Permalink Blame History

위키 문서 파이프라인 — 포맷 통일 규약 (v2.2.278)

새 기능이 위키/지식 문서를 만들 때 반드시 이 문서를 따른다. 기능마다 포맷이 하나씩 새로 생기던 파편화(wikify ≠ meet ≠ email …)를 끊기 위한 규약.

구조 (2층)

[생성]  buildKnowledgeWikiPrompt(src)     ← 지식형 문서의 단일 프롬프트 빌더
              │  (P-Reinforce 정본: frontmatter + 🎯/🧠/🧩/📖/🔗/📚 섹션)
              ▼
[저장]  persistWikiDoc(title, content, { store, docType, sources })
              │  ① 봉투: frontmatter 없으면 정본 봉투 자동 부착 (ensureFrontmatter)
              │  ② 위치: 설정 폴더 → 두뇌/<종류별 폴더> → 워크스페이스 (로컬 직접 저장)
              ▼
        brain 검색 · 지식 그래프에 자동 편입

핵심 모듈: src/features/datacollect/wikiFormat.ts (정본 fetch·봉투·공용 빌더) · wikiSave.ts (저장).

새 기능 추가 시 딱 2가지

1) 지식형 문서 (소스를 지식으로 합성 — wikify류)

KnowledgeSource 하나 정의해서 공용 빌더 호출. 새 프롬프트 골격을 만들지 말 것.

import { buildKnowledgeWikiPrompt, getCanonicalFormat } from '../datacollect/wikiFormat';

const canonical = await getCanonicalFormat();          // 브리지 정본 (10분 캐시, 실패시 내장 사본)
const prompt = buildKnowledgeWikiPrompt({
    kind: 'slack',                                     // 소스 종류
    topic: '채널 논의 제목',
    body: transcript,                                  // 근거 원문 (30,000자 컷은 빌더가)
    meta: { 채널: '#dev', 기간: '…' },                  // [소스 메타] 표시
    sourceRef: 'slack:#dev/2026-07-03',                // [S1] 출처 + raw_sources
    extraRules: ['이 소스 종류만의 특수 규칙…'],          // 번호는 빌더가 이어붙임
    trustHint: '내부 교신이므로 A~B 로',                 // source_trust_level 평가 힌트
}, canonical);
// → callLmSynthesis(prompt, WIKIFY_SYSTEM류) → persistWikiDoc(..., { docType: 'slack' })

기존 래퍼 예시: wikifyPrompt.buildWikifyPrompt(web) · buildEmailCanonicalWikifyPrompt(email) — 이 패턴을 복사할 것.

2) 보고서형 문서 (자기 본문 구조가 있는 산출물 — meet/benchmark/review류)

본문 구조는 자유. 저장만 반드시 persistWikiDoc + docType — 봉투(frontmatter)가 자동 통일된다.

import { persistWikiDoc, describeSave } from '../datacollect/wikiSave';
const saved = await persistWikiDoc(title, report, { docType: 'meeting', sources: [원본파일] });
chunk(view, describeSave(saved, '회의록'));

금지 사항

❌ 자체 frontmatter 골격을 손으로 작성 (봉투는 ensureFrontmatter가 담당)
❌ 브리지 /api/wiki/template 를 직접 fetch (→ getCanonicalFormat() 사용, 캐시 공유)
❌ bridgeFetch(wiki.save) 직접 호출 (→ persistWikiDoc — 로컬 저장·폴더 규칙·폴백 포함)
❌ 프롬프트에 섹션 구조 하드코딩 (정본 템플릿은 브리지 wiki_format.mjs 가 단일 소유)

현재 등록된 docType

wikify(web) · email · meeting · benchmark · youtube · review

3.2 KiB Raw Permalink Blame History