lee-spec-kit 0.4.8 → 0.4.9

package/README.en.md

@@ -145,6 +145,9 @@ npx lee-spec-kit doctor --json
 
 ### Update templates
 
+By default, `update` runs only when the `docs/` working tree is clean; in that case it overwrites changed files without prompting.  
+If you want to update while you have uncommitted changes, use `--force`.
+
 ```bash
 npx lee-spec-kit update
 npx lee-spec-kit update --agents
@@ -176,11 +179,13 @@ Running `init` creates `.lee-spec-kit.json` in your docs root (default: `docs/`)
 | `lang`        | `ko` or `en`                                     |
 | `createdAt`   | Creation date                                    |
 | `docsRepo`    | `embedded` or `standalone`                       |
-| `projectRoot` | (standalone only) path to the project repository |
+| `pushDocs`    | (standalone only) whether to manage/push docs repo as a separate git repo |
+| `docsRemote`  | (standalone + pushDocs) docs repo remote URL |
+| `projectRoot` | (standalone only) project repo path (single: string, fullstack: {fe, be}) |
 
+> In standalone mode, `init` can add `pushDocs`, `docsRemote`, and `projectRoot` to this config.
 > If you run the CLI outside the docs repo in standalone mode, set `LEE_SPEC_KIT_DOCS_DIR` to the docs repo path.
 
 ## Generated Structure
 
 See the Korean README for the full tree examples and workflow details: `README.md`.
-

package/README.md

@@ -177,6 +177,9 @@ npx lee-spec-kit doctor --json
 
 ### 템플릿 업데이트
 
+기본 동작은 `docs/` 작업트리에 변경사항이 없을 때만 업데이트를 진행하며, 이 경우 변경된 파일은 확인 없이 덮어씁니다.  
+변경사항이 있는 상태에서 업데이트하려면 `--force`를 사용하세요.
+
 ```bash
 # 전체 업데이트
 npx lee-spec-kit update
@@ -190,7 +193,7 @@ npx lee-spec-kit update --skills
 # feature-base/ 폴더만 업데이트
 npx lee-spec-kit update --templates
 
-# 확인 없이 강제 덮어쓰기
+# 변경사항이 있어도 강제 덮어쓰기
 npx lee-spec-kit update --force
 ```
 
@@ -217,7 +220,9 @@ npx lee-spec-kit update --force
 | `lang`        | `ko` 또는 `en`                          |
 | `createdAt`   | 생성 날짜                               |
 | `docsRepo`    | `embedded` 또는 `standalone`            |
-| `projectRoot` | (standalone만) 프로젝트 레포지토리 경로 |
+| `pushDocs`    | (standalone만) docs 레포를 별도 Git으로 관리/푸시할지 여부 |
+| `docsRemote`  | (standalone+pushDocs) docs 레포 remote URL |
+| `projectRoot` | (standalone만) 프로젝트 레포지토리 경로 (single: string, fullstack: {fe, be}) |
 
 > `docsRepo: "standalone"`을 선택하면 `pushDocs`, `docsRemote`, `projectRoot`가 추가됩니다.
 
@@ -232,7 +237,10 @@ npx lee-spec-kit update --force
 {
   "projectName": "my-project",
   "projectType": "single",
+  "lang": "ko",
+  "createdAt": "YYYY-MM-DD",
   "docsRepo": "standalone",
+  "pushDocs": false,
   "projectRoot": "/path/to/my-project"
 }
 ```
@@ -243,7 +251,10 @@ npx lee-spec-kit update --force
 {
   "projectName": "my-project",
   "projectType": "fullstack",
+  "lang": "ko",
+  "createdAt": "YYYY-MM-DD",
   "docsRepo": "standalone",
+  "pushDocs": false,
   "projectRoot": {
     "fe": "/path/to/frontend",
     "be": "/path/to/backend"

package/dist/index.js

@@ -18,21 +18,25 @@ async function copyTemplates(src, dest) {
     errorOnExist: false
   });
 }
+function applyReplacements(content, replacements) {
+  const keys = Object.keys(replacements).sort((a, b) => b.length - a.length);
+  let next = content;
+  for (const key of keys) {
+    next = next.replaceAll(key, replacements[key]);
+  }
+  return next;
+}
 async function replaceInFiles(dir, replacements) {
   const files = await glob("**/*.md", { cwd: dir, absolute: true });
   for (const file of files) {
     let content = await fs8.readFile(file, "utf-8");
-    for (const [search, replace] of Object.entries(replacements)) {
-      content = content.replaceAll(search, replace);
-    }
+    content = applyReplacements(content, replacements);
     await fs8.writeFile(file, content, "utf-8");
   }
   const shFiles = await glob("**/*.sh", { cwd: dir, absolute: true });
   for (const file of shFiles) {
     let content = await fs8.readFile(file, "utf-8");
-    for (const [search, replace] of Object.entries(replacements)) {
-      content = content.replaceAll(search, replace);
-    }
+    content = applyReplacements(content, replacements);
     await fs8.writeFile(file, content, "utf-8");
   }
 }
@@ -93,6 +97,8 @@ var I18N = {
       "update.updatedTotal": "\uCD1D {count}\uAC1C \uD30C\uC77C \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC!",
       "update.changeDetected": "\uBCC0\uACBD \uAC10\uC9C0 (--force\uB85C \uB36E\uC5B4\uC4F0\uAE30)",
       "update.fileUpdated": "{file} \uC5C5\uB370\uC774\uD2B8",
+      "update.gitStatusUnavailable": "git \uC0C1\uD0DC\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. (git repo\uAC00 \uC544\uB2C8\uAC70\uB098 git \uC2E4\uD589 \uBD88\uAC00) --force\uB85C \uAC15\uC81C \uB36E\uC5B4\uC4F0\uAE30\uB97C \uC0AC\uC6A9\uD558\uC138\uC694.",
+      "update.docsWorktreeDirty": "docs \uC791\uC5C5\uD2B8\uB9AC\uC5D0 \uBCC0\uACBD\uC0AC\uD56D\uC774 \uC788\uC5B4 update\uB97C \uC9C4\uD589\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBCC0\uACBD\uC0AC\uD56D\uC744 \uCEE4\uBC0B/\uC2A4\uD0DC\uC2DC \uD6C4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uAC70\uB098 --force\uB85C \uB36E\uC5B4\uC4F0\uC138\uC694.",
       "doctor.title": "\u{1F50E} \uBB38\uC11C \uC9C4\uB2E8",
       "doctor.envWarnings": "\u26A0\uFE0F  \uD658\uACBD \uACBD\uACE0:",
       "doctor.noIssues": "\u2705 \uBB38\uC81C\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
@@ -266,6 +272,8 @@ var I18N = {
       "update.updatedTotal": "Updated {count} files!",
       "update.changeDetected": "changes detected (use --force to overwrite)",
       "update.fileUpdated": "{file} updated",
+      "update.gitStatusUnavailable": "Cannot determine git status (not a git repo or git unavailable). Use --force to overwrite.",
+      "update.docsWorktreeDirty": "Docs working tree has changes. Commit/stash your changes, or run with --force to overwrite.",
       "doctor.title": "\u{1F50E} Docs Doctor",
       "doctor.envWarnings": "\u26A0\uFE0F  Environment warnings:",
       "doctor.noIssues": "\u2705 No issues found.",
@@ -983,6 +991,7 @@ async function runFeature(name, options) {
     process.exit(1);
   }
   const { docsDir, projectType, lang } = config;
+  const projectName = config.projectName;
   assertValid(validateSafeName(name), "\uAE30\uB2A5 \uC774\uB984");
   let repo = options.repo;
   if (projectType === "fullstack" && !repo) {
@@ -1043,6 +1052,7 @@ async function runFeature(name, options) {
   const idNumber = featureId.replace("F", "");
   const repoName = projectType === "fullstack" && repo ? `{{projectName}}-${repo}` : "{{projectName}}";
   const replacements = {
+    "{{projectName}}": projectName ?? "{{projectName}}",
     // ko placeholders
     "{\uAE30\uB2A5\uBA85}": name,
     "{\uBC88\uD638}": idNumber,
@@ -2065,18 +2075,28 @@ async function getFeatureNameFromSpec(featureDir, fallbackSlug, fallbackFolderNa
   return fallbackSlug || fallbackFolderName;
 }
 function updateCommand(program2) {
-  program2.command("update").description("Update docs templates to the latest version").option("--agents", "Update agents/ folder only").option("--skills", "Update agents/skills folder only").option("--templates", "Update feature-base/ folder only").option("-f, --force", "Force overwrite without confirmation").action(async (options) => {
+  program2.command("update").description("Update docs templates to the latest version").option("--agents", "Update agents/ folder only").option("--skills", "Update agents/skills folder only").option("--templates", "Update feature-base/ folder only").option(
+    "-f, --force",
+    "Force overwrite even if docs has uncommitted changes"
+  ).action(async (options) => {
     try {
       await runUpdate(options);
     } catch (error) {
+      const config = await getConfig(process.cwd());
+      const lang = config?.lang ?? DEFAULT_LANG;
       if (error instanceof Error && error.message === "canceled") {
-        const config = await getConfig(process.cwd());
-        const lang = config?.lang ?? DEFAULT_LANG;
         console.log(chalk6.yellow(`
 ${tr(lang, "cli", "common.canceled")}`));
         process.exit(0);
       }
-      console.error(chalk6.red(tr(DEFAULT_LANG, "cli", "common.errorLabel")), error);
+      if (error instanceof Error) {
+        console.error(
+          chalk6.red(tr(lang, "cli", "common.errorLabel")),
+          chalk6.red(error.message)
+        );
+      } else {
+        console.error(chalk6.red(tr(lang, "cli", "common.errorLabel")), error);
+      }
       process.exit(1);
     }
   });
@@ -2096,6 +2116,7 @@ async function runUpdate(options) {
   const { docsDir, projectType, lang } = config;
   const templatesDir = getTemplatesDir();
   const sourceDir = path4.join(templatesDir, lang, projectType);
+  const forceOverwrite = !!options.force || await isDocsWorktreeCleanOrThrow(docsDir, lang);
   const hasExplicitSelection = !!(options.agents || options.skills || options.templates);
   const updateAgents = options.agents || options.skills || !hasExplicitSelection;
   const updateTemplates = options.templates || !hasExplicitSelection;
@@ -2120,15 +2141,20 @@ async function runUpdate(options) {
     const typeAgents = agentsMode === "skills" ? path4.join(typeAgentsBase, "skills") : typeAgentsBase;
     const targetAgents = agentsMode === "skills" ? path4.join(targetAgentsBase, "skills") : targetAgentsBase;
     const featurePath = projectType === "fullstack" ? "docs/features/{be|fe}" : "docs/features";
-    const replacements = {
+    const projectName = config.projectName ?? "{{projectName}}";
+    const commonReplacements = {
+      "{{projectName}}": projectName,
       "{{featurePath}}": featurePath
     };
+    const typeReplacements = {
+      "{{projectName}}": projectName
+    };
     if (await fs8.pathExists(commonAgents)) {
       const count = await updateFolder(
         commonAgents,
         targetAgents,
-        options.force,
-        replacements,
+        forceOverwrite,
+        commonReplacements,
         lang
       );
       updatedCount += count;
@@ -2137,8 +2163,8 @@ async function runUpdate(options) {
       const count = await updateFolder(
         typeAgents,
         targetAgents,
-        options.force,
-        void 0,
+        forceOverwrite,
+        typeReplacements,
         lang
       );
       updatedCount += count;
@@ -2154,11 +2180,14 @@ async function runUpdate(options) {
     const sourceFeatureBase = path4.join(sourceDir, "features", "feature-base");
     const targetFeatureBase = path4.join(docsDir, "features", "feature-base");
     if (await fs8.pathExists(sourceFeatureBase)) {
+      const replacements = {
+        "{{projectName}}": config.projectName ?? "{{projectName}}"
+      };
       const count = await updateFolder(
         sourceFeatureBase,
         targetFeatureBase,
-        options.force,
-        void 0,
+        forceOverwrite,
+        replacements,
         lang
       );
       updatedCount += count;
@@ -2191,9 +2220,7 @@ async function updateFolder(sourceDir, targetDir, force, replacements, lang = DE
       }
       let sourceContent = await fs8.readFile(sourcePath, "utf-8");
       if (replacements) {
-        for (const [key, value] of Object.entries(replacements)) {
-          sourceContent = sourceContent.replaceAll(key, value);
-        }
+        sourceContent = applyReplacements(sourceContent, replacements);
       }
       let shouldUpdate = true;
       if (await fs8.pathExists(targetPath)) {
@@ -2230,6 +2257,42 @@ async function updateFolder(sourceDir, targetDir, force, replacements, lang = DE
   }
   return updatedCount;
 }
+function getGitTopLevel2(cwd) {
+  try {
+    const out = execFileSync("git", ["rev-parse", "--show-toplevel"], {
+      cwd,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    return out || null;
+  } catch {
+    return null;
+  }
+}
+function getDocsPorcelainStatus(docsDir) {
+  const top = getGitTopLevel2(docsDir);
+  if (!top) return null;
+  const rel = path4.relative(top, docsDir) || ".";
+  try {
+    return execFileSync("git", ["status", "--porcelain=v1", "--", rel], {
+      cwd: top,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+  } catch {
+    return null;
+  }
+}
+async function isDocsWorktreeCleanOrThrow(docsDir, lang) {
+  const status = getDocsPorcelainStatus(docsDir);
+  if (status === null) {
+    throw new Error(tr(lang, "cli", "update.gitStatusUnavailable"));
+  }
+  if (status.trim().length > 0) {
+    throw new Error(tr(lang, "cli", "update.docsWorktreeDirty"));
+  }
+  return true;
+}
 function configCommand(program2) {
   program2.command("config").description("View or modify project configuration").option("--project-root <path>", "Set project root path").option("--repo <repo>", "Repository type for fullstack: fe | be").action(async (options) => {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lee-spec-kit",
-  "version": "0.4.8",
+  "version": "0.4.9",
   "description": "Project documentation structure generator for AI-assisted development",
   "type": "module",
   "bin": {