sayren 0.9.0 → 0.10.0

package/dist/index.mjs

@@ -2261,84 +2261,6 @@ const mcp_rule_payment_browser_launch_why = ((inputs = {}, options = {}) => {
 	return ko_mcp_rule_payment_browser_launch_why(inputs);
 });
 
-//#endregion
-//#region ../mcp/src/paraglide/messages/mcp_rule_payment_popup_prepare_example.js
-/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
-/** @typedef {{}} Mcp_Rule_Payment_Popup_Prepare_ExampleInputs */
-const ko_mcp_rule_payment_popup_prepare_example = () => {
-	return `const paymentWindow = payments.prepareWindow(); // 클릭 시점에 먼저 연다
-const { start, error } = await startPayment({ data });
-if (!start) {
-  paymentWindow.close();
-  return;
-}
-await payments.open(parsed, { window: paymentWindow });`;
-};
-/**
-
-* @param {Mcp_Rule_Payment_Popup_Prepare_ExampleInputs} inputs
-* @param {{ locale?: "ko" }} options
-* @returns {LocalizedString}
-*/
-const mcp_rule_payment_popup_prepare_example = ((inputs = {}, options = {}) => {
-	experimentalStaticLocale$1 ?? options.locale ?? getLocale$1();
-	return ko_mcp_rule_payment_popup_prepare_example(inputs);
-});
-
-//#endregion
-//#region ../mcp/src/paraglide/messages/mcp_rule_payment_popup_prepare_fix.js
-/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
-/** @typedef {{}} Mcp_Rule_Payment_Popup_Prepare_FixInputs */
-const ko_mcp_rule_payment_popup_prepare_fix = () => {
-	return `클릭 핸들러 첫 줄에서 \`payments.prepareWindow()\`로 빈 창을 열고, 서버 함수가 끝나면 그 핸들을 \`payments.open(start, { window })\`에 넘긴다. 결제 시작이 실패하면 \`window.close()\`로 닫는다`;
-};
-/**
-
-* @param {Mcp_Rule_Payment_Popup_Prepare_FixInputs} inputs
-* @param {{ locale?: "ko" }} options
-* @returns {LocalizedString}
-*/
-const mcp_rule_payment_popup_prepare_fix = ((inputs = {}, options = {}) => {
-	experimentalStaticLocale$1 ?? options.locale ?? getLocale$1();
-	return ko_mcp_rule_payment_popup_prepare_fix(inputs);
-});
-
-//#endregion
-//#region ../mcp/src/paraglide/messages/mcp_rule_payment_popup_prepare_title.js
-/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
-/** @typedef {{}} Mcp_Rule_Payment_Popup_Prepare_TitleInputs */
-const ko_mcp_rule_payment_popup_prepare_title = () => {
-	return `결제 시작이 서버 함수를 거치면 클릭 시점에 \`payments.prepareWindow()\`로 창을 먼저 연다`;
-};
-/**
-
-* @param {Mcp_Rule_Payment_Popup_Prepare_TitleInputs} inputs
-* @param {{ locale?: "ko" }} options
-* @returns {LocalizedString}
-*/
-const mcp_rule_payment_popup_prepare_title = ((inputs = {}, options = {}) => {
-	experimentalStaticLocale$1 ?? options.locale ?? getLocale$1();
-	return ko_mcp_rule_payment_popup_prepare_title(inputs);
-});
-
-//#endregion
-//#region ../mcp/src/paraglide/messages/mcp_rule_payment_popup_prepare_why.js
-/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
-/** @typedef {{}} Mcp_Rule_Payment_Popup_Prepare_WhyInputs */
-const ko_mcp_rule_payment_popup_prepare_why = () => {
-	return `팝업은 사용자 클릭에서 동기로 열어야 차단되지 않는다. 서버 응답을 기다린 뒤 열면 브라우저가 막아 결제가 시작되지 않는다`;
-};
-/**
-
-* @param {Mcp_Rule_Payment_Popup_Prepare_WhyInputs} inputs
-* @param {{ locale?: "ko" }} options
-* @returns {LocalizedString}
-*/
-const mcp_rule_payment_popup_prepare_why = ((inputs = {}, options = {}) => {
-	experimentalStaticLocale$1 ?? options.locale ?? getLocale$1();
-	return ko_mcp_rule_payment_popup_prepare_why(inputs);
-});
-
 //#endregion
 //#region ../mcp/src/paraglide/messages/mcp_rule_payment_processing_status_example.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -3297,24 +3219,6 @@ const mcp_verify_payment_browser_launch_server_file = ((inputs = {}, options = {
 	return ko_mcp_verify_payment_browser_launch_server_file(inputs);
 });
 
-//#endregion
-//#region ../mcp/src/paraglide/messages/mcp_verify_payment_popup_prepare.js
-/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
-/** @typedef {{}} Mcp_Verify_Payment_Popup_PrepareInputs */
-const ko_mcp_verify_payment_popup_prepare = () => {
-	return `받아 둔 결제 시작 값으로 결제창을 열지만 클릭 시점에 \`payments.prepareWindow()\`로 창을 먼저 여는 코드가 없다`;
-};
-/**
-
-* @param {Mcp_Verify_Payment_Popup_PrepareInputs} inputs
-* @param {{ locale?: "ko" }} options
-* @returns {LocalizedString}
-*/
-const mcp_verify_payment_popup_prepare = ((inputs = {}, options = {}) => {
-	experimentalStaticLocale$1 ?? options.locale ?? getLocale$1();
-	return ko_mcp_verify_payment_popup_prepare(inputs);
-});
-
 //#endregion
 //#region ../mcp/src/paraglide/messages/mcp_verify_payment_processing_status.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -9784,7 +9688,7 @@ async function selectStore(auth, client, io, candidates, folderStore = null) {
 
 //#endregion
 //#region package.json
-var version = "0.9.0";
+var version = "0.10.0";
 
 //#endregion
 //#region src/client.ts
@@ -10870,21 +10774,12 @@ const RULES = [
 		doc: "/guides/checkout-flow",
 		templateFile: "src/lib/payments.ts"
 	}),
-	defineRule({
-		id: "payment-popup-prepare",
-		title: mcp_rule_payment_popup_prepare_title,
-		why: mcp_rule_payment_popup_prepare_why,
-		fix: mcp_rule_payment_popup_prepare_fix,
-		example: mcp_rule_payment_popup_prepare_example,
-		doc: "/guides/checkout-flow",
-		templateFile: "src/routes/checkout.index.tsx"
-	}),
 	defineRule({
 		id: "payment-return-route",
 		title: mcp_rule_payment_return_route_title,
 		why: mcp_rule_payment_return_route_why,
 		fix: mcp_rule_payment_return_route_fix,
-		example: "useEffect(() => {\n  void payments.result(window.location.href).then((result) => {\n    if (result.status === \"COMPLETED\") navigate({ to: \"/checkout/complete\", search: { orderId: result.orderId } });\n  });\n}, []);",
+		example: "useEffect(() => {\n  void payments.result().then((result) => {\n    if (result.status === \"COMPLETED\") navigate({ to: \"/checkout/complete\", search: { orderId: result.orderId } });\n  });\n}, []);",
 		doc: "/guides/checkout-flow",
 		templateFile: "src/routes/checkout.return.tsx"
 	}),
@@ -11128,7 +11023,6 @@ function verifySources(files, options = {}) {
 	}
 	if (has("startPayment(") && !has("@sayren/storefront-sdk/payments")) inProject("payment-browser-launch", mcp_verify_payment_browser_launch_missing());
 	const opensPayment = matches(/\bpayments\.open\(|\.open\(\s*(start|paymentStart)\b/);
-	if (opensPayment && !has("prepareWindow(")) inFile("payment-popup-prepare", opensPayment, mcp_verify_payment_popup_prepare(), /\bpayments\.open\(|\.open\(\s*(start|paymentStart)\b/);
 	if (opensPayment && !/amounts/.test(opensPayment.content)) inFile("payment-amounts-final", opensPayment, mcp_verify_payment_amounts_final(), /\bpayments\.open\(/);
 	const fixedReturnUrl = matches(/returnUrl\s*[:=]\s*["'`]https?:\/\//);
 	if (fixedReturnUrl) inFile("checkout-origin", fixedReturnUrl, mcp_verify_checkout_origin(), /returnUrl\s*[:=]\s*["'`]https?:\/\//);
@@ -11476,8 +11370,18 @@ const WRITABLE_ROOT_FILES = new Set([
 	"biome.json",
 	".gitignore"
 ]);
-/** 읽기만 되는 루트 파일 — 의존성은 전용 경로로만 바꾼다(레지스트리 프록시와 잠금 파일을 함께 맞춘다) */
-const READONLY_ROOT_FILES = new Set(["package.json", "pnpm-lock.yaml"]);
+/**
+* 읽기만 되는 루트 파일 — 의존성은 전용 경로로만 바꾼다(레지스트리 프록시와 잠금 파일을 함께 맞춘다).
+* `CLAUDE.md`·`.mcp.json`은 템플릿이 싣는 에이전트 안내·MCP 연결 설정이다(2026-10-14, blank 템플릿) — 편집 도구는 바꾸지 않는다
+*/
+const READONLY_ROOT_FILES = new Set([
+	"package.json",
+	"pnpm-lock.yaml",
+	"CLAUDE.md",
+	".mcp.json"
+]);
+/** 읽기만 되는 폴더 — 템플릿이 싣는 Claude 스킬(`.claude/skills/…`, 2026-10-14). 셀러 로컬 Claude Code와 AI 상점 도우미가 같은 기준을 읽는다 */
+const READONLY_DIRS = new Set([".claude"]);
 /**
 * 쓸 수 있는 폴더 — 코드(`src`), 정적 파일(`public`), 화면 문구 카탈로그(`messages`, 템플릿 `src/i18n`이 `messages/ko.json`을 import한다, #73).
 * 템플릿이 import하는 파일이 이 밖에 있으면 첫 작업 트리(source.tgz)를 풀 때 빠져 빌드·검사가 깨진다(#78)
@@ -11490,6 +11394,7 @@ const WRITABLE_DIRS = new Set([
 /** 작업 트리 루트에 둘 수 있는 이름(폴더·파일) — 컨테이너 스냅샷이 이 이름만 묶는다(`container-tree.ts`) */
 const TRACKED_ROOT_NAMES = [
 	...WRITABLE_DIRS,
+	...READONLY_DIRS,
 	...WRITABLE_ROOT_FILES,
 	...READONLY_ROOT_FILES
 ];
@@ -11519,9 +11424,10 @@ function accessOf(path) {
 		if (READONLY_ROOT_FILES.has(first)) return "read";
 		return null;
 	}
-	if (!WRITABLE_DIRS.has(first)) return null;
-	if (segments.some((s) => s.startsWith("."))) return null;
-	return "write";
+	const readonlyDir = READONLY_DIRS.has(first);
+	if (!readonlyDir && !WRITABLE_DIRS.has(first)) return null;
+	if (segments.slice(1).some((s) => s.startsWith("."))) return null;
+	return readonlyDir ? "read" : "write";
 }
 
 //#endregion
@@ -11870,6 +11776,24 @@ function lockImporterSpecifiers(lock) {
 	return out;
 }
 
+//#endregion
+//#region src/guide-skill.ts
+/**
+* 받은 폴더의 에이전트 안내 스킬(2026-10-16 사용자 결정) — 셀러의 Claude Code가 sayren 중앙 스킬을 HTTP로 읽게 한다.
+* 빈 템플릿이 싣는 `templates/storefront-blank/.claude/skills/sayren/SKILL.md`와 같은 내용이다(`guide-skill.test.ts`가 고정한다).
+*/
+const GUIDE_SKILL_PATH = ".claude/skills/sayren/SKILL.md";
+const GUIDE_SKILL = "---\nname: sayren\ndescription: Use for any work on this sayren storefront — pages, product display, cart, checkout, payments, buyer login, account pages, analytics, design and code quality. Loads the current sayren skills over HTTP.\n---\n\n# sayren skills (central)\n\nThe sayren skills are maintained centrally and change without updating this project. Read them over HTTP at the start of a task instead of relying on memory.\n\n1. List the skills: `GET https://api.sayren.io/v1/public/agent-skills`\n   The response is `{ \"data\": [{ \"name\", \"description\", \"version\", \"updatedAt\" }] }`.\n2. Read the skills that match the task: `GET https://api.sayren.io/v1/public/agent-skills/{name}`\n   The response is `{ \"data\": { \"name\", \"description\", \"body\", \"version\", \"updatedAt\" } }`; `body` is the guide (markdown).\n\nStart points:\n- Any code change: `code-quality`, `sayren-storefront-rules`, `sdk-client`, `template-stack`\n- Product pages: `sayren-product-display`, `sdk-catalog`\n- Cart, checkout, payment: `sdk-cart`, `sdk-checkout`, `sdk-payments`\n- Buyer login and account pages: `sdk-buyer-auth`, `sdk-account`\n- Visual design: `design-quality`\n\nFollow the project's `CLAUDE.md` first; the skills add the sayren-specific details.\n";
+/**
+* 받은 트리에 안내 스킬이 없으면 넣는다 — 템플릿이 싣거나 셀러가 올린 내용이 우선이다. 트리에 넣으므로 다시 받을 때 지울 파일로 잡히지 않고
+* `deploy`가 원격 작업 트리에도 올린다(AI 상점 도우미가 같은 안내를 읽는다). 넣었으면 true
+*/
+function withGuideSkill(files) {
+	if (files.has(GUIDE_SKILL_PATH)) return false;
+	files.set(GUIDE_SKILL_PATH, new TextEncoder().encode(GUIDE_SKILL));
+	return true;
+}
+
 //#endregion
 //#region src/local-build.ts
 /** 실패할 때 보여 주는 빌드 출력 줄 수 */
@@ -11978,7 +11902,7 @@ async function pull(flags, io) {
 	return receiveSource(client, auth, source, flags, io, authDir);
 }
 /**
-* 받은 작업 트리를 폴더에 쓰고 받은 폴더 파일(`.sayren/state.json`·`.env`·`.mcp.json`·`.gitignore`)을 맞춘다. `pull`과 `init`(#101)이 같이 쓴다.
+* 받은 작업 트리(+ 에이전트 안내 스킬 `withGuideSkill`)를 폴더에 쓰고 받은 폴더 파일(`.sayren/state.json`·`.env`·`.mcp.json`·`.gitignore`)을 맞춘다. `pull`과 `init`(#101)이 같이 쓴다.
 * 대상은 `--dir` → 받은 폴더 안이면 그 폴더 → 상점 코드다. 비어 있지 않은 폴더는 `--force`일 때 같은 사이트를 받은 폴더만 다시 받는다.
 */
 async function receiveSource(client, auth, source, flags, io, migratedDir) {
@@ -12039,6 +11963,7 @@ async function receiveSource(client, auth, source, flags, io, migratedDir) {
 	const tgz = new Uint8Array(Buffer.concat(chunks));
 	if (sha256Hex(tgz) !== source.archive.sha256) throw new CliError(cli_pull_archive_corrupt());
 	const files = await unpackArchive(tgz);
+	withGuideSkill(files);
 	const collisions = caseCollisions(files.keys());
 	if (collisions.length > 0) throw new CliError(cli_pull_case_collisions({ groups: collisions.map((group) => group.join(" · ")).join(", ") }));
 	const diff = diffLocal(target, files);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sayren",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "type": "module",
   "imports": {
     "#paraglide/*": "./src/paraglide/*"
@@ -17,7 +17,7 @@
   },
   "dependencies": {
     "esbuild": "^0.28.2",
-    "@sayren/store-sdk": "^0.30.16"
+    "@sayren/store-sdk": "^0.33.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.14",
@@ -28,7 +28,7 @@
     "tsx": "^4.20.3",
     "typescript": "^6.0.3",
     "vitest": "^5.0.1",
-    "@sayren/mcp": "0.24.0"
+    "@sayren/mcp": "0.26.0"
   },
   "publishConfig": {
     "access": "public"