fix(content): 감사 정책 기준 공유

Node 기반 content audit이 앱 정책과 같은 JSON 기준을 사용하도록 변경했습니다.

공개 Tech와 featured 검증·요약의 기준 불일치를 방지했습니다.

Author: dev-wooyeon

blog/services/policy.json

@@ -0,0 +1,11 @@
+{
+  "publicTech": {
+    "coreReviewFields": ["philosophy", "design", "implementation"],
+    "minimumCoreReviewAverageExclusive": 3
+  },
+  "featured": {
+    "category": "Tech",
+    "minimumBrandFit": 4,
+    "requiresNoSeries": true
+  }
+}

blog/services/policy.ts

@@ -1,20 +1,10 @@
 import type { FeedData, QualityReview } from '@/blog/model/types';
+import policyData from './policy.json';
 
-export const PUBLICATION_POLICY = {
-  publicTech: {
-    minimumCoreReviewAverageExclusive: 3,
-  },
-  featured: {
-    category: 'Tech',
-    minimumBrandFit: 4,
-  },
-} as const;
+export const PUBLICATION_POLICY = policyData;
 
-const CORE_TECH_REVIEW_FIELDS = [
-  'philosophy',
-  'design',
-  'implementation',
-] as const;
+const CORE_TECH_REVIEW_FIELDS = PUBLICATION_POLICY.publicTech
+  .coreReviewFields as ReadonlyArray<keyof QualityReview>;
 
 export interface PublicationQueryOptions {
   includePrivate?: boolean;
@@ -69,7 +59,7 @@ export function isEligibleForFeaturedPost(
 
   return (
     post.category === PUBLICATION_POLICY.featured.category &&
-    !post.series &&
+    (!PUBLICATION_POLICY.featured.requiresNoSeries || !post.series) &&
     typeof brandFit === 'number' &&
     brandFit >= PUBLICATION_POLICY.featured.minimumBrandFit
   );

docs/README.md

@@ -47,6 +47,7 @@ Last updated: 2026-07-22
 - `docs/adr/0046-use-main-as-the-primary-branch.md`
 - `docs/adr/0047-isolate-publication-policy.md`
 - `docs/adr/0048-centralize-blog-publication-rules.md`
+- `docs/adr/0049-share-publication-policy-data-with-audit.md`
 - `docs/blog-quality-guide.md`
 - `docs/content-publication-candidates.md`
 - `docs/database/db-schema.md`

docs/adr/0049-share-publication-policy-data-with-audit.md

@@ -0,0 +1,37 @@
+# 0049. 발행 정책 데이터를 content audit과 공유한다
+
+Date: 2026-07-22
+Status: Accepted
+
+## 배경
+
+`blog/services/policy.ts`는 앱과 테스트의 발행 기준을 소유하지만,
+`content:audit`은 Node가 직접 실행하는 `.mjs` 스크립트다. 이 스크립트에 core
+점수 하한과 featured 기준을 다시 쓰면 정책 변경 후 release check와 앱 검증이
+서로 다른 결과를 낼 수 있다.
+
+## 결정
+
+- `blog/services/policy.json`을 Node와 TypeScript가 함께 읽는 발행 정책 데이터의
+  원본으로 둔다.
+- `policy.ts`는 JSON을 import하고 visibility, 점수, featured 자격 helper를
+  제공한다.
+- `content:audit`은 같은 JSON을 import해 core 평가 항목, 점수 하한, featured
+  자격과 요약을 계산한다.
+
+## 결과
+
+- 정책 기준을 바꾸면 앱, policy test, content audit이 같은 값을 사용한다.
+- Node audit에 TypeScript runtime loader를 추가하지 않는다.
+- 글별 featured 선택은 계속 `meta.json`의 책임이다.
+
+## 검토한 대안
+
+- audit에 숫자를 유지: 정책 변경 시 기준 불일치가 다시 생긴다.
+- audit에서 `policy.ts`를 직접 import: plain Node 실행에 TypeScript loader가
+  필요하다.
+- JSON 대신 별도 build 산출물 생성: 현재 한 정책 파일에는 불필요한 build 단계다.
+
+## Related History
+
+- `0f3d806`: 발행 정책을 `policy.ts`로 중앙화

docs/adr/README.md

@@ -66,6 +66,7 @@ ADR은 AI 협업 가이드와 별개의 문서다. 사람이 결정했든 AI가
 | [0046](0046-use-main-as-the-primary-branch.md)                                       | Accepted   | 저장소의 주 브랜치를 main으로 통일한다                       |
 | [0047](0047-isolate-publication-policy.md)                                           | Accepted   | 공개 정책을 blog 도메인 모듈로 분리한다                      |
 | [0048](0048-centralize-blog-publication-rules.md)                                    | Accepted   | 블로그 발행 규칙을 단일 policy 모듈로 확장한다               |
+| [0049](0049-share-publication-policy-data-with-audit.md)                             | Accepted   | 발행 정책 데이터를 content audit과 공유한다                  |
 
 ## 작성 조건
 

tooling/scripts/posts/audit-post-quality.mjs

@@ -1,13 +1,14 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import process from 'node:process';
+import publicationPolicy from '../../../blog/services/policy.json' with { type: 'json' };
 
 const configuredPostsDirectory = process.env.BLOG_AUDIT_POSTS_DIR ?? 'posts';
 const postsDirectory = path.isAbsolute(configuredPostsDirectory)
   ? configuredPostsDirectory
   : path.join(process.cwd(), configuredPostsDirectory);
 const CONTENT_TYPES = ['essay', 'retrospective', 'review'];
-const CORE_REVIEW_KEYS = ['philosophy', 'design', 'implementation'];
+const CORE_REVIEW_KEYS = publicationPolicy.publicTech.coreReviewFields;
 const WRITING_REVIEW_KEYS = [
   'clarity',
   'structure',
@@ -292,6 +293,8 @@ function reviewPostQuality(meta, content) {
 function evaluatePolicy(meta) {
   const visibility = meta.visibility ?? 'private';
   const coreAverage = readCoreAverage(meta.qualityReview);
+  const publicTechPolicy = publicationPolicy.publicTech;
+  const featuredPolicy = publicationPolicy.featured;
   const warnings = [];
 
   if (visibility === 'public' && meta.series) {
@@ -301,16 +304,33 @@ function evaluatePolicy(meta) {
   if (visibility === 'public' && meta.category === 'Tech') {
     if (coreAverage === null) {
       warnings.push('public Tech core 점수 누락');
-    } else if (coreAverage <= 3) {
-      warnings.push(`public Tech core 평균 ${coreAverage.toFixed(2)} <= 3.0`);
+    } else if (
+      coreAverage <= publicTechPolicy.minimumCoreReviewAverageExclusive
+    ) {
+      warnings.push(
+        `public Tech core 평균 ${coreAverage.toFixed(2)} <= ${publicTechPolicy.minimumCoreReviewAverageExclusive.toFixed(1)}`
+      );
     }
   }
 
   if (meta.featured) {
     const brandFit = meta.qualityReview?.brandFit;
 
-    if (typeof brandFit !== 'number' || brandFit < 4) {
-      warnings.push('featured brandFit < 4.0');
+    if (meta.category !== featuredPolicy.category) {
+      warnings.push(`featured category must be ${featuredPolicy.category}`);
+    }
+
+    if (featuredPolicy.requiresNoSeries && meta.series) {
+      warnings.push('featured series 글');
+    }
+
+    if (
+      typeof brandFit !== 'number' ||
+      brandFit < featuredPolicy.minimumBrandFit
+    ) {
+      warnings.push(
+        `featured brandFit < ${featuredPolicy.minimumBrandFit.toFixed(1)}`
+      );
     }
   }
 
@@ -602,20 +622,27 @@ function printReport(posts, errors) {
 
   console.log('## Policy Checks');
   console.log(
-    `- public Tech core average > 3.0: ${
+    `- public Tech core average > ${publicationPolicy.publicTech.minimumCoreReviewAverageExclusive.toFixed(1)}: ${
       publicTechPosts.every(
         (post) =>
-          post.policy.coreAverage !== null && post.policy.coreAverage > 3
+          post.policy.coreAverage !== null &&
+          post.policy.coreAverage >
+            publicationPolicy.publicTech.minimumCoreReviewAverageExclusive
       )
         ? 'ok'
         : 'review'
     }`
   );
   console.log(
-    `- featured brandFit >= 4.0: ${
+    `- featured eligibility: ${
       featuredPosts.every((post) => {
         const brandFit = post.qualityReview?.brandFit;
-        return typeof brandFit === 'number' && brandFit >= 4;
+        return (
+          post.category === publicationPolicy.featured.category &&
+          (!publicationPolicy.featured.requiresNoSeries || !post.series) &&
+          typeof brandFit === 'number' &&
+          brandFit >= publicationPolicy.featured.minimumBrandFit
+        );
       })
         ? 'ok'
         : 'review'

tooling/scripts/posts/audit-post-quality.test.ts

@@ -3,6 +3,7 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { PUBLICATION_POLICY } from '@/blog/services/policy';
 
 let tempRoot: string;
 let postsDir: string;
@@ -160,4 +161,41 @@ describe('post quality audit script', () => {
       '[private 유지] missing-visibility (private, Life)'
     );
   });
+
+  it('uses the shared publication thresholds for warnings and summaries', () => {
+    const coreThreshold =
+      PUBLICATION_POLICY.publicTech.minimumCoreReviewAverageExclusive;
+    const featuredThreshold = PUBLICATION_POLICY.featured.minimumBrandFit;
+
+    writePostFixture('thresholds', {
+      title: '공용 공개 기준을 검증하는 글',
+      slug: 'thresholds',
+      description: '설명',
+      date: '2026-07-22',
+      category: PUBLICATION_POLICY.featured.category,
+      contentType: 'retrospective',
+      visibility: 'public',
+      featured: true,
+      tags: ['Policy'],
+      qualityReview: {
+        philosophy: coreThreshold,
+        design: coreThreshold,
+        implementation: coreThreshold,
+        brandFit: featuredThreshold - 0.5,
+      },
+    });
+
+    const output = runAudit();
+
+    expect(output).toContain(
+      `public Tech core 평균 ${coreThreshold.toFixed(2)} <= ${coreThreshold.toFixed(1)}`
+    );
+    expect(output).toContain(
+      `featured brandFit < ${featuredThreshold.toFixed(1)}`
+    );
+    expect(output).toContain(
+      `public Tech core average > ${coreThreshold.toFixed(1)}: review`
+    );
+    expect(output).toContain('- featured eligibility: review');
+  });
 });