sayren 0.3.2 → 0.3.3

package/dist/index.mjs

@@ -5294,6 +5294,79 @@ const mcp_rule_loader_first_why = ((inputs = {}, options = {}) => {
 	return ko_mcp_rule_loader_first_why(inputs);
 });
 
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_rule_local_import_exists_example.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Mcp_Rule_Local_Import_Exists_ExampleInputs */
+const ko_mcp_rule_local_import_exists_example = () => {
+	return `// src/i18n/index.ts — 작업 트리에 messages/ko.json이 있어야 한다
+import ko from "../../messages/ko.json";`;
+};
+/**
+
+* @param {Mcp_Rule_Local_Import_Exists_ExampleInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_rule_local_import_exists_example = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_rule_local_import_exists_example(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_rule_local_import_exists_fix.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Mcp_Rule_Local_Import_Exists_FixInputs */
+const ko_mcp_rule_local_import_exists_fix = () => {
+	return `빠진 파일을 템플릿 원본(로컬 \`get_template_file\`, 또는 \`npx @sayren/mcp create\`로 받은 사본)에서 가져와 같은 경로에 둔다. 호스팅 사이트는 \`write_files\`(\`expectedHash: null\`)나 \`sayren deploy\`로 올린다. 쓰지 않는 import면 지운다. 템플릿의 화면 문구는 \`messages/ko.json\`이다`;
+};
+/**
+
+* @param {Mcp_Rule_Local_Import_Exists_FixInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_rule_local_import_exists_fix = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_rule_local_import_exists_fix(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_rule_local_import_exists_title.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Mcp_Rule_Local_Import_Exists_TitleInputs */
+const ko_mcp_rule_local_import_exists_title = () => {
+	return `상대 경로로 import한 파일은 작업 트리에 있어야 한다`;
+};
+/**
+
+* @param {Mcp_Rule_Local_Import_Exists_TitleInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_rule_local_import_exists_title = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_rule_local_import_exists_title(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_rule_local_import_exists_why.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Mcp_Rule_Local_Import_Exists_WhyInputs */
+const ko_mcp_rule_local_import_exists_why = () => {
+	return `규칙 검사는 코드 문자열만 보지만 타입 검사와 빌드는 import한 파일을 실제로 읽는다. 대상 파일이 없으면 \`Cannot find module\`(TS2307)로 검사와 버전 빌드가 실패한다`;
+};
+/**
+
+* @param {Mcp_Rule_Local_Import_Exists_WhyInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_rule_local_import_exists_why = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_rule_local_import_exists_why(inputs);
+});
+
 //#endregion
 //#region ../i18n/src/paraglide/messages/mcp_rule_no_module_token_example.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -6312,6 +6385,24 @@ const mcp_verify_loader_first_query = ((inputs = {}, options = {}) => {
 	return ko_mcp_verify_loader_first_query(inputs);
 });
 
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_verify_local_import_missing.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ specifier: NonNullable<unknown>, path: NonNullable<unknown> }} Mcp_Verify_Local_Import_MissingInputs */
+const ko_mcp_verify_local_import_missing = (i) => {
+	return `\`${i?.specifier}\`를 import하지만 작업 트리에 \`${i?.path}\`가 없다`;
+};
+/**
+
+* @param {Mcp_Verify_Local_Import_MissingInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_verify_local_import_missing = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_verify_local_import_missing(inputs);
+});
+
 //#endregion
 //#region ../i18n/src/paraglide/messages/mcp_verify_no_module_token.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -6561,7 +6652,7 @@ function takeLangFlag(argv) {
 
 //#endregion
 //#region package.json
-var version = "0.3.2";
+var version = "0.3.3";
 
 //#endregion
 //#region src/client.ts
@@ -7783,6 +7874,14 @@ const RULES = [
 		doc: "/guides/storefront-sdk",
 		templateFile: "src/lib/ordering.ts",
 		severity: "warning"
+	}),
+	defineRule({
+		id: "local-import-exists",
+		title: mcp_rule_local_import_exists_title,
+		why: mcp_rule_local_import_exists_why,
+		fix: mcp_rule_local_import_exists_fix,
+		example: mcp_rule_local_import_exists_example,
+		doc: "/guides/mcp-customize"
 	})
 ];
 /**
@@ -7816,7 +7915,7 @@ const CUSTOM_INPUT_LEAKS = [
 * 만들어진 프로젝트의 소스를 규칙과 대조한다. 정적 검사라 모든 문제를 잡지는 못하지만,
 * 여기 있는 것들은 실제로 반복해서 깨지는 것들이다.
 */
-function verifySources(files) {
+function verifySources(files, options = {}) {
 	const findings = [];
 	const cleaned = files.map((file) => ({
 		path: file.path,
@@ -7889,8 +7988,67 @@ function verifySources(files) {
 	const clientQuery = matches(/\buse(Suspense)?Query\(/);
 	if (clientQuery && !has("ensureQueryData(") && !has("prefetchQuery(")) inFile("loader-first", clientQuery, mcp_verify_loader_first_query(), /\buse(Suspense)?Query\(/);
 	if (has("createStorefrontClient(") && !has("loader")) inProject("loader-first", mcp_verify_loader_first_missing());
+	if (options.paths) findings.push(...missingLocalImports(cleaned, options.paths));
 	return findings;
 }
+/** 상대 경로 import·export·동적 import의 대상 — `from "./x"`, `import "./x"`, `import("./x")` */
+const RELATIVE_IMPORT = /(?:\bfrom\s*|\bimport\s*\(?\s*)(["'])(\.{1,2}\/[^"'\n]+)\1/g;
+/** 확장자 없이 쓴 import가 가리킬 수 있는 파일 */
+const RESOLVE_SUFFIXES = [
+	".ts",
+	".tsx",
+	".js",
+	".jsx",
+	".mjs",
+	".json",
+	"/index.ts",
+	"/index.tsx",
+	"/index.js",
+	"/index.jsx"
+];
+/** `from` 파일 기준으로 상대 경로를 푼다. 작업 트리 루트 밖으로 나가면 null(판정하지 않는다) */
+function resolveRelative(from, specifier) {
+	const segments = from.split("/").slice(0, -1);
+	for (const segment of specifier.split("/")) {
+		if (segment === "" || segment === ".") continue;
+		if (segment === "..") {
+			if (!segments.length) return null;
+			segments.pop();
+		} else segments.push(segment);
+	}
+	return segments.join("/");
+}
+/**
+* 상대 경로로 import한 파일이 작업 트리에 있는가(이슈 #78) — 규칙 검사는 소스 문자열만 보므로 빠진 파일(예: 템플릿의
+* `messages/ko.json`)을 타입 검사·빌드 전에는 알 수 없었다. `paths`는 검사 대상 트리의 모든 파일 경로다(소스 아닌 파일 포함).
+* vite 쿼리(`?url`·`?raw`)는 떼고, `.js`로 쓴 TypeScript import(`./a.js` → `a.ts`)도 받는다.
+*/
+function missingLocalImports(files, paths) {
+	const tree = new Set(paths);
+	const out = [];
+	for (const file of files) for (const match of file.content.matchAll(RELATIVE_IMPORT)) {
+		const specifier = match[2];
+		const target = resolveRelative(file.path, specifier.replace(/[?#].*$/, ""));
+		if (target === null || target === "") continue;
+		const candidates = [target, ...RESOLVE_SUFFIXES.map((suffix) => `${target}${suffix}`)];
+		const js = /\.(m?js|jsx)$/.exec(target);
+		if (js) {
+			const stem = target.slice(0, -js[0].length);
+			candidates.push(`${stem}.ts`, `${stem}.tsx`, `${stem}.mts`);
+		}
+		if (candidates.some((candidate) => tree.has(candidate))) continue;
+		out.push({
+			ruleId: "local-import-exists",
+			file: file.path,
+			line: file.content.slice(0, match.index).split("\n").length,
+			detail: mcp_verify_local_import_missing({
+				specifier,
+				path: target
+			})
+		});
+	}
+	return out;
+}
 
 //#endregion
 //#region ../mcp/src/verify-report.ts
@@ -7932,9 +8090,12 @@ function nextSteps(findings, target) {
 		mcp_report_next_doc()
 	];
 }
-/** 소스를 규칙과 대조해 고칠 수 있는 보고서로 만든다 */
-function buildReport(files, target = "local") {
-	return reportFromFindings(verifySources(files), files.length, target);
+/**
+* 소스를 규칙과 대조해 고칠 수 있는 보고서로 만든다. `paths`(트리의 모든 파일 경로)를 주면 상대 경로 import의 대상이
+* 트리에 있는지도 본다(`local-import-exists`, #78)
+*/
+function buildReport(files, target = "local", paths) {
+	return reportFromFindings(verifySources(files, { paths }), files.length, target);
 }
 /**
 * 이미 찾은 위반으로 보고서를 만든다. 원격은 api가 작업 트리에서 `verifySources`를 돌려 위반만 돌려주고, 원인·수정
@@ -8015,7 +8176,7 @@ function verifyTree(files) {
 			path,
 			content
 		}];
-	}), "remote");
+	}), "remote", files.keys());
 }
 
 //#endregion
@@ -8048,7 +8209,21 @@ const WRITABLE_ROOT_FILES = new Set([
 ]);
 /** 읽기만 되는 루트 파일 — 의존성은 전용 경로로만 바꾼다(레지스트리 프록시와 잠금 파일을 함께 맞춘다) */
 const READONLY_ROOT_FILES = new Set(["package.json", "pnpm-lock.yaml"]);
-const WRITABLE_DIRS = new Set(["src", "public"]);
+/**
+* 쓸 수 있는 폴더 — 코드(`src`), 정적 파일(`public`), 화면 문구 카탈로그(`messages`, 템플릿 `src/i18n`이 `messages/ko.json`을 import한다, #73).
+* 템플릿이 import하는 파일이 이 밖에 있으면 첫 작업 트리(source.tgz)를 풀 때 빠져 빌드·검사가 깨진다(#78)
+*/
+const WRITABLE_DIRS = new Set([
+	"src",
+	"public",
+	"messages"
+]);
+/** 작업 트리 루트에 둘 수 있는 이름(폴더·파일) — 컨테이너 스냅샷이 이 이름만 묶는다(`container-tree.ts`) */
+const TRACKED_ROOT_NAMES = [
+	...WRITABLE_DIRS,
+	...WRITABLE_ROOT_FILES,
+	...READONLY_ROOT_FILES
+];
 /** 형식·금지 세그먼트만 본다(위치 규칙은 보지 않는다). 통과하면 null, 아니면 이유 */
 function formatProblem(path) {
 	if (typeof path !== "string" || path.length === 0) return "empty";
@@ -8184,7 +8359,7 @@ async function gunzip(bytes, maxBytes) {
 //#endregion
 //#region src/tree.ts
 /**
-* 로컬 작업 트리 — 서버 작업 트리와 **같은 경로 규칙**(편집 Sandbox `paths.ts`의 `accessOf`)으로 고른다. `src/**`·`public/**`·루트 설정
+* 로컬 작업 트리 — 서버 작업 트리와 **같은 경로 규칙**(편집 Sandbox `paths.ts`의 `accessOf`)으로 고른다. `src/**`·`public/**`·`messages/**`·루트 설정
 * 파일·`package.json`·`pnpm-lock.yaml`만 올리고, `.env*`·`.mcp.json`·`.sayren/`·`node_modules`·`dist`·`package-lock.json` 등은 올리지 않는다.
 * 비밀·로컬 상태 파일(`isNeverUpload`)은 서버 경로 규칙과 별개로 CLI가 먼저 막는다 — 서버 규칙이 넓어져도 토큰을 올리지 않게.
 */
@@ -8403,7 +8578,7 @@ function lockDrift(packageJson, lock) {
 /** 잠금 파일 `importers: .:`의 이름 → specifier. 읽지 못하면 null */
 function lockImporterSpecifiers(lock) {
 	const lines = lock.split(/\r?\n/);
-	const start = lines.findIndex((line) => line === "importers:");
+	const start = lines.indexOf("importers:");
 	if (start < 0) return null;
 	const out = /* @__PURE__ */ new Map();
 	let inRoot = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sayren",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "type": "module",
   "description": "sayren 스토어프론트 CLI — 호스팅 중인 사이트의 소스를 내려받고(pull) 로컬에서 고친 뒤 배포(deploy)합니다",
   "bin": {
@@ -13,7 +13,7 @@
     "node": ">=20.10"
   },
   "dependencies": {
-    "@sayren/store-sdk": "^0.28.1"
+    "@sayren/store-sdk": "^0.28.2"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.14",