@sayren/mcp 0.11.0 → 0.12.0

package/dist/index.mjs

@@ -283,7 +283,7 @@ function describeWriteResult(result) {
 
 //#endregion
 //#region package.json
-var version = "0.11.0";
+var version = "0.12.0";
 
 //#endregion
 //#region src/user-agent.ts
@@ -364,7 +364,7 @@ var AdminApi = class {
 			headers,
 			body: input.body === void 0 ? void 0 : JSON.stringify(input.body),
 			redirect: "error",
-			signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+			signal: AbortSignal.timeout(input.timeoutMs ?? REQUEST_TIMEOUT_MS)
 		});
 		if (response.status === 204) return {
 			ok: true,
@@ -930,7 +930,7 @@ function verifySources(files) {
 }
 
 //#endregion
-//#region src/verify.ts
+//#region src/verify-report.ts
 const ruleOf = (ruleId) => RULES.find((rule) => rule.id === ruleId);
 function report(finding) {
 	const rule = ruleOf(finding.ruleId);
@@ -949,23 +949,34 @@ function report(finding) {
 	};
 }
 /** 위반을 고치는 순서 — 에이전트가 무엇부터 할지 묻지 않게 한다 */
-function nextSteps(findings) {
-	if (!findings.length) return [
+function nextSteps(findings, target) {
+	if (!findings.length) return target === "remote" ? [
+		"사용자에게 콘솔 스토어프론트 공간의 [미리보기 열기]로 화면을 확인해 달라고 전한다.",
+		"`create_version`으로 버전을 만들고 `get_build`로 빌드 결과를 확인한다.",
+		"정적 검사가 잡지 못하는 것은 실제 결제 한 번이 잡는다. 발행 전에 테스트 결제를 권한다."
+	] : [
 		"개발 서버를 띄워 홈에 상품이 보이는지 확인한다.",
 		"테스트 결제로 주문을 한 번 만들어 주문 완료 화면까지 간다.",
 		"정적 검사가 잡지 못하는 것은 실제 결제 한 번이 잡는다."
 	];
 	const files = [...new Set(findings.map((finding) => finding.templateFile).filter(Boolean))];
+	const templateHint = target === "remote" ? `손대지 않아야 하는 파일을 고친 결과일 수 있다 — ${files.join(", ")}을(를) \`read_file\`로 읽어 규칙의 \`example\`과 대조하고 되돌린다.` : `손대지 않아야 하는 파일을 고친 결과일 수 있다 — \`get_template_file\`로 ${files.join(", ")}의 원본을 받아 대조한다.`;
 	return [
 		"위반마다 `fix`대로 고친다. `file`·`line`이 고칠 자리이고 `example`이 옳은 쪽 코드다.",
-		...files.length ? [`손대지 않아야 하는 파일을 고친 결과일 수 있다 — \`get_template_file\`로 ${files.join(", ")}의 원본을 받아 대조한다.`] : [],
-		"고친 뒤 `verify_storefront`를 다시 부른다.",
+		...files.length ? [templateHint] : [],
+		target === "remote" ? "고친 뒤 `verify_site`를 다시 부른다. 위반이 남으면 버전 빌드가 규칙 단계(`VERIFY`)에서 실패한다." : "고친 뒤 `verify_storefront`를 다시 부른다.",
 		"규칙 배경이 더 필요하면 위반의 `docUrl` 문서를 읽는다."
 	];
 }
 /** 소스를 규칙과 대조해 고칠 수 있는 보고서로 만든다 */
-function buildReport(files) {
-	const findings = verifySources(files);
+function buildReport(files, target = "local") {
+	return reportFromFindings(verifySources(files), files.length, target);
+}
+/**
+* 이미 찾은 위반으로 보고서를 만든다. 원격은 api가 작업 트리에서 `verifySources`를 돌려 위반만 돌려주고, 원인·수정
+* 방법·예시는 이 패키지의 규칙 정의로 채운다.
+*/
+function reportFromFindings(findings, checkedFiles, target = "local") {
 	const counts = /* @__PURE__ */ new Map();
 	for (const finding of findings) counts.set(finding.ruleId, (counts.get(finding.ruleId) ?? 0) + 1);
 	const results = RULES.map((rule) => ({
@@ -977,7 +988,7 @@ function buildReport(files) {
 	const reported = findings.map(report);
 	return {
 		ok: findings.length === 0,
-		checkedFiles: files.length,
+		checkedFiles,
 		summary: {
 			rules: RULES.length,
 			passed: RULES.length - violated,
@@ -987,9 +998,12 @@ function buildReport(files) {
 		results,
 		findings: reported,
 		message: findings.length ? `규칙 ${RULES.length}개 중 ${violated}개를 어겼습니다(위반 ${findings.length}건). 아래 findings의 fix대로 고친 뒤 다시 검사해주십시오` : `규칙 ${RULES.length}개를 모두 지켰습니다. 정적 검사가 잡지 못하는 것이 있으니 직접 띄워 결제까지 한 번 해보십시오`,
-		nextSteps: nextSteps(reported)
+		nextSteps: nextSteps(reported, target)
 	};
 }
+
+//#endregion
+//#region src/verify.ts
 const SKIP = new Set([
 	"node_modules",
 	"dist",
@@ -1396,6 +1410,40 @@ const hostingTools = [
 	})
 ];
 
+//#endregion
+//#region src/tools/storefront-guide.ts
+/**
+* 스토어프론트 템플릿을 고칠 때의 안내 — 로컬 `get_scaffold_plan`과 원격 `get_editing_guide`가 같은 값을 준다.
+* 로컬 사본과 호스팅 작업 트리는 같은 템플릿에서 나오므로 확장 지점·손대지 않을 곳이 같다. Node API를 쓰지 않는다.
+*/
+/** 디자인을 바꿔도 되는 자리 */
+const EXTENSION_POINTS = [
+	{
+		what: "브랜드 색·서체·본문 폭",
+		where: "src/theme.css의 @theme"
+	},
+	{
+		what: "헤더·전역 내비",
+		where: "src/components/site-header.tsx"
+	},
+	{
+		what: "상품 카드",
+		where: "src/components/product-card.tsx"
+	},
+	{
+		what: "화면 추가",
+		where: "src/routes/ 에 파일 추가(파일 기반 라우트, routeTree.gen.ts는 dev·build가 다시 만든다)"
+	}
+];
+/** 결제·세션·분석이 조용히 깨지는 자리 — 규칙 검사가 일부를 잡지만 전부는 아니다 */
+const DO_NOT_TOUCH = [
+	"src/lib/payments.ts·src/lib/payment-options.ts·src/routes/checkout.return.tsx — 결제창 열기, 결제 복귀 결과 확인, 다른 결제수단 재시도(브라우저)",
+	"src/lib/api.server.ts — 테넌트 헤더·토큰 전달·방문 식별 쿠키",
+	"src/lib/session.server.ts·src/start.ts — 구매자 세션 쿠키와 요청마다 한 번 하는 토큰 갱신",
+	"src/lib/analytics.ts — 방문 분석 시작(브라우저 한 번)과 시작 전 이벤트 큐",
+	"라우트 loader가 서버 함수(createServerFn)로 데이터를 받는 구조"
+];
+
 //#endregion
 //#region src/tools/local-tools.ts
 const scaffoldTools = [
@@ -1423,31 +1471,8 @@ const scaffoldTools = [
 					SAYREN_API_URL: deps.config.storefrontBaseUrl,
 					SAYREN_STORE_CODE: "(get_store_context 참고)"
 				},
-				extensionPoints: [
-					{
-						what: "브랜드 색·서체·본문 폭",
-						where: "src/theme.css의 @theme"
-					},
-					{
-						what: "헤더·전역 내비",
-						where: "src/components/site-header.tsx"
-					},
-					{
-						what: "상품 카드",
-						where: "src/components/product-card.tsx"
-					},
-					{
-						what: "화면 추가",
-						where: "src/routes/ 에 파일 추가(파일 기반 라우트, routeTree.gen.ts는 dev·build가 다시 만든다)"
-					}
-				],
-				doNotTouch: [
-					"src/lib/payments.ts·src/lib/payment-options.ts·src/routes/checkout.return.tsx — 결제창 열기, 결제 복귀 결과 확인, 다른 결제수단 재시도(브라우저)",
-					"src/lib/api.server.ts — 테넌트 헤더·토큰 전달·방문 식별 쿠키",
-					"src/lib/session.server.ts·src/start.ts — 구매자 세션 쿠키와 요청마다 한 번 하는 토큰 갱신",
-					"src/lib/analytics.ts — 방문 분석 시작(브라우저 한 번)과 시작 전 이벤트 큐",
-					"라우트 loader가 서버 함수(createServerFn)로 데이터를 받는 구조"
-				],
+				extensionPoints: EXTENSION_POINTS,
+				doNotTouch: DO_NOT_TOUCH,
 				rules: RULES.map((rule) => ({
 					...rule,
 					docUrl: docUrl(rule.doc)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/mcp",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "type": "module",
   "bin": {
     "sayren-mcp": "./dist/index.mjs"
@@ -12,8 +12,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.22.0",
     "zod": "^4.6.5",
-    "@sayren/store-sdk": "^0.19.0",
-    "@sayren/storefront-sdk": "^0.15.0"
+    "@sayren/storefront-sdk": "^0.15.0",
+    "@sayren/store-sdk": "^0.19.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.14",

package/template/biome.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.5.14/schema.json",
+  "root": true,
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "includes": [
+      "**",
+      "!**/node_modules",
+      "!**/dist",
+      "!**/.output",
+      "!**/.tanstack",
+      "!**/.nitro",
+      "!**/.vinxi",
+      "!**/.wrangler",
+      "!**/routeTree.gen.ts"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "preset": "recommended"
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "semicolons": "always"
+    }
+  },
+  "css": {
+    "parser": {
+      "tailwindDirectives": true
+    }
+  }
+}