sayren 0.13.0 → 0.14.0

package/dist/index.mjs

@@ -2,11 +2,11 @@
 import { spawn, spawnSync } from "node:child_process";
 import { stdin, stdout } from "node:process";
 import { createInterface } from "node:readline/promises";
-import { APP_DEPLOY_KEY_PATTERN, APP_README_MAX_BYTES, APP_SECRET_PATTERNS, APP_SERVER_BUNDLE_MAX_GZIP_BYTES, APP_UI_MAX_BYTES, APP_UI_MAX_FILES, ApiError, ApprovalPendingError, STOREFRONT_BUILD_TERMINAL_STATUSES, STOREFRONT_SOURCE_BLOB_BATCH_MAX, appIconProblem, appManifestProblems, appManifestSchema, createStoreClient, normalizeStorefrontPath } from "@sayren/store-sdk";
+import { APP_DEPLOY_KEY_PATTERN, APP_README_MAX_BYTES, APP_SECRET_PATTERNS, APP_SERVER_BUNDLE_MAX_GZIP_BYTES, APP_UI_MAX_BYTES, APP_UI_MAX_FILES, ApiError, ApprovalPendingError, STOREFRONT_BUILD_TERMINAL_STATUSES, STOREFRONT_SOURCE_BLOB_BATCH_MAX, STORE_CODE_PATTERN, appIconProblem, appManifestProblems, appManifestSchema, createStoreClient, normalizeStorefrontPath } from "@sayren/store-sdk";
 import { chmodSync, closeSync, existsSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { createServer } from "node:http";
 import { dirname, extname, join, relative, resolve, sep } from "node:path";
-import { pathToFileURL } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { gzipSync } from "node:zlib";
 import { createHash, randomBytes } from "node:crypto";
 
@@ -86,7 +86,7 @@ function isAccountToken(token) {
 	return accountTokenClaimsOf(token) !== null;
 }
 /**
-* 폐기된 옛 상점 API 토큰(`sy_pat_…`) — #71 R1 뒤 api가 받지 않는다(401 `TOKEN_TYPE_RETIRED`). 받는 쪽은 api에 보내지 않고
+* 폐기된 옛 상점 API 토큰(`sy_pat_…`) — #71 R1 뒤 api가 받지 않는다(일반 401, #157). 받는 쪽은 api에 보내지 않고
 * 계정 액세스 토큰을 만들라고 바로 안내한다.
 */
 function isRetiredStorePat(token) {
@@ -2751,6 +2751,42 @@ const mcp_rule_tenant_header_why = ((inputs = {}, options = {}) => {
 	return ko_mcp_rule_tenant_header_why(inputs);
 });
 
+//#endregion
+//#region ../mcp/src/paraglide/messages/mcp_template_catalog_version_missing.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ name: NonNullable<unknown> }} Mcp_Template_Catalog_Version_MissingInputs */
+const ko_mcp_template_catalog_version_missing = (i) => {
+	return `catalog에 ${i?.name} 버전이 없습니다`;
+};
+/**
+
+* @param {Mcp_Template_Catalog_Version_MissingInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_template_catalog_version_missing = ((inputs, options = {}) => {
+	experimentalStaticLocale$1 ?? options.locale ?? getLocale$1();
+	return ko_mcp_template_catalog_version_missing(inputs);
+});
+
+//#endregion
+//#region ../mcp/src/paraglide/messages/mcp_template_published_version_unknown.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ name: NonNullable<unknown> }} Mcp_Template_Published_Version_UnknownInputs */
+const ko_mcp_template_published_version_unknown = (i) => {
+	return `${i?.name}의 배포 버전을 모르겠습니다`;
+};
+/**
+
+* @param {Mcp_Template_Published_Version_UnknownInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_template_published_version_unknown = ((inputs, options = {}) => {
+	experimentalStaticLocale$1 ?? options.locale ?? getLocale$1();
+	return ko_mcp_template_published_version_unknown(inputs);
+});
+
 //#endregion
 //#region ../mcp/src/paraglide/messages/mcp_verify_analytics_ids.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -5529,6 +5565,136 @@ const cli_continue_confirm = ((inputs = {}, options = {}) => {
 	return ko_cli_continue_confirm(inputs);
 });
 
+//#endregion
+//#region src/paraglide/messages/cli_create_dir_not_empty.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ dir: NonNullable<unknown> }} Cli_Create_Dir_Not_EmptyInputs */
+const ko_cli_create_dir_not_empty = (i) => {
+	return `폴더가 비어 있지 않습니다: ${i?.dir}. 새 폴더 이름을 주십시오`;
+};
+/**
+
+* @param {Cli_Create_Dir_Not_EmptyInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_create_dir_not_empty = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_create_dir_not_empty(inputs);
+});
+
+//#endregion
+//#region src/paraglide/messages/cli_create_done.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ dir: NonNullable<unknown>, count: NonNullable<unknown>, storeCode: NonNullable<unknown> }} Cli_Create_DoneInputs */
+const ko_cli_create_done = (i) => {
+	return `보일러플레이트를 만들었습니다 — ${i?.dir} (파일 ${i?.count}개, .env에 상점 ${i?.storeCode} 연결 값)
+다음:
+  cd ${i?.dir}
+  npm install
+  npm run dev`;
+};
+/**
+
+* @param {Cli_Create_DoneInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_create_done = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_create_done(inputs);
+});
+
+//#endregion
+//#region src/paraglide/messages/cli_create_name_invalid.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ name: NonNullable<unknown> }} Cli_Create_Name_InvalidInputs */
+const ko_cli_create_name_invalid = (i) => {
+	return `폴더 이름은 영문 소문자·숫자·.·_·-로 쓰고 영문 소문자나 숫자로 시작합니다: ${i?.name}`;
+};
+/**
+
+* @param {Cli_Create_Name_InvalidInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_create_name_invalid = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_create_name_invalid(inputs);
+});
+
+//#endregion
+//#region src/paraglide/messages/cli_create_prompt_store_code.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Create_Prompt_Store_CodeInputs */
+const ko_cli_create_prompt_store_code = () => {
+	return `상점 코드(상점 플랫폼 › 설정 › 상점 정보): `;
+};
+/**
+
+* @param {Cli_Create_Prompt_Store_CodeInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_create_prompt_store_code = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_create_prompt_store_code(inputs);
+});
+
+//#endregion
+//#region src/paraglide/messages/cli_create_store_code_invalid.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ storeCode: NonNullable<unknown> }} Cli_Create_Store_Code_InvalidInputs */
+const ko_cli_create_store_code_invalid = (i) => {
+	return `상점 코드 형식이 아닙니다: ${i?.storeCode}. 영문 소문자·숫자·-로 3~30자입니다`;
+};
+/**
+
+* @param {Cli_Create_Store_Code_InvalidInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_create_store_code_invalid = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_create_store_code_invalid(inputs);
+});
+
+//#endregion
+//#region src/paraglide/messages/cli_create_store_code_required.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Create_Store_Code_RequiredInputs */
+const ko_cli_create_store_code_required = () => {
+	return `상점 코드를 받지 못했습니다. --store-code <상점 코드>로 주십시오(비대화형은 필수입니다)`;
+};
+/**
+
+* @param {Cli_Create_Store_Code_RequiredInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_create_store_code_required = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_create_store_code_required(inputs);
+});
+
+//#endregion
+//#region src/paraglide/messages/cli_create_usage.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Create_UsageInputs */
+const ko_cli_create_usage = () => {
+	return `폴더 이름을 주십시오: npx sayren create <이름> [--store-code <상점 코드>]`;
+};
+/**
+
+* @param {Cli_Create_UsageInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_create_usage = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_create_usage(inputs);
+});
+
 //#endregion
 //#region src/paraglide/messages/cli_credentials_git_tracked.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -8835,6 +9001,7 @@ const ko_cli_usage = (i) => {
   npx sayren login --paste               # 액세스 토큰을 입력받아 저장(셸 기록에 남지 않습니다)
   npx sayren logout
   npx sayren whoami
+  npx sayren create <이름> [--store-code <상점 코드>]   # 스토어프론트 보일러플레이트를 새 폴더에 만듭니다(로그인 없음)
   npx sayren init [폴더] [--template <id>] [--store <storeId>] [--yes]
   npx sayren pull --project <storeId> [폴더] [--force [--yes]]
   npx sayren deploy [--no-publish] [--skip-build] [--message <메모>] [--force [--yes]]
@@ -8847,6 +9014,7 @@ const ko_cli_usage = (i) => {
   login    Sayren 계정으로 로그인합니다. 로그인 토큰은 사용자 설정 폴더(~/.config/sayren/credentials.json)에 둡니다
   logout   로그인을 폐기하고 이 컴퓨터의 토큰을 지웁니다
   whoami   쓰는 계정·토큰 종류·상점 범위
+  create   스토어프론트 보일러플레이트(상점 이름·상품 목록 홈, SDK·문구·분석·에이전트 안내)를 <이름> 폴더에 만들고 .env에 상점 연결 값을 씁니다. 호스팅 사이트는 만들지 않습니다
   init     템플릿을 골라 호스팅 사이트를 만들고 pull과 같은 폴더(기본: 상점 코드)로 받습니다. 사이트가 이미 있으면 만들지 않습니다
   pull     호스팅 중인 사이트의 작업 트리를 폴더(기본: 상점 코드)로 받고 .mcp.json·.env·.sayren/state.json을 씁니다
   deploy   로컬 검사 → 로컬 빌드 → 작업 트리 올리기 → 빌드 → 발행. 원격이 pull 이후 바뀌었으면 덮어쓰지 않습니다
@@ -8863,6 +9031,7 @@ const ko_cli_usage = (i) => {
 옵션:
   --project <storeId>  pull: 받을 상점(--store와 같습니다)
   --template <id>      init: 템플릿 id(비대화형은 필수)
+  --store-code <코드>  create: 연결할 상점 코드(없으면 묻습니다, 비대화형은 필수)
   --dir <폴더>         작업 폴더(기본: 지금 폴더, pull·init은 상점 코드)
   --force              pull: 같은 사이트를 받은 폴더에 원격을 다시 받습니다(지울·덮을 파일을 보여 주고 묻습니다)
                        deploy: 원격 변경·열린 편집 환경을 무시하고 덮어씁니다(확인을 묻습니다)
@@ -9784,7 +9953,7 @@ async function selectStore(auth, client, io, candidates, folderStore = null) {
 
 //#endregion
 //#region package.json
-var version = "0.13.0";
+var version = "0.14.0";
 
 //#endregion
 //#region src/client.ts
@@ -11131,7 +11300,7 @@ function verifySources(files, options = {}) {
 		if (cookieFiles.length > 0 && !cookieFiles.some((file) => /httpOnly\s*:\s*true/.test(file.content))) inProject("buyer-token-cookie", mcp_verify_buyer_token_cookie_missing());
 		if (!has(".refresh(")) inProject("buyer-session-refresh", mcp_verify_buyer_session_refresh());
 		if (has(".session(") && !has(".signUp(")) inProject("buyer-signup", mcp_verify_buyer_signup());
-		if (!matches(/\b(auth|authFor\(\))\.signOut\(|\.signOut\(\s*accessToken\b/)) inProject("buyer-signout", mcp_verify_buyer_signout());
+		if (!matches(/\b(auth|authFor\(\))\s*\.signOut\(|\.signOut\(\s*accessToken\b/)) inProject("buyer-signout", mcp_verify_buyer_signout());
 		if (!has("reconsentRequired")) inProject("buyer-reconsent", mcp_verify_buyer_reconsent());
 	}
 	if (has("startPayment(") && !has("checkoutAvailable")) inProject("checkout-availability", mcp_verify_checkout_availability());
@@ -11468,7 +11637,7 @@ const WRITABLE_ROOT_FILES = new Set([
 ]);
 /**
 * 읽기만 되는 루트 파일 — 의존성은 전용 경로로만 바꾼다(레지스트리 프록시와 잠금 파일을 함께 맞춘다).
-* `CLAUDE.md`·`.mcp.json`은 템플릿이 싣는 에이전트 안내·MCP 연결 설정이다(2026-10-14, blank 템플릿) — 편집 도구는 바꾸지 않는다
+* `CLAUDE.md`·`.mcp.json`은 템플릿이 싣는 에이전트 안내·MCP 연결 설정이다(2026-10-14 blank, #271부터 보일러플레이트 `boilerplate`) — 편집 도구는 바꾸지 않는다
 */
 const READONLY_ROOT_FILES = new Set([
 	"package.json",
@@ -11651,7 +11820,7 @@ function isNeverUpload(path) {
 	return segments.some((segment) => segment.startsWith(".env") || segment === ".sayren") || name === ".mcp.json" || name === ".sayrenrc";
 }
 /** 걸어 들어가지 않는 폴더 — 설치물·산출물·캐시·VCS(경로 규칙이 어차피 막는다. 크기 때문에 읽지도 않는다) */
-const SKIP_DIRS = new Set([
+const SKIP_DIRS$1 = new Set([
 	"node_modules",
 	"dist",
 	".output",
@@ -11672,7 +11841,7 @@ function collectTree(root) {
 			const full = join(dir, entry.name);
 			const rel = normalizeStorefrontPath(relative(root, full).split(sep).join("/"));
 			if (entry.isDirectory()) {
-				if (SKIP_DIRS.has(entry.name)) continue;
+				if (SKIP_DIRS$1.has(entry.name)) continue;
 				walk(full);
 				continue;
 			}
@@ -11883,7 +12052,7 @@ function lockImporterSpecifiers(lock) {
 //#region src/guide-skill.ts
 /**
 * 받은 폴더의 에이전트 안내 스킬(2026-10-16 사용자 결정) — 셀러의 Claude Code가 기능·화면을 고치기 전에 sayren 중앙 스킬을 `npx sayren skill`로 읽게 한다(스킬은 이 하나만 설치한다).
-* 빈 템플릿이 싣는 `templates/storefront-blank/.claude/skills/sayren/SKILL.md`와 같은 내용이다(`guide-skill.test.ts`가 고정한다).
+* 보일러플레이트(`npx sayren create`, #271)가 싣는 `packages/cli/boilerplate/.claude/skills/sayren/SKILL.md`와 같은 내용이다(`guide-skill.test.ts`가 고정한다).
 */
 const GUIDE_SKILL_PATH = ".claude/skills/sayren/SKILL.md";
 const GUIDE_SKILL = "---\nname: sayren\ndescription: Load before adding, implementing or changing any feature or page of this sayren storefront. Lists the current sayren skills and loads the ones the task needs.\n---\n\n# sayren skills\n\nThe sayren skills are maintained centrally and change without updating this project.\nDo not rely on memory or earlier copies. Load them at the start of each task.\n\n1. List the skills (name and when to use each):\n   `npx -y sayren@latest skill list`\n2. Read every skill that matches the task, in full, and follow it:\n   `npx -y sayren@latest skill <name>`\n\nIf the sayren MCP server is connected, the tools `list_skills` and `get_skill` return the same content.\n\nFollow the project's `CLAUDE.md` first. The skills add the sayren-specific details.\n";
@@ -12702,6 +12871,174 @@ function relativeOf(io, path) {
 	return relative(io.cwd, path) || ".";
 }
 
+//#endregion
+//#region ../mcp/src/template-package.ts
+/** package.json의 기준 템플릿 표식 필드 — 원천은 이 함수다(api `template-marker.ts`가 같은 모양을 읽는다) */
+function withTemplateMarker(pkg, marker) {
+	const current = pkg.sayren;
+	pkg.sayren = {
+		...current && typeof current === "object" && !Array.isArray(current) ? current : {},
+		template: marker.id,
+		templateVersion: marker.version
+	};
+	return pkg;
+}
+const DEP_FIELDS = [
+	"dependencies",
+	"devDependencies",
+	"peerDependencies"
+];
+function renderTemplatePackageJson(raw, meta, options = {}) {
+	const pkg = JSON.parse(raw);
+	for (const field of DEP_FIELDS) {
+		const deps = pkg[field];
+		if (!deps) continue;
+		for (const [name, spec] of Object.entries(deps)) deps[name] = resolveSpec(name, spec, meta);
+	}
+	if (options.name) pkg.name = options.name;
+	const marker = options.template ?? meta.template;
+	if (marker) withTemplateMarker(pkg, marker);
+	return `${JSON.stringify(pkg, null, 2)}\n`;
+}
+function resolveSpec(name, spec, meta) {
+	if (spec === "catalog:" || spec === "catalog:default") {
+		const version$1 = meta.catalog[name];
+		if (!version$1) throw new Error(mcp_template_catalog_version_missing({ name }));
+		return version$1;
+	}
+	if (spec.startsWith("workspace:")) return workspaceRange(name, spec.slice(10), meta);
+	return spec;
+}
+/**
+* `workspace:` 뒤 표기 → 셀러 프로젝트의 범위(#232). 템플릿은 SDK를 범위(`workspace:^0.35.0`)로 적고 `workspace:`만 뗀다 —
+* SDK patch가 올라도 풀어 쓴 package.json·첫 작업 트리가 그대로라 템플릿 버전을 올리지 않는다. 범위가 아닌 `*`·`^`·`~`만
+* 지금 워크스페이스 버전으로 푼다(`*`는 `^{버전}`)
+*/
+function workspaceRange(name, rest, meta) {
+	if (rest !== "*" && rest !== "^" && rest !== "~" && rest !== "") return rest;
+	const version$1 = meta.versions[name];
+	if (!version$1) throw new Error(mcp_template_published_version_unknown({ name }));
+	return `${rest === "~" ? "~" : "^"}${version$1}`;
+}
+/** pnpm-workspace.yaml의 최상위 `catalog:` 블록만 읽는다(`  key: value`, 따옴표 허용) */
+function parseCatalog(yaml) {
+	const out = {};
+	let inCatalog = false;
+	for (const line of yaml.split("\n")) {
+		if (/^catalog:\s*$/.test(line)) {
+			inCatalog = true;
+			continue;
+		}
+		if (!inCatalog) continue;
+		if (/^\S/.test(line)) break;
+		const match = line.match(/^\s+["']?([^"':]+)["']?\s*:\s*["']?([^"'#\s]+)["']?/);
+		if (match?.[1] && match[2]) out[match[1].trim()] = match[2];
+	}
+	return out;
+}
+function readWorkspaceVersions(packagesDir) {
+	const out = {};
+	for (const entry of readdirSync(packagesDir, { withFileTypes: true })) {
+		if (!entry.isDirectory()) continue;
+		const file = join(packagesDir, entry.name, "package.json");
+		if (!existsSync(file)) continue;
+		const pkg = JSON.parse(readFileSync(file, "utf8"));
+		if (pkg.name && pkg.version) out[pkg.name] = pkg.version;
+	}
+	return out;
+}
+
+//#endregion
+//#region src/create-command.ts
+/**
+* `npx sayren create <이름>`(#271) — 스토어프론트 보일러플레이트를 새 폴더에 쓴다. 원천은 `packages/cli/boilerplate` 하나이고
+* 호스팅 「처음부터」 템플릿(카탈로그 `boilerplate`)도 같은 폴더에서 만든다. 로그인·사이트 만들기는 하지 않는다(사이트는 `init`).
+* 상점 연결 값은 `--store-code` → 묻기(대화형) 순서이고 `.env`에 `SAYREN_API_URL`·`SAYREN_STORE_CODE`로 쓴다.
+*/
+/** 보일러플레이트 위치 — 게시본은 빌드가 복사한 `dist/boilerplate`, 저장소에서 바로 돌리면 `packages/cli/boilerplate` */
+function boilerplateRoot() {
+	const here = dirname(fileURLToPath(import.meta.url));
+	const candidates = [join(here, "boilerplate"), join(here, "..", "boilerplate")];
+	const found = candidates.find((dir) => existsSync(join(dir, "package.json")));
+	if (!found) throw new Error(`boilerplate not found: ${candidates.join(", ")}`);
+	return found;
+}
+/** 빌드가 남기는 버전 표(`scripts/copy-boilerplate.mjs`) — 게시본에는 pnpm-workspace.yaml이 없다 */
+const BOILERPLATE_META_FILE = ".boilerplate-meta.json";
+function metaOf(root) {
+	const bundled = join(root, BOILERPLATE_META_FILE);
+	if (existsSync(bundled)) return JSON.parse(readFileSync(bundled, "utf8"));
+	const repo = join(root, "..", "..", "..");
+	return {
+		catalog: parseCatalog(readFileSync(join(repo, "pnpm-workspace.yaml"), "utf8")),
+		versions: readWorkspaceVersions(join(repo, "packages"))
+	};
+}
+/** 싣지 않는 것 — 설치물·산출물·로컬 env. 점 파일은 에이전트 안내(`.claude/`·`.mcp.json`)와 `.gitignore`만 */
+const SKIP_DIRS = new Set([
+	"node_modules",
+	"dist",
+	".output",
+	".tanstack",
+	".nitro",
+	".wrangler"
+]);
+const DOT_KEPT = new Set([
+	".claude",
+	".mcp.json",
+	".gitignore"
+]);
+/** 보일러플레이트 파일 — 상대 경로 → 내용. 게시본의 `_gitignore`는 `.gitignore`로 되돌린다(npm이 `.gitignore`를 싣지 않는다) */
+function boilerplateFiles(root, name) {
+	const files = /* @__PURE__ */ new Map();
+	const walk = (dir) => {
+		for (const entry of readdirSync(dir, { withFileTypes: true })) {
+			if (SKIP_DIRS.has(entry.name)) continue;
+			if (entry.name.startsWith(".") && !DOT_KEPT.has(entry.name)) continue;
+			const full = join(dir, entry.name);
+			if (entry.isDirectory()) walk(full);
+			else if (entry.isFile()) {
+				const path = relative(root, full).split(sep).join("/");
+				files.set(path === "_gitignore" ? ".gitignore" : path, readFileSync(full));
+			}
+		}
+	};
+	walk(root);
+	const pkg = files.get("package.json");
+	if (!pkg) throw new Error("boilerplate package.json missing");
+	files.set("package.json", Buffer.from(renderTemplatePackageJson(pkg.toString("utf8"), metaOf(root), { name })));
+	return files;
+}
+/** npm 패키지 이름으로도 쓰는 폴더 이름 — 범위(@scope/) 없는 이름만 */
+const NAME_PATTERN = /^[a-z0-9][a-z0-9._-]{0,213}$/;
+async function create(flags, io) {
+	const name = flags.name?.trim();
+	if (!name) throw new CliError(cli_create_usage());
+	if (!NAME_PATTERN.test(name)) throw new CliError(cli_create_name_invalid({ name }));
+	const target = resolve(io.cwd, name);
+	if (existsSync(target) && (!statSync(target).isDirectory() || readdirSync(target).length > 0)) throw new CliError(cli_create_dir_not_empty({ dir: name }));
+	const storeCode = (flags.storeCode ?? (io.ask ? await io.ask(cli_create_prompt_store_code()) : null))?.trim();
+	if (!storeCode) throw new CliError(cli_create_store_code_required());
+	if (!STORE_CODE_PATTERN.test(storeCode)) throw new CliError(cli_create_store_code_invalid({ storeCode }));
+	const { apiOrigin } = resolveApiOrigin(flags, target, null, io.env);
+	const files = boilerplateFiles(boilerplateRoot(), name);
+	for (const [path, bytes] of files) {
+		const file = join(target, path);
+		mkdirSync(dirname(file), { recursive: true });
+		writeFileSync(file, bytes);
+	}
+	updateEnvFile(target, {
+		SAYREN_API_URL: `${apiOrigin}/storefront/v1`,
+		SAYREN_STORE_CODE: storeCode
+	});
+	io.out(cli_create_done({
+		dir: name,
+		count: files.size,
+		storeCode
+	}));
+	return 0;
+}
+
 //#endregion
 //#region src/skill-commands.ts
 /**
@@ -12742,6 +13079,7 @@ const VALUE_FLAGS = new Set([
 	"store",
 	"accounts-origin",
 	"template",
+	"store-code",
 	"key",
 	"name",
 	"port",
@@ -12842,6 +13180,11 @@ async function main(argv, io) {
 			tool: str(parsed.flags.tool),
 			yes: parsed.flags.yes === true
 		}, io);
+		case "create": return create({
+			name: parsed.positional[0],
+			storeCode: str(parsed.flags["store-code"]),
+			apiOrigin: str(parsed.flags["api-origin"])
+		}, io);
 		case "init": return init({
 			...common,
 			template: str(parsed.flags.template),
@@ -12893,6 +13236,7 @@ function defaultIo() {
 		out: (line) => console.log(line),
 		err: (line) => console.error(line),
 		confirm: stdin.isTTY ? async (question) => /^(y|yes|예|네)$/i.test((await ask(`${question} (y/N) `) ?? "").trim()) : null,
+		ask: stdin.isTTY ? ask : null,
 		sleep: (ms) => new Promise((resolve$1) => setTimeout(resolve$1, ms)),
 		buildTimeoutMs: 20 * 6e4,
 		pollMs: 3e3,
@@ -12935,7 +13279,6 @@ function openBrowser(url) {
 function describeError(error) {
 	if (error instanceof CliError) return error.message;
 	if (error instanceof ApiError) {
-		if (error.status === 401 && error.code === "TOKEN_TYPE_RETIRED") return cli_retired_token();
 		if (error.status === 401) return cli_error_unauthorized();
 		if (error.status === 403 && error.code === "STORE_NOT_GRANTED") return cli_error_store_not_granted();
 		if (error.status === 403 && error.code === "INSUFFICIENT_SCOPE") return cli_error_insufficient_scope();

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "sayren",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "type": "module",
   "imports": {
     "#paraglide/*": "./src/paraglide/*"
   },
-  "description": "sayren CLI — 호스팅 스토어프론트(init·pull·deploy)와 서드파티 앱(app init·dev·deploy·release)",
+  "description": "sayren CLI — 스토어프론트 보일러플레이트(create)·호스팅 스토어프론트(init·pull·deploy)와 서드파티 앱(app init·dev·deploy·release)",
   "bin": {
     "sayren": "./dist/index.mjs"
   },
@@ -17,7 +17,7 @@
   },
   "dependencies": {
     "esbuild": "^0.28.2",
-    "@sayren/store-sdk": "^0.37.0"
+    "@sayren/store-sdk": "^0.53.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.14",
@@ -28,7 +28,8 @@
     "tsx": "^4.20.3",
     "typescript": "^6.0.3",
     "vitest": "^5.0.1",
-    "@sayren/mcp": "0.27.0"
+    "@sayren/app": "0.9.0",
+    "@sayren/mcp": "0.29.3"
   },
   "publishConfig": {
     "access": "public"
@@ -41,7 +42,7 @@
   "scripts": {
     "dev": "tsx src/index.ts",
     "i18n": "paraglide-js compile --project ./project.inlang --outdir ./src/paraglide --strategy baseLocale --emit-ts-declarations --no-emit-readme --no-emit-prettier-ignore --silent",
-    "build": "pnpm i18n && tsdown",
+    "build": "pnpm i18n && tsdown && node scripts/copy-boilerplate.mjs",
     "lint": "biome check --write . && tsc --noEmit",
     "typecheck": "tsc --noEmit",
     "test": "vitest run"