sayren 0.11.0 → 0.12.0

package/dist/index.mjs

@@ -8039,58 +8039,57 @@ const cli_retired_token = ((inputs = {}, options = {}) => {
 });
 
 //#endregion
-//#region src/paraglide/messages/cli_skills_install_failed.js
+//#region src/paraglide/messages/cli_skill_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}`;
+/** @typedef {{ status: NonNullable<unknown> }} Cli_Skill_FailedInputs */
+const ko_cli_skill_failed = (i) => {
+	return `스킬을 읽지 못했습니다(HTTP ${i?.status})`;
 };
 /**
 
-* @param {Cli_Skills_Install_FailedInputs} inputs
+* @param {Cli_Skill_FailedInputs} inputs
 * @param {{ locale?: "ko" }} options
 * @returns {LocalizedString}
 */
-const cli_skills_install_failed = ((inputs, options = {}) => {
+const cli_skill_failed = ((inputs, options = {}) => {
 	experimentalStaticLocale ?? options.locale ?? getLocale();
-	return ko_cli_skills_install_failed(inputs);
+	return ko_cli_skill_failed(inputs);
 });
 
 //#endregion
-//#region src/paraglide/messages/cli_skills_installed.js
+//#region src/paraglide/messages/cli_skill_not_found.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
-/** @typedef {{}} Cli_Skills_InstalledInputs */
-const ko_cli_skills_installed = () => {
-	return `에이전트 스킬 설치 완료 — .claude/skills/ (배포 때 올리지 않습니다)`;
+/** @typedef {{ name: NonNullable<unknown> }} Cli_Skill_Not_FoundInputs */
+const ko_cli_skill_not_found = (i) => {
+	return `스킬 ${i?.name}이(가) 없습니다. npx sayren skill list로 목록을 확인하십시오`;
 };
 /**
 
-* @param {Cli_Skills_InstalledInputs} inputs
+* @param {Cli_Skill_Not_FoundInputs} inputs
 * @param {{ locale?: "ko" }} options
 * @returns {LocalizedString}
 */
-const cli_skills_installed = ((inputs = {}, options = {}) => {
+const cli_skill_not_found = ((inputs, options = {}) => {
 	experimentalStaticLocale ?? options.locale ?? getLocale();
-	return ko_cli_skills_installed(inputs);
+	return ko_cli_skill_not_found(inputs);
 });
 
 //#endregion
-//#region src/paraglide/messages/cli_skills_installing.js
+//#region src/paraglide/messages/cli_skill_usage.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
-/** @typedef {{ source: NonNullable<unknown> }} Cli_Skills_InstallingInputs */
-const ko_cli_skills_installing = (i) => {
-	return `에이전트 스킬 설치 중 — ${i?.source}`;
+/** @typedef {{}} Cli_Skill_UsageInputs */
+const ko_cli_skill_usage = () => {
+	return `스킬을 지정하십시오: npx sayren skill list 또는 npx sayren skill <이름>`;
 };
 /**
 
-* @param {Cli_Skills_InstallingInputs} inputs
+* @param {Cli_Skill_UsageInputs} inputs
 * @param {{ locale?: "ko" }} options
 * @returns {LocalizedString}
 */
-const cli_skills_installing = ((inputs, options = {}) => {
+const cli_skill_usage = ((inputs = {}, options = {}) => {
 	experimentalStaticLocale ?? options.locale ?? getLocale();
-	return ko_cli_skills_installing(inputs);
+	return ko_cli_skill_usage(inputs);
 });
 
 //#endregion
@@ -8801,6 +8800,7 @@ const ko_cli_usage = (i) => {
   npx sayren deploy [--no-publish] [--skip-build] [--message <메모>] [--force [--yes]]
   npx sayren status
   npx sayren verify
+  npx sayren skill list | <이름>         # sayren 스킬 목록·본문(에이전트용, 로그인 없음)
   npx sayren app <명령>                 # 서드파티 앱(init·dev·trigger·verify·deploy·release·status·logs·secret·dev-store)
 
 명령:
@@ -8812,6 +8812,7 @@ const ko_cli_usage = (i) => {
   deploy   로컬 검사 → 로컬 빌드 → 작업 트리 올리기 → 빌드 → 발행. 원격이 pull 이후 바뀌었으면 덮어쓰지 않습니다
   status   사이트·발행 버전·최근 빌드·편집 환경
   verify   로컬 규칙·경로·크기 검사(서버 빌드와 같은 규칙)
+  skill    sayren 스킬 목록(list)과 본문(<이름>)을 출력합니다. 스킬은 중앙에서 고치므로 늘 최신입니다
   app      서드파티 앱 — init <handle>로 만들고 dev로 로컬 실행, deploy로 버전을 올리고 release로 적용합니다. 자세히: https://docs.sayren.io/guides/apps-getting-started
 
 토큰은 Sayren 계정 토큰만 받고 --token → SAYREN_TOKEN 환경 변수 → 로그인(credentials.json) 순서로 읽습니다.
@@ -9743,7 +9744,7 @@ async function selectStore(auth, client, io, candidates, folderStore = null) {
 
 //#endregion
 //#region package.json
-var version = "0.11.0";
+var version = "0.12.0";
 
 //#endregion
 //#region src/client.ts
@@ -11586,116 +11587,6 @@ 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
 /**
@@ -11729,11 +11620,6 @@ 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);
@@ -11747,7 +11633,7 @@ function collectTree(root) {
 				skipped.push(rel);
 				continue;
 			}
-			if (isNeverUpload(rel) || accessOf(rel) === null || isInstalledSkill(rel)) {
+			if (isNeverUpload(rel) || accessOf(rel) === null) {
 				skipped.push(rel);
 				continue;
 			}
@@ -11949,11 +11835,11 @@ function lockImporterSpecifiers(lock) {
 //#endregion
 //#region src/guide-skill.ts
 /**
-* 받은 폴더의 에이전트 안내 스킬(2026-10-16 사용자 결정) — 셀러의 Claude Code가 sayren 중앙 스킬을 HTTP로 읽게 한다.
+* 받은 폴더의 에이전트 안내 스킬(2026-10-16 사용자 결정) — 셀러의 Claude Code가 기능·화면을 고치기 전에 sayren 중앙 스킬을 `npx sayren skill`로 읽게 한다(스킬은 이 하나만 설치한다).
 * 빈 템플릿이 싣는 `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";
+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";
 /**
 * 받은 트리에 안내 스킬이 없으면 넣는다 — 템플릿이 싣거나 셀러가 올린 내용이 우선이다. 트리에 넣으므로 다시 받을 때 지울 파일로 잡히지 않고
 * `deploy`가 원격 작업 트리에도 올린다(AI 상점 도우미가 같은 안내를 읽는다). 넣었으면 true
@@ -11964,6 +11850,55 @@ function withGuideSkill(files) {
 	return true;
 }
 
+//#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");
+}
+
 //#endregion
 //#region src/commands.ts
 /** 종료 코드 — 0 성공 · 1 실패 · 3 발행이 승인 대기(에이전트 토큰) */
@@ -12152,33 +12087,10 @@ 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회)를 쓰므로 확인을 묻는다.
@@ -12730,6 +12642,31 @@ function relativeOf(io, path) {
 	return relative(io.cwd, path) || ".";
 }
 
+//#endregion
+//#region src/skill-commands.ts
+/**
+* `sayren skill list`·`sayren skill <name>`(2026-10-16 사용자 결정) — 안내 스킬 `sayren`이 에이전트에게 부르게 하는 중앙 스킬 읽기.
+* 공개 스킬 API(`/v1/public/agent-skills`, 인증 없음)를 읽어 원문을 출력한다. 셸·OS와 무관하게 같은 명령이고 요약되지 않는다
+*/
+async function skill(args, flags, io) {
+	const [target] = args;
+	if (!target) throw new CliError(cli_skill_usage());
+	const { apiOrigin } = resolveApiOrigin(flags, io.cwd, null, io.env);
+	const path = target === "list" ? "" : `/${encodeURIComponent(target)}`;
+	const res = await io.fetch(`${apiOrigin}/v1/public/agent-skills${path}`, { headers: { "User-Agent": CLI_USER_AGENT } });
+	if (res.status === 404) throw new CliError(cli_skill_not_found({ name: target }));
+	if (!res.ok) throw new CliError(cli_skill_failed({ status: res.status }));
+	const { data } = await res.json();
+	if (target === "list") {
+		const skills = data;
+		const width = Math.max(...skills.map((s) => s.name.length));
+		for (const s of skills) io.out(`${s.name.padEnd(width)}  ${s.description}`);
+		return 0;
+	}
+	io.out(data.body);
+	return 0;
+}
+
 //#endregion
 //#region src/index.ts
 /** 도움말 — 쓰는 자리에서 만든다(로케일이 정해진 뒤) */
@@ -12869,6 +12806,7 @@ async function main(argv, io) {
 		case "login": return login(loginFlags, io, () => ask(cli_prompt_access_token()));
 		case "logout": return logout(loginFlags, io);
 		case "whoami": return whoami(common, io);
+		case "skill": return skill(parsed.positional, { apiOrigin: common.apiOrigin }, io);
 		default: throw new CliError(cli_unknown_command({
 			command: parsed.command,
 			usage: usage()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sayren",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "type": "module",
   "imports": {
     "#paraglide/*": "./src/paraglide/*"