chore: align codebase with project rules and quality standards

- Add Dockerfile and .dockerignore with build optimization
- Integrate Stryker Mutator for mutation testing
- Update lint script to use uvx prek run
- Enhance tests with boundary cases and parallel execution
- Remove informational logs to follow logging policy

Author: wintrover

.dockerignore

@@ -0,0 +1,14 @@
+node_modules
+dist
+.env
+.git
+.github
+*.md
+LICENSE
+.pre-commit-config.yaml
+biome.json
+knip.json
+tsconfig.json
+vite.config.ts
+tests
+scripts

Dockerfile

@@ -0,0 +1,31 @@
+# Stage 1: Build
+FROM node:20-slim AS builder
+
+WORKDIR /app
+
+# 의존성 정의 파일 먼저 복사 (레이어 캐싱 최적화)
+COPY package.json package-lock.json ./
+
+# 의존성 설치
+RUN npm ci
+
+# 소스 코드 복사 (규칙에 따라 가장 상위 레이어/나중에 위치)
+COPY . .
+
+# 빌드 실행
+RUN npm run build
+
+# Stage 2: Production
+FROM node:20-slim AS runner
+
+WORKDIR /app
+
+# 빌드 결과물 및 실행에 필요한 파일만 복사
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/package.json ./package.json
+COPY --from=builder /app/node_modules ./node_modules
+
+# Vite preview 등을 사용하여 실행 (또는 별도의 웹 서버 설정 가능)
+EXPOSE 4173
+
+CMD ["npm", "run", "preview", "--", "--host"]

knip.json

@@ -21,7 +21,7 @@
 		"@rollup/plugin-dsv",
 		"vite-plugin-raw",
 		"@biomejs/biome",
-		"pre-commit"
+		"@j178/prek"
 	],
-	"ignoreBinaries": ["code-index-mcp"]
+	"ignoreBinaries": ["code-index-mcp", "stryker", "uvx"]
 }

package.json

@@ -13,7 +13,8 @@
 		"post:devto": "tsx scripts/post-to-dev.ts",
 		"mcp:code-index": "code-index-mcp",
 		"typecheck": "tsc --noEmit",
-		"lint": "prek run --all-files",
+		"lint": "uvx prek run --all-files",
+		"stryker": "stryker run",
 		"knip": "knip",
 		"depcruise": "depcruise src"
 	},

scripts/post-to-dev.ts

@@ -145,9 +145,7 @@ export async function absolutizeImagesInMarkdown(
 		const [fullMatch, pre, src, post] = match;
 		let abs = src;
 		if (isUCloudUrl(src)) {
-			console.log(`🔄 Processing UCloud image: ${src.substring(0, 80)}...`);
 			abs = await downloadAndHostUCloudImage(src, publicBaseUrl);
-			console.log(`✅ Converted to: ${abs}`);
 		} else {
 			abs = absolutizeSrc(src, publicBaseUrl);
 		}
@@ -162,9 +160,7 @@ export async function absolutizeImagesInMarkdown(
 		const [fullMatch, alt, _urlPart, urlOnly, rest] = match;
 		let abs = urlOnly;
 		if (isUCloudUrl(urlOnly)) {
-			console.log(`🔄 Processing UCloud image: ${urlOnly.substring(0, 80)}...`);
 			abs = await downloadAndHostUCloudImage(urlOnly, publicBaseUrl);
-			console.log(`✅ Converted to: ${abs}`);
 		} else {
 			abs = absolutizeSrc(urlOnly, publicBaseUrl);
 		}

stryker.config.json

@@ -0,0 +1,17 @@
+{
+	"$schema": "https://stryker-mutator.io/schema/stryker-schema.json",
+	"packageManager": "npm",
+	"reporters": ["html", "clear-text", "progress"],
+	"testRunner": "vitest",
+	"vitest": {
+		"configFile": "vite.config.ts"
+	},
+	"checkers": ["typescript"],
+	"tsconfigFile": "tsconfig.json",
+	"mutate": ["src/lib/**/*.ts"],
+	"thresholds": {
+		"high": 80,
+		"low": 60,
+		"break": 50
+	}
+}

tests/devto-absolutize.test.ts

@@ -44,6 +44,4 @@ export async function runDevtoAbsolutizeTests() {
 			"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg==";
 		assert.equal(absolutizeSrc(dataUri, base), dataUri);
 	}
-
-	console.log("OK: devto absolutize tests passed");
 }

tests/run-tests.ts

@@ -37,17 +37,58 @@ async function testImageNormalization() {
 	for (const c of cases) {
 		const { html } = parseMarkdown(c.md);
 		const srcs = extractImgSrcs(html);
-		assert.equal(srcs.length, 1, "one img expected");
-		assert.equal(srcs[0], c.expect, `normalized src should be ${c.expect}`);
+		assert.equal(srcs.length, 1, `one img expected for ${c.md}`);
+		assert.equal(
+			srcs[0],
+			c.expect,
+			`normalized src should be ${c.expect} for ${c.md}`,
+		);
+	}
+}
+
+async function testBoundaryCases() {
+	const cases = [
+		{ md: "", expectCount: 0 },
+		{ md: "![no-image]()", expectCount: 1, expectSrc: "" },
+		{
+			md: "![special](assets/images/01/../02/test.png)",
+			expect: "/blog/images/02-test.png",
+		},
+		{
+			md: "![abs](/blog/images/already.png)",
+			expect: "/blog/images/already.png",
+		},
+	];
+
+	for (const c of cases) {
+		const { html } = parseMarkdown(c.md);
+		const srcs = extractImgSrcs(html);
+		if (c.expectCount !== undefined) {
+			assert.equal(
+				srcs.length,
+				c.expectCount,
+				`expected ${c.expectCount} images for ${c.md}`,
+			);
+		}
+		if (c.expectSrc !== undefined && srcs.length > 0) {
+			assert.equal(srcs[0], c.expectSrc);
+		}
+		if (c.expect !== undefined && srcs.length > 0) {
+			assert.equal(srcs[0], c.expect);
+		}
 	}
 }
 
 (async () => {
 	try {
-		await testImageNormalization();
-		await runDevtoAbsolutizeTests();
-		console.log("OK: image path normalization tests passed");
+		// 병렬 테스트 실행 (규칙 준수)
+		await Promise.all([
+			testImageNormalization(),
+			testBoundaryCases(),
+			runDevtoAbsolutizeTests(),
+		]);
 	} catch (err) {
+		// 오류 발생 시에만 로깅 (규칙 준수)
 		console.error("TEST FAILURE:", err);
 		process.exit(1);
 	}