sayren 0.9.0 → 0.11.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 */
@@ -8134,6 +8038,61 @@ const cli_retired_token = ((inputs = {}, options = {}) => {
 	return ko_cli_retired_token(inputs);
 });
 
+//#endregion
+//#region src/paraglide/messages/cli_skills_install_failed.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ command: NonNullable<unknown>, detail: NonNullable<unknown> }} Cli_Skills_Install_FailedInputs */
+const ko_cli_skills_install_failed = (i) => {
+	return `에이전트 스킬을 설치하지 못했습니다. 받은 폴더에서 직접 실행하십시오: ${i?.command}
+${i?.detail}`;
+};
+/**
+
+* @param {Cli_Skills_Install_FailedInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_skills_install_failed = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_skills_install_failed(inputs);
+});
+
+//#endregion
+//#region src/paraglide/messages/cli_skills_installed.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Skills_InstalledInputs */
+const ko_cli_skills_installed = () => {
+	return `에이전트 스킬 설치 완료 — .claude/skills/ (배포 때 올리지 않습니다)`;
+};
+/**
+
+* @param {Cli_Skills_InstalledInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_skills_installed = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_skills_installed(inputs);
+});
+
+//#endregion
+//#region src/paraglide/messages/cli_skills_installing.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ source: NonNullable<unknown> }} Cli_Skills_InstallingInputs */
+const ko_cli_skills_installing = (i) => {
+	return `에이전트 스킬 설치 중 — ${i?.source}`;
+};
+/**
+
+* @param {Cli_Skills_InstallingInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_skills_installing = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_skills_installing(inputs);
+});
+
 //#endregion
 //#region src/paraglide/messages/cli_skipped_outside.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -9784,7 +9743,7 @@ async function selectStore(auth, client, io, candidates, folderStore = null) {
 
 //#endregion
 //#region package.json
-var version = "0.9.0";
+var version = "0.11.0";
 
 //#endregion
 //#region src/client.ts
@@ -10870,21 +10829,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 +11078,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 +11425,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 +11449,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 +11479,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
@@ -11625,6 +11586,116 @@ async function gunzip(bytes, maxBytes) {
 	return out;
 }
 
+//#endregion
+//#region src/local-build.ts
+/** 실패할 때 보여 주는 빌드 출력 줄 수 */
+const OUTPUT_TAIL_LINES = 40;
+/** 모아 두는 출력 상한(문자) — 긴 빌드 로그를 다 쥐고 있지 않는다 */
+const OUTPUT_KEEP_CHARS$1 = 64 * 1024;
+/** 빌드를 돌릴 수 있는 폴더인가 — `build` 스크립트와 설치된 의존성(`node_modules`)이 있어야 한다 */
+function planLocalBuild(dir) {
+	let scripts;
+	try {
+		scripts = JSON.parse(readFileSync(join(dir, "package.json"), "utf8")).scripts;
+	} catch {
+		return { kind: "no-script" };
+	}
+	const build = scripts && typeof scripts === "object" ? scripts.build : void 0;
+	if (typeof build !== "string" || !build.trim()) return { kind: "no-script" };
+	if (!existsSync(join(dir, "node_modules"))) return { kind: "no-deps" };
+	return { kind: "run" };
+}
+/** `npm run build`를 돌린다. 출력은 모아 두고(실패할 때 꼬리를 보여 준다) 화면에 흘리지 않는다 */
+function runNpmBuild(dir, env) {
+	return new Promise((resolve$1, reject) => {
+		let output = "";
+		const keep = (chunk) => {
+			output = (output + chunk.toString("utf8")).slice(-OUTPUT_KEEP_CHARS$1);
+		};
+		const child = spawn("npm", ["run", "build"], {
+			cwd: dir,
+			env,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
+			shell: process.platform === "win32"
+		});
+		child.stdout?.on("data", keep);
+		child.stderr?.on("data", keep);
+		child.once("error", reject);
+		child.once("close", (code) => resolve$1({
+			code,
+			output: tailOf(output)
+		}));
+	});
+}
+function tailOf(output, lines = OUTPUT_TAIL_LINES) {
+	return output.trimEnd().split(/\r?\n/).slice(-lines).join("\n");
+}
+
+//#endregion
+//#region src/skills-install.ts
+/**
+* sayren 중앙 스킬 설치(2026-10-16 사용자 결정) — `pull`·`init`이 받은 폴더에서 `npx skills add https://sayren.io`를 돌려
+* `.claude/skills/{name}/`에 스킬을 넣는다. 설치는 실패해도 받기를 실패시키지 않는다(명령을 알려 준다).
+* 설치된 스킬은 로컬 설치물이라 올리지 않는다(`installedSkillNames` → `collectTree`).
+*/
+const SKILLS_SOURCE = "https://sayren.io";
+/** 확인한 skills CLI 버전 — 디스커버리 0.2.0 색인을 읽는다 */
+const SKILLS_CLI = "skills@1.7.2";
+const SKILLS_ARGS = [
+	"-y",
+	SKILLS_CLI,
+	"add",
+	SKILLS_SOURCE,
+	"--agent",
+	"claude-code",
+	"-y"
+];
+const SKILLS_COMMAND = `npx ${SKILLS_CLI} add ${SKILLS_SOURCE} --agent claude-code`;
+/** skills CLI가 설치한 스킬을 적는 파일 */
+const SKILLS_LOCK_FILE = "skills-lock.json";
+const OUTPUT_KEEP_CHARS = 64 * 1024;
+/** `npx skills add`를 돌린다. 출력은 모아 두고(실패할 때 꼬리를 보여 준다) 화면에 흘리지 않는다 */
+function runSkillsInstall(dir, env) {
+	return new Promise((resolve$1, reject) => {
+		let output = "";
+		const keep = (chunk) => {
+			output = (output + chunk.toString("utf8")).slice(-OUTPUT_KEEP_CHARS);
+		};
+		const child = spawn("npx", SKILLS_ARGS, {
+			cwd: dir,
+			env,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
+			shell: process.platform === "win32"
+		});
+		child.stdout?.on("data", keep);
+		child.stderr?.on("data", keep);
+		child.once("error", reject);
+		child.once("close", (code) => resolve$1({
+			code,
+			output: tailOf(output, OUTPUT_TAIL_LINES)
+		}));
+	});
+}
+/** skills CLI로 설치한 스킬 이름(`skills-lock.json`) — 없거나 읽지 못하면 빈 집합 */
+function installedSkillNames(root) {
+	const path = join(root, SKILLS_LOCK_FILE);
+	if (!existsSync(path)) return /* @__PURE__ */ new Set();
+	try {
+		const skills = JSON.parse(readFileSync(path, "utf8")).skills;
+		return new Set(skills && typeof skills === "object" ? Object.keys(skills) : []);
+	} catch {
+		return /* @__PURE__ */ new Set();
+	}
+}
+
 //#endregion
 //#region src/tree.ts
 /**
@@ -11658,6 +11729,11 @@ const sha256Hex = (bytes) => createHash("sha256").update(bytes).digest("hex");
 function collectTree(root) {
 	const files = [];
 	const skipped = [];
+	const installedSkills = installedSkillNames(root);
+	const isInstalledSkill = (rel) => {
+		const [first, second, name] = rel.split("/");
+		return first === ".claude" && second === "skills" && name !== void 0 && installedSkills.has(name);
+	};
 	const walk = (dir) => {
 		for (const entry of readdirSync(dir, { withFileTypes: true })) {
 			const full = join(dir, entry.name);
@@ -11671,7 +11747,7 @@ function collectTree(root) {
 				skipped.push(rel);
 				continue;
 			}
-			if (isNeverUpload(rel) || accessOf(rel) === null) {
+			if (isNeverUpload(rel) || accessOf(rel) === null || isInstalledSkill(rel)) {
 				skipped.push(rel);
 				continue;
 			}
@@ -11871,52 +11947,21 @@ function lockImporterSpecifiers(lock) {
 }
 
 //#endregion
-//#region src/local-build.ts
-/** 실패할 때 보여 주는 빌드 출력 줄 수 */
-const OUTPUT_TAIL_LINES = 40;
-/** 모아 두는 출력 상한(문자) — 긴 빌드 로그를 다 쥐고 있지 않는다 */
-const OUTPUT_KEEP_CHARS = 64 * 1024;
-/** 빌드를 돌릴 수 있는 폴더인가 — `build` 스크립트와 설치된 의존성(`node_modules`)이 있어야 한다 */
-function planLocalBuild(dir) {
-	let scripts;
-	try {
-		scripts = JSON.parse(readFileSync(join(dir, "package.json"), "utf8")).scripts;
-	} catch {
-		return { kind: "no-script" };
-	}
-	const build = scripts && typeof scripts === "object" ? scripts.build : void 0;
-	if (typeof build !== "string" || !build.trim()) return { kind: "no-script" };
-	if (!existsSync(join(dir, "node_modules"))) return { kind: "no-deps" };
-	return { kind: "run" };
-}
-/** `npm run build`를 돌린다. 출력은 모아 두고(실패할 때 꼬리를 보여 준다) 화면에 흘리지 않는다 */
-function runNpmBuild(dir, env) {
-	return new Promise((resolve$1, reject) => {
-		let output = "";
-		const keep = (chunk) => {
-			output = (output + chunk.toString("utf8")).slice(-OUTPUT_KEEP_CHARS);
-		};
-		const child = spawn("npm", ["run", "build"], {
-			cwd: dir,
-			env,
-			stdio: [
-				"ignore",
-				"pipe",
-				"pipe"
-			],
-			shell: process.platform === "win32"
-		});
-		child.stdout?.on("data", keep);
-		child.stderr?.on("data", keep);
-		child.once("error", reject);
-		child.once("close", (code) => resolve$1({
-			code,
-			output: tailOf(output)
-		}));
-	});
-}
-function tailOf(output, lines = OUTPUT_TAIL_LINES) {
-	return output.trimEnd().split(/\r?\n/).slice(-lines).join("\n");
+//#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
@@ -11978,7 +12023,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 +12084,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);
@@ -12106,10 +12152,33 @@ async function receiveSource(client, auth, source, flags, io, migratedDir) {
 		file: STATE_FILE,
 		siteId: source.siteId
 	}));
+	await installSkills(target, io);
 	if (source.editSessionOpen) io.out(cli_pull_edit_session_open());
 	io.out(cli_pull_next_steps({ dir: pulledDir }));
 	return 0;
 }
+/** sayren 중앙 스킬을 받은 폴더에 설치한다 — 실패해도 받기는 성공이다(직접 돌릴 명령을 알린다) */
+async function installSkills(dir, io) {
+	io.out(cli_skills_installing({ source: SKILLS_SOURCE }));
+	let result;
+	try {
+		result = await (io.installSkills ?? ((at) => runSkillsInstall(at, io.env)))(dir);
+	} catch (error) {
+		io.err(cli_skills_install_failed({
+			command: SKILLS_COMMAND,
+			detail: error instanceof Error ? error.message : String(error)
+		}));
+		return;
+	}
+	if (result.code === 0) {
+		io.out(cli_skills_installed());
+		return;
+	}
+	io.err(cli_skills_install_failed({
+		command: SKILLS_COMMAND,
+		detail: result.output || `exit ${result.code}`
+	}));
+}
 /**
 * `sayren init [폴더]`(#101) — 템플릿을 골라 호스팅 사이트를 만들고(`POST /v1/storefront/site`) `pull`과 같은 폴더를 만든다.
 * 사이트가 이미 있으면 만들지 않고 `pull`을 안내한다(상점당 열린 사이트는 하나다). 만들기는 상점 한도(30일 3회)를 쓰므로 확인을 묻는다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sayren",
-  "version": "0.9.0",
+  "version": "0.11.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"