lee-spec-kit 0.4.7 → 0.4.9

package/README.en.md

@@ -0,0 +1,191 @@
+<h1 align="center">
+  <strong>lee-spec-kit</strong>
+</h1>
+
+<div align="center">
+<img src="./assets/logo.png" alt="lee-spec-kit logo" width="620" />
+</div>
+
+<p align="center">
+  <strong>CLI to generate a project docs structure for AI-assisted development</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/lee-spec-kit"><img src="https://img.shields.io/npm/v/lee-spec-kit.svg" alt="npm version"></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen" alt="Node.js">
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#features">Features</a> •
+  <a href="#usage">Usage</a> •
+  <a href="#generated-structure">Generated Structure</a>
+</p>
+
+<p align="center">
+  <a href="./README.en.md">
+    <img src="https://img.shields.io/badge/lang-en-red.svg" alt="English">
+  </a>
+  <a href="./README.md">
+    <img src="https://img.shields.io/badge/lang-ko-blue.svg" alt="한국어">
+  </a>
+</p>
+
+---
+
+## Quick Start
+
+```bash
+# 1) Initialize docs structure
+npx lee-spec-kit init
+
+# 2) Create a feature
+npx lee-spec-kit feature user-auth
+
+# 3) Show next steps (for agents)
+npx lee-spec-kit context
+
+# 4) Show overall status
+npx lee-spec-kit status
+
+# 5) Validate docs / feature metadata
+npx lee-spec-kit doctor
+```
+
+## Features
+
+### 📁 Project initialization
+
+- Interactive init or CLI options
+- Supports `single` and `fullstack` (FE/BE split)
+- Korean/English templates
+
+### 🚀 Feature creation
+
+- Generates `spec.md`, `plan.md`, `tasks.md`, `decisions.md`
+- Fullstack mode supports FE/BE separation
+- Integrates Issue/PR templates (docs side)
+
+### 📊 Status management
+
+- View feature progress at a glance
+- Print to terminal or write a Markdown report
+
+### 🩺 Doctor
+
+- Checks docs structure and feature metadata (missing status, duplicate IDs, placeholders, etc.)
+- `--json` output for automation/agents
+
+### 🔄 Template updates
+
+- Updates docs templates to the latest version
+
+## Usage
+
+### Init
+
+```bash
+npx lee-spec-kit init
+npx lee-spec-kit init --name my-project --type fullstack
+```
+
+**Options:**
+
+| Option              | Description                               | Default       |
+| ------------------- | ----------------------------------------- | ------------- |
+| `-n, --name <name>` | Project name                              | current folder |
+| `-t, --type <type>` | `single` or `fullstack`                   | interactive    |
+| `-l, --lang <lang>` | `ko` or `en`                              | `en`           |
+| `-d, --dir <dir>`   | Install directory                          | `./docs`       |
+| `-y, --yes`         | Skip interactive prompts                   | -              |
+
+### Create a feature
+
+```bash
+# Single
+npx lee-spec-kit feature user-auth
+
+# Fullstack
+npx lee-spec-kit feature --repo be user-auth
+npx lee-spec-kit feature --repo fe user-profile
+```
+
+### Context (agent guide)
+
+```bash
+# Auto-detect (based on git branch)
+npx lee-spec-kit context
+
+# Specify a feature
+npx lee-spec-kit context user-auth
+
+# Selector: Feature ID / folder name
+npx lee-spec-kit context F001
+npx lee-spec-kit context F001-user-auth
+
+# JSON output (for agents)
+npx lee-spec-kit context --json
+```
+
+### Status
+
+```bash
+npx lee-spec-kit status
+npx lee-spec-kit status --write
+```
+
+### Doctor
+
+```bash
+npx lee-spec-kit doctor
+npx lee-spec-kit doctor --strict
+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
+npx lee-spec-kit update --skills
+npx lee-spec-kit update --templates
+npx lee-spec-kit update --force
+```
+
+## Configuration
+
+### `.lee-spec-kit.json`
+
+Running `init` creates `.lee-spec-kit.json` in your docs root (default: `docs/`).
+
+```json
+{
+  "projectName": "my-project",
+  "projectType": "single",
+  "lang": "en",
+  "createdAt": "YYYY-MM-DD",
+  "docsRepo": "embedded"
+}
+```
+
+| Field         | Description                                      |
+| ------------- | ------------------------------------------------ |
+| `projectName` | Project name                                     |
+| `projectType` | `single` or `fullstack`                          |
+| `lang`        | `ko` or `en`                                     |
+| `createdAt`   | Creation date                                    |
+| `docsRepo`    | `embedded` or `standalone`                       |
+| `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

@@ -2,6 +2,10 @@
   <strong>lee-spec-kit</strong>
 </h1>
 
+<div align="center">
+<img src="./assets/logo.png" alt="lee-spec-kit logo" width="620" />
+</div>
+
 <p align="center">
   <strong>AI 에이전트 기반 개발을 위한 프로젝트 문서 구조 생성 CLI</strong>
 </p>
@@ -173,6 +177,9 @@ npx lee-spec-kit doctor --json
 
 ### 템플릿 업데이트
 
+기본 동작은 `docs/` 작업트리에 변경사항이 없을 때만 업데이트를 진행하며, 이 경우 변경된 파일은 확인 없이 덮어씁니다.  
+변경사항이 있는 상태에서 업데이트하려면 `--force`를 사용하세요.
+
 ```bash
 # 전체 업데이트
 npx lee-spec-kit update
@@ -186,7 +193,7 @@ npx lee-spec-kit update --skills
 # feature-base/ 폴더만 업데이트
 npx lee-spec-kit update --templates
 
-# 확인 없이 강제 덮어쓰기
+# 변경사항이 있어도 강제 덮어쓰기
 npx lee-spec-kit update --force
 ```
 
@@ -213,12 +220,14 @@ 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`가 추가됩니다.
 
 > 어디서 실행하든 설정을 찾을 수 있도록, CLI는 현재 디렉토리에서 상위로 올라가며 `.lee-spec-kit.json` 또는 `docs/.lee-spec-kit.json`을 탐색합니다.
-> standalone 환경에서 docs 레포 바깥(예: 프로젝트 레포)에서 실행해야 한다면 `LEE_SPEC_KIT_DOCS_DIR`(또는 `LSK_DOCS_DIR`)에 docs 레포 경로를 지정할 수 있습니다.
+> standalone 환경에서 docs 레포 바깥(예: 프로젝트 레포)에서 실행해야 한다면 `LEE_SPEC_KIT_DOCS_DIR`에 docs 레포 경로를 지정할 수 있습니다.
 
 ### Standalone 프로젝트 설정 예시
 
@@ -228,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"
 }
 ```
@@ -239,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.",
@@ -901,7 +909,7 @@ function getAncestorDirs(startDir) {
   return dirs;
 }
 async function getConfig(cwd) {
-  const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || process.env.LSK_DOCS_DIR || "").trim();
+  const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
   const baseDirs = [
     ...explicitDocsDir ? [path4.resolve(explicitDocsDir)] : [],
     ...getAncestorDirs(cwd)
@@ -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 {
@@ -2930,6 +2993,49 @@ function doctorCommand(program2) {
     process.exit(exitCode);
   });
 }
+function isBannerDisabled() {
+  const v = (process.env.LEE_SPEC_KIT_NO_BANNER || "").trim();
+  return v === "1";
+}
+function getBanner(opts) {
+  if (isBannerDisabled()) return "";
+  const lee = `
+\u2591\u2588\u2588         \u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588 \u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588 
+\u2591\u2588\u2588         \u2591\u2588\u2588         \u2591\u2588\u2588         
+\u2591\u2588\u2588         \u2591\u2588\u2588         \u2591\u2588\u2588         
+\u2591\u2588\u2588         \u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588  \u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588  
+\u2591\u2588\u2588         \u2591\u2588\u2588         \u2591\u2588\u2588         
+\u2591\u2588\u2588         \u2591\u2588\u2588         \u2591\u2588\u2588         
+\u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588 \u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588 \u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588 
+  `;
+  const spec = `
+  \u2591\u2588\u2588\u2588\u2588\u2588\u2588   \u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588  \u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588   \u2591\u2588\u2588\u2588\u2588\u2588\u2588  
+ \u2591\u2588\u2588   \u2591\u2588\u2588  \u2591\u2588\u2588     \u2591\u2588\u2588 \u2591\u2588\u2588          \u2591\u2588\u2588   \u2591\u2588\u2588 
+\u2591\u2588\u2588         \u2591\u2588\u2588     \u2591\u2588\u2588 \u2591\u2588\u2588         \u2591\u2588\u2588        
+ \u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588  \u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588  \u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588  \u2591\u2588\u2588        
+        \u2591\u2588\u2588 \u2591\u2588\u2588         \u2591\u2588\u2588         \u2591\u2588\u2588        
+ \u2591\u2588\u2588   \u2591\u2588\u2588  \u2591\u2588\u2588         \u2591\u2588\u2588          \u2591\u2588\u2588   \u2591\u2588\u2588 
+  \u2591\u2588\u2588\u2588\u2588\u2588\u2588   \u2591\u2588\u2588         \u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588   \u2591\u2588\u2588\u2588\u2588\u2588\u2588  
+  `;
+  const kit = `
+\u2591\u2588\u2588     \u2591\u2588\u2588 \u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588
+\u2591\u2588\u2588    \u2591\u2588\u2588    \u2591\u2588\u2588      \u2591\u2588\u2588    
+\u2591\u2588\u2588   \u2591\u2588\u2588     \u2591\u2588\u2588      \u2591\u2588\u2588    
+\u2591\u2588\u2588\u2588\u2588\u2588\u2588\u2588      \u2591\u2588\u2588      \u2591\u2588\u2588    
+\u2591\u2588\u2588   \u2591\u2588\u2588     \u2591\u2588\u2588      \u2591\u2588\u2588    
+\u2591\u2588\u2588    \u2591\u2588\u2588    \u2591\u2588\u2588      \u2591\u2588\u2588    
+\u2591\u2588\u2588     \u2591\u2588\u2588 \u2591\u2588\u2588\u2588\u2588\u2588\u2588    \u2591\u2588\u2588    
+  `;
+  const ascii = `${lee}${spec}${kit}`;
+  const version = opts?.version ? `v${opts.version}` : "";
+  const footer = version ? `
+${version}
+` : "\n";
+  if (process.stdout.isTTY) {
+    return `${chalk6.cyan(ascii)}${chalk6.gray(footer)}`;
+  }
+  return `${ascii}${footer}`;
+}
 var CACHE_FILE = path4.join(os.homedir(), ".lee-spec-kit-version-cache.json");
 var CHECK_INTERVAL = 24 * 60 * 60 * 1e3;
 function getCurrentVersion() {
@@ -3014,7 +3120,7 @@ function shouldCheckForUpdates() {
   const argv = process.argv.slice(2);
   const hasJsonFlag = argv.includes("--json");
   const isHelpOrVersion = argv.includes("--help") || argv.includes("-h") || argv.includes("--version") || argv.includes("-V");
-  const disabledByEnv = (process.env.LSK_NO_UPDATE_CHECK || "").trim() === "1" || (process.env.LEE_SPEC_KIT_NO_UPDATE_CHECK || "").trim() === "1";
+  const disabledByEnv = (process.env.LEE_SPEC_KIT_NO_UPDATE_CHECK || "").trim() === "1";
   if (hasJsonFlag) return false;
   if (!process.stdout.isTTY) return false;
   if (isHelpOrVersion) return false;
@@ -3033,9 +3139,10 @@ function getCliVersion() {
   }
   return "0.0.0";
 }
+var cliVersion = getCliVersion();
 program.name("lee-spec-kit").description(
   "Project documentation structure generator for AI-assisted development"
-).version(getCliVersion());
+).version(cliVersion).addHelpText("beforeAll", getBanner({ version: cliVersion }));
 initCommand(program);
 featureCommand(program);
 statusCommand(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lee-spec-kit",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "Project documentation structure generator for AI-assisted development",
   "type": "module",
   "bin": {
@@ -10,7 +10,8 @@
   "main": "./dist/index.js",
   "files": [
     "dist",
-    "templates"
+    "templates",
+    "assets"
   ],
   "keywords": [
     "docs",