sparkle-design-cli 2.0.7-beta.8 → 2.0.7-beta.9

package/lib/font-manager.js

@@ -277,15 +277,33 @@ export function updateGlobalsWithFonts(
     // 2. 既存のimportを削除
     globalsContent = removeExistingImports(globalsContent);
 
-    // 3. Tailwind import の位置を見つける
-    const tailwindInfo = findTailwindImport(globalsContent);
+    // 3. Tailwind import の位置を見つける。無ければ先頭に自動で prepend する。
+    //    ここで silent に失敗すると `create-vite` 等が生成した既存 index.css に
+    //    `@import "tailwindcss"` が無いプロジェクトで setup が no-op に終わり、
+    //    AI が後から手書きで import を補うが `@source` を知らず落とす、という
+    //    連鎖的な崩れが起きていた（beta.8 試用で確認）。canonical な import を
+    //    自動投入することでその連鎖を根絶する。
+    // en: If `@import "tailwindcss"` is missing from an existing entry CSS
+    // (e.g. untouched `create-vite` default), auto-prepend it instead of
+    // silently warning. Without this recovery, the whole patch becomes a no-op
+    // and AI ends up hand-writing imports without `@source`, producing drifted
+    // output (observed in beta.8 user testing).
+    let tailwindInfo = findTailwindImport(globalsContent);
     if (!tailwindInfo) {
-      // 表示はプロジェクト相対パスにする。絶対パスだと「どのファイルをいじるのか」
-      // が一目で分かりにくく、リポジトリ間で絶対パスが変わるので diff も読みにくい。
-      // en: Show the project-relative path so it's obvious which file to edit.
       const displayPath = path.relative(process.cwd(), globalsPath) || globalsPath;
-      console.warn(MESSAGES.TAILWIND_NOT_FOUND(displayPath));
-      return { status: 'failed', reason: 'tailwind-import-missing' };
+      console.warn(
+        `⚠️  ${displayPath} に \`@import "tailwindcss";\` が見つからなかったため先頭に追記します（canonical な Tailwind v4 entry point にするため）。`
+      );
+      globalsContent = `${IMPORTS.TAILWIND}\n${globalsContent.startsWith('\n') ? '' : ''}${globalsContent}`;
+      tailwindInfo = findTailwindImport(globalsContent);
+      if (!tailwindInfo) {
+        // prepend したのに正規表現で拾えないのは `REGEX.TAILWIND_IMPORT` が
+        // 想定と違う（= コードの不整合）。fail-fast する。
+        // en: We just wrote the canonical import but the regex doesn't see it —
+        // this is an internal inconsistency, not a user error. Fail loud.
+        console.error(MESSAGES.TAILWIND_NOT_FOUND(displayPath));
+        return { status: 'failed', reason: 'tailwind-import-missing-after-prepend' };
+      }
     }
 
     // 4. importブロックを生成（フォント @import は SparkleHead に移行したため生成しない）
@@ -451,11 +469,22 @@ function resolveGlobalsPath(sparkleDesignPath, explicitGlobalsPath = null) {
   const candidates = isViteProject(cwd)
     ? GLOBALS_CSS_CANDIDATES.slice().sort((a, b) => vitePriority(a) - vitePriority(b))
     : GLOBALS_CSS_CANDIDATES;
+  // 2-a) まず既知候補の中で `@import "tailwindcss"` を持つファイルを探す。
+  //       持っているファイルが第一候補（canonical Tailwind entry CSS）。
+  // 2-b) 2-a で見つからなかった場合、`@import` 無しで既存の候補ファイルが
+  //       あればそれを拾う（Vite の `create-vite` 直後のように entry CSS は
+  //       あるが Tailwind 未設定のプロジェクト）。これで上流の
+  //       `updateGlobalsWithFonts` が auto-prepend で tailwind import を
+  //       補えるため、silent に no-op 終了する回帰を避けられる（beta.8 で再現）。
+  // en: First pick candidates that already contain `@import "tailwindcss"`.
+  // If none match, fall back to the first existing candidate anyway so the
+  // upstream patcher can auto-prepend the canonical tailwind import. Without
+  // this fallback, a Vite project created by `create-vite` with an untouched
+  // `src/index.css` would cause setup to end as a silent no-op.
+  let fallbackExistingPath = null;
   for (const candidate of candidates) {
     const absolute = path.resolve(cwd, candidate);
     if (!fs.existsSync(absolute)) continue;
-    // 自身（sparkle-design.css）は除外
-    // en: Skip sparkle-design.css itself just in case a candidate points at it.
     if (path.resolve(absolute) === path.resolve(sparkleDesignPath)) continue;
     try {
       const content = fs.readFileSync(absolute, 'utf8');
@@ -463,6 +492,9 @@ function resolveGlobalsPath(sparkleDesignPath, explicitGlobalsPath = null) {
         console.log(`📝 Tailwind エントリポイントを検出しました（project root）: ${candidate}`);
         return { path: absolute, source: 'project' };
       }
+      if (!fallbackExistingPath) {
+        fallbackExistingPath = { path: absolute, candidate };
+      }
     } catch (err) {
       // ENOENT 系は existsSync で既に弾いているので、ここに来るのは権限不足や
       // ディレクトリ衝突などデバッグ価値のあるケース。silent に消さずに理由を出す。
@@ -474,6 +506,13 @@ function resolveGlobalsPath(sparkleDesignPath, explicitGlobalsPath = null) {
     }
   }
 
+  if (fallbackExistingPath) {
+    console.log(
+      `📝 Tailwind import 未設定の既存 entry CSS を検出しました（project root）: ${fallbackExistingPath.candidate}。後続処理で \`@import "tailwindcss";\` を自動追記します。`
+    );
+    return { path: fallbackExistingPath.path, source: 'existing-no-tailwind' };
+  }
+
   // 3. デフォルト: sparkle-design.css と同じディレクトリの globals.css
   // en: Last resort — a globals.css next to sparkle-design.css.
   const defaultPath = path.join(dir, 'globals.css');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sparkle-design-cli",
-  "version": "2.0.7-beta.8",
+  "version": "2.0.7-beta.9",
   "description": "Sparkle Design CLI — プロジェクトセットアップ、CSS・フォント生成、アンチパターン検査、AI エージェント（Claude Code / Cursor / Codex）向けのガードと hook 設定まで一括で行う sparkle-design 公式 CLI。",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",