v0.2.1 — 템플릿 다양성 회귀 수정 / Template Diversity Regression Fix

템플릿 다양성 회귀 수정 / Template diversity regression fix — 실 Notion E2E 5종(쉬움~어려움) 생성 테스트로 발견·수정.

한국어

0.2.0의 셀러빌리티 셸이 모든 템플릿에 무조건 주입돼 형식이 균일해지고 'My Template' 플레이스홀더가 노출되던 회귀를 수정.

Fixed

• rollup 샘플 링크 폴백 — rollup을 먹이는 relation이 샘플 제목 불일치/누락으로 한 줄도 연결 안 됐을 때 대상 샘플을 라운드로빈 배정 → rollup 항상 실값 집계
• 'My Template' 누출 — 제목을 top-level/main_page/metadata 순으로 해석
• generic '데이터베이스 N' — DB명을 description 핵심 명사·title 속성에서 유추(작가/책/판매)

Changed

• 셀러빌리티 셸 적응형화 — 온보딩=멀티DB만, 네비=하위페이지 ≥2, 목차=heading ≥3 (단순=린·복잡=리치, 다양성 복원)
• metadata.layout 기록

English

Fixes a regression where 0.2.0's sellability shell was injected into every template uniformly (homogenizing layouts) and leaked a 'My Template' placeholder.

Fixed

• Rollup sample-link fallback — round-robin assigns target samples when a rollup-feeding relation has no resolvable links, so rollups always aggregate
• 'My Template' placeholder leak — title resolved from top-level/main_page/metadata
• Generic 'Database N' names — inferred from description nouns / title property

Changed

• Adaptive sellability shell — onboarding for multi-DB only, nav for ≥2 subpages, TOC for ≥3 headings (lean vs rich; diversity restored)
• metadata.layout recorded

검증/Verified: 독서(1DB·린) ↔ 출판사(3DB·linked_view 5·리치), rollup 집계(습관/CRM/OKR), My Template 0건 · 백엔드 1,556 테스트 · ruff clean.

---

Changes

• chore: v0.2.1 — 다양성 회귀 수정 릴리스 (버전 bump + 문서 최신화)
• fix: 템플릿 다양성 회귀 수정 — 균일 셸 적응형화
• fix: rollup 샘플 링크 폴백 오토링커 추가

Supply Chain

• SBOM (SPDX) 첨부됨 — notionforge-sbom.spdx.json

Docker Images

docker pull ghcr.io/jaylenai/notion_forge-backend:latest
docker pull ghcr.io/jaylenai/notion_forge-frontend:latest

Quick Start

git clone https://github.com/JaylenAI/Notion_Forge
cd notionforge
cp .env.example .env
docker compose up -d

Full Changelog: v0.2.0...v0.2.1

v0.2.0 — 유료급 품질 업그레이드 / Premium-Quality Upgrade

Changes

• docs: README 0.2.0 전면 최신화 — 품질엔진·judge→repair·셀러빌리티·recolor·버전히스토리·토큰집계 반영, dead 주장 정정
• fix: CI Backend Lint — test_b1_modify.py ruff format 적용
• fix: uv.lock 버전 0.2.0 동기화 (pyproject 일치)
• chore: v0.2.0 릴리스 — 버전 bump + 문서 확정
• chore: C3 위생·정직화 — 死코드 제거·하드코딩 봉합·README 정직화 (Phase 6)
• feat: 토큰 집계 실측 + 품질 회귀 게이트 (Phase 5 C1+C2 1차)
• feat: 버전 히스토리/롤백 — 캔버스 UX (Phase 4/B2 1차)
• feat: AI 대화형 수정 1차 — LLM 분류기 + recolor (Phase 3/B1)
• fix: 실 Notion E2E 품질 보정 — DB명 유추·status 옵션·하네스 rollup 검증
• feat: 품질 신호 표시 + 가짜 데이터 제거 (Phase 2)
• feat: judge→repair 루프 — 품질 심사 결과를 재생성에 연결 (Phase 1)
• feat: 도메인 예시 검색·주입 추가 (Phase A5, 축A 완료)
• feat: 품질 게이트 + 결정성 + QualityValidator 수정 (Phase A4)
• feat: 시각 프리미엄 보강 추가 (Phase A3)
• feat: 셀러빌리티 레이어 추가 (Phase A2)
• feat: 유료급 품질 측정 인프라 추가 (Phase A1)

Supply Chain

• SBOM (SPDX) 첨부됨 — notionforge-sbom.spdx.json

Docker Images

docker pull ghcr.io/jaylenai/notion_forge-backend:latest
docker pull ghcr.io/jaylenai/notion_forge-frontend:latest

Quick Start

git clone https://github.com/JaylenAI/Notion_Forge
cd notionforge
cp .env.example .env
docker compose up -d

Full Changelog: v0.1.7...v0.2.0

v0.1.7 — Stabilization / 안정화 (End-to-End Working)

Changes

• fix: health 테스트 하드코딩 버전 제거 — version 동적 참조
• fix: CI 그린화 — ruff format 적용 + 라이브 E2E를 CI에서 skip
• chore: v0.1.7 릴리스 — 버전 bump + 문서 라벨 확정
• docs: list-form properties 수정 반영 + 테스트 수 1,461
• fix: AI가 properties를 list로 반환 시 dict 정규화 — smart_fallback 유발 크래시 제거
• docs: 영문/국문 릴리스 노트 추가 (docs/RELEASE_NOTES.md)
• docs: v0.2.0 문서 최신화 — provider 폴백/recipe/테스트수 반영
• fix: CRM recipe 딜 샘플에 예상 마감일 추가 — 남은일수 formula 미계산 수정
• feat: 모든 AI provider 실패 시 generic 폴백 사용을 명확히 고지
• fix: provider 폴백 robustness + AI 무title/무DB명 한국어 기본값
• docs: 0.2.0 기준 문서 최신화 (CHANGELOG/CURRENT_STATUS/README)
• fix: Groq/OpenAI json 모드 400 방지 + AI 무title 시 한국어 제목 폴백
• fix: 차트 뷰 x_axis/y_axis가 dict여도 크래시 없이 정규화
• refactor: 미사용 중복 채팅 UI 제거 (ChatWindow 체인)
• fix: WS 미연결 시 무생성 함정 제거 + 실제 UI 생성 E2E 추가
• fix: AI 파이프라인 relation 링크/rollup 집계 복구 — 라이브 5종 검증
• fix: 2차 정밀리뷰 CRITICAL/MED 수정 — dual_property 제거 + 로깅/CI 보강
• fix: 2차 코드리뷰 결함 5건 수정 (WS rate limit + notion I/O)
• docs: 게이트 완료 현황 반영 (CURRENT_STATUS/CHANGELOG)
• feat: Gate6 — a11y 린트(eslint-plugin-jsx-a11y) 도입
• test: Gate4 — Playwright E2E 스모크 + eslint dist 무시
• docs: Gate6 — 예제 갤러리 (생성물 쇼케이스)
• test: Gate4 — 프론트엔드 Vitest 셋업 + CI 통합
• docs: Gate6 — 거버넌스 파일 + 문서 정직화 (공개 준비)
• feat: Gate4/5 — Prometheus /metrics + 라이선스 CI + SBOM
• feat: Gate5 — 버전 SSOT(app.version) + setup.sh env키 수정 + 버전 일치 CI
• feat: Gate4 — 메트릭 요약에 p50/p95 지연 + 토큰 집계
• feat: Gate3/4 — CI 통합테스트 포함 + agent_loop function-calling 예산 카운트
• feat: Gate3 — rate limiter jitter/Retry-After + query 페이지네이션
• feat: Gate2 — 품질 스코어카드 배선 (quality_validator 고아 해소)
• feat: Gate2 — 플래그십 OKR advanced 골든셋 + 파생속성 라운드 재시도
• feat: Gate2 — 샘플 relation 링크로 rollup 실집계 시연
• feat: Gate2 QUAL-6 — number 통화/퍼센트 포맷 지원
• docs: v1.0 하드닝 진행사항 문서 최신화
• test: TEST-COV-01 — provider-on-None 폴백 후보 로직 추출 + 단위테스트
• feat: Gate2 DATA-1 — 양방향 relation dual_property로 rollup 실집계 활성화
• fix: Phase0 자기검증 결함 — 서브페이지 콘텐츠 누락/제목 과삭제/예산가드/loop_result
• fix: AI 생성 실패 시 작동하는 provider로 폴백 — 실제 AI 생성 보장
• fix: 제목에서 색상/스타일 지시 제거 + AI 파이프라인 라이브 QA
• fix: 단일 DB formula 누락 수정 + 라이브 QA 하네스 추가
• fix: sub_page name/title 키 호환 — 라이브 E2E에서 발견한 생성 크래시 수정
• feat: Gate2 QUAL-2 — 핵심 스킬에 필수 계산속성 가이드 명문화
• feat: Gate2 SEC-17 — 세션 LLM 호출 예산 (비용 폭주 방지)
• feat: Gate2 — 골든 예시 rollup/formula 강화 + 골든 품질게이트
• feat: Gate2 P0 — rollup/formula 실주입 + 버전핀 + 레시피 품질게이트
• fix: Gate1 마무리 — agent_loop 노출 + task store 정리
• fix: Gate1 HIGH 보안/안정성 — agent_loop 하드캡 + CORS/CSP/WS DoS 방어
• fix: Gate1 CRITICAL 안정성 봉합 — fallback/approval/result/import 배선
• chore: Gate0 공개 전 보안 차단 — gitleaks/pre-commit + custom_skills 위생

Supply Chain

• SBOM (SPDX) 첨부됨 — notionforge-sbom.spdx.json

Docker Images

docker pull ghcr.io/jaylenai/notion_forge-backend:latest
docker pull ghcr.io/jaylenai/notion_forge-frontend:latest

Quick Start

git clone https://github.com/JaylenAI/Notion_Forge
cd notionforge
cp .env.example .env
docker compose up -d

Full Changelog: v0.1.6...v0.1.7

v0.1.6

🇬🇧 EN — v0.1.6: Documentation Overhaul + Version Unification

Changed

• New English README.md — the original Korean README was split out to README.ko.md
• Unified versioning — frontend (8.1.0), backend (0.1.4), and docs (v8.x) all consolidated to v0.1.6
• Full documentation refresh — ARCHITECTURE, API, DEPLOYMENT, TEST_GUIDE, SKILL_GUIDE, BLOCK_SUPPORT, CURRENT_STATUS, AGENT_DESIGN, ROADMAP, SECURITY
• Test count updated 1,359 → 1,374; routers 7 → 8
• Added 5 missing variables to .env.example (RATE_LIMIT_RPM, CORS_ORIGINS, INPUT_MIN/MAX_LENGTH, APPROVAL_TIMEOUT_SECONDS, GEN_EVAL_MAX_RETRIES)

---

🇰🇷 KR — v0.1.6: 문서 전면 최신화 + 버전 통합

변경

• 영문 README.md 신규 작성 — 기존 한국어 README는 README.ko.md로 분리
• 전체 버전 통합 — frontend(8.1.0), backend(0.1.4), 문서(v8.x)를 모두 v0.1.6으로 일원화
• 문서 전면 최신화 — ARCHITECTURE, API, DEPLOYMENT, TEST_GUIDE, SKILL_GUIDE, BLOCK_SUPPORT, CURRENT_STATUS, AGENT_DESIGN, ROADMAP, SECURITY
• 테스트 수 1,359 → 1,374개, 라우터 7 → 8개 반영
• .env.example에 누락 변수 5개 추가

---

Docker Images

docker pull ghcr.io/jaylenai/notion_forge-backend:latest
docker pull ghcr.io/jaylenai/notion_forge-frontend:latest

Quick Start

git clone https://github.com/JaylenAI/Notion_Forge
cd notionforge
cp .env.example .env
docker compose up -d

Full Changelog: v0.1.4...v0.1.6

v0.1.4

🇬🇧 EN — v0.1.4: Security Hardening

Security

• OAuth token delivery reworked — removed URL-fragment exposure; switched to a one-time exchange-code flow
• SecurityHeadersMiddleware added — X-Content-Type-Options, X-Frame-Options, X-XSS-Protection, Referrer-Policy
• .gitignore hardened — *.pem, *.key, *.p12, credentials.json, service-account*.json
• _pending_states DoS guard — capped at 1,000 entries
• sanitize_error() on SSE streaming errors — prevents internal-info leakage
• Added a "local-only server" security warning to the README

---

🇰🇷 KR — v0.1.4: 보안 강화

보안

• OAuth 토큰 전달 방식 변경 — URL fragment 노출 제거, 일회용 교환 코드 방식으로 전환
• SecurityHeadersMiddleware 추가 — X-Content-Type-Options, X-Frame-Options, X-XSS-Protection, Referrer-Policy
• .gitignore 보강 — *.pem, *.key, *.p12, credentials.json, service-account*.json
• _pending_states DoS 방어 — 최대 1,000개 제한
• SSE 스트리밍 에러에 sanitize_error() 적용 — 내부 정보 노출 방지
• README에 "로컬 전용 서버" 보안 경고 추가

---

Docker Images

docker pull ghcr.io/jaylenai/notion_forge-backend:latest
docker pull ghcr.io/jaylenai/notion_forge-frontend:latest

Quick Start

git clone https://github.com/JaylenAI/Notion_Forge
cd notionforge
cp .env.example .env
docker compose up -d

Full Changelog: v0.1.3...v0.1.4

v0.1.3

🇬🇧 EN — v0.1.3: Docker Tag Fix + Banner

Fixed

• Docker image tag lowercase conversion — fixes the GHCR repository name must be lowercase push error
• Replaced the README banner with a custom PNG image

---

🇰🇷 KR — v0.1.3: Docker 태그 수정 + 배너 교체

수정

• Docker 이미지 태그 소문자 변환 — GHCR push 시 repository name must be lowercase 에러 수정
• README 배너를 커스텀 PNG 이미지로 교체

---

Docker Images

docker pull ghcr.io/jaylenai/notion_forge-backend:latest
docker pull ghcr.io/jaylenai/notion_forge-frontend:latest

Quick Start

git clone https://github.com/JaylenAI/Notion_Forge
cd notionforge
cp .env.example .env
docker compose up -d

Full Changelog: v0.1.2...v0.1.3

v0.1.2 — Stabilization / 안정화

🇬🇧 EN — v0.1.2: Stabilization

Fixed

• FOUC (Flash of Unstyled Content) — prevented Material Symbols icon-text exposure on hard refresh
  • Inline critical CSS in index.html (#root { opacity: 0 }), font-display: block, document.fonts.ready-based reveal (3s timeout)
• 2 ruff lint errors (N806, F541); ruff format applied to 3 files

Changed

• Repo rename notion_ai_agent → Notion_Forge across 17 files
• Docs refresh (ARCHITECTURE, AGENT_DESIGN, CURRENT_STATUS, CHANGELOG, DEPLOYMENT, README, CLAUDE.md)
• Documented dual-API strategy (write 2022-06-28 / read·view 2026-03-11); PostProcessor 13 auto-fixes

Added

• widget_builder tests (12), workers ops tests (38) — total 1,359 tests (80.30% coverage)

---

🇰🇷 KR — v0.1.2: 안정화 릴리스

수정

• FOUC(Flash of Unstyled Content) — 새로고침 시 Material Symbols 아이콘 텍스트 노출 방지
  • index.html critical CSS 인라인(#root { opacity: 0 }), font-display: block, document.fonts.ready 기반 reveal(최대 3초)
• ruff 린트 오류 2건(N806, F541), 3개 파일 ruff format 적용

변경

• 레포명 notion_ai_agent → Notion_Forge 전체 반영(17개 파일)
• 문서 최신화, 듀얼 API 전략 문서화(쓰기 2022-06-28 / 읽기·뷰 2026-03-11), PostProcessor 13종 자동 수정

추가

• widget_builder 테스트 12개, workers ops 테스트 38개 — 총 1,359개(커버리지 80.30%)

---

Docker Images

docker pull ghcr.io/jaylenai/notion_forge-backend:latest
docker pull ghcr.io/jaylenai/notion_forge-frontend:latest

Full Changelog: v0.1.0...v0.1.2

v0.1.0 — First Open-Source Release / 첫 오픈소스 공개

🇬🇧 EN — v0.1.0: First Open-Source Release

The first public open-source release of NotionForge — an AI agent that turns natural language into expert-grade Notion workspaces.

Added — Notion API dual-version + Workers integration

Phase 1 — API modernization + dual-version strategy

• Dual Notion API: write (2022-06-28) + read/view/Workers (2026-03-11). Added a legacy client to work around 2026-03-11 ignoring DB properties at creation time
• Comments API, File Upload API, Data Sources API

Phase 2 — 13 feature expansions

• Advanced filter builder (relative dates, multi-value, "me", AND/OR), widget builder (chart/number/list/filter-view), Dashboard & Form views, View Query API, numbered-list formats, DB query filter_properties, page template_id

Phase 3 — Notion Workers integration

• Workers API (Sync/Tool/Webhook CRUD + logs), External Agents API, TypeScript scaffold builder, CreateWorkerTool / RegisterAgentTool, Tool Registry 9 → 11

Phase 4 — open-source release prep

• Notion CLI wrapper, CI api-docs job, full documentation, branch cleanup → main + dev

Core

• AI Agent: Plan-Execute-Reflect loop + 11-tool registry; 48 domain skills (12 Tier-1 + 36 Tier-2); 5 AI providers (Copilot/Claude/Gemini/Groq/OpenAI)

---

🇰🇷 KR — v0.1.0: 첫 오픈소스 공개 릴리스

자연어를 전문가급 Notion 워크스페이스로 만들어주는 AI 에이전트, NotionForge의 첫 오픈소스 공개 릴리스.

추가 — Notion API 듀얼 버전 + Workers 통합

Phase 1 — API 최신화 + 듀얼 버전 전략

• 듀얼 Notion API: 쓰기(2022-06-28) + 읽기/뷰/Workers(2026-03-11). 2026-03-11이 DB 생성 시 속성을 무시하는 문제를 legacy 클라이언트 병행으로 해결
• Comments API, File Upload API, Data Sources API

Phase 2 — 13개 기능 확장

• 고급 필터 빌더(상대 날짜·multi-value·"me"·AND/OR), 위젯 빌더(차트/숫자/리스트/필터뷰), Dashboard·Form 뷰, View Query API, 번호 리스트 포맷, DB 쿼리 filter_properties, 페이지 template_id

Phase 3 — Notion Workers 통합

• Workers API(Sync/Tool/Webhook CRUD + 로그), External Agents API, TypeScript scaffold 빌더, CreateWorkerTool/RegisterAgentTool, Tool Registry 9 → 11

Phase 4 — 오픈소스 배포 준비

• Notion CLI 래퍼, CI api-docs 잡, 문서 전면 정비, 브랜치 정리 → main + dev

핵심

• AI Agent: Plan-Execute-Reflect 루프 + 11개 Tool Registry, 48개 도메인 스킬(12 Tier1 + 36 Tier2), 5종 AI provider(Copilot/Claude/Gemini/Groq/OpenAI)

---

Docker Images

docker pull ghcr.io/jaylenai/notion_forge-backend:latest
docker pull ghcr.io/jaylenai/notion_forge-frontend:latest

Quick Start

git clone https://github.com/JaylenAI/Notion_Forge
cd notionforge
cp .env.example .env
docker compose up -d