@haposoft/cafekit 0.11.0 → 0.11.2

package/bin/lib/context.js

@@ -247,6 +247,9 @@ function buildContext(argv, runId) {
   const interactive = isInteractive() && !options.yes;
   // Language: --lang wins; otherwise English (an interactive prompt may change it).
   const lang = options.lang ? resolveLang(options.lang) : 'en';
+  // ctx.locale = the string that gets written to CLAUDE.md / runtime.json as the AI's response language.
+  // For known codes it mirrors lang; for "other", it's set later by setLang.
+  const locale = options.lang || 'en';
   return {
     argv,
     runId,
@@ -254,11 +257,13 @@ function buildContext(argv, runId) {
     dryRun: options.dryRun,
     interactive,
     ui: createUI(interactive),
-    lang,
+    lang,        // UI language (one of SUPPORTED)
+    locale,      // AI response language label (may be freeform, e.g. "Korean")
     t: createTranslator(lang),
-    /** Update the active language + translator (used by the language prompt). */
-    setLang(code) {
+    /** Update UI lang + AI locale. rawLabel is the freeform label when user picks "Other". */
+    setLang(code, rawLabel) {
       this.lang = resolveLang(code);
+      this.locale = rawLabel || LANGUAGE_LABELS[this.lang] || this.lang;
       this.t = createTranslator(this.lang);
     },
     manifest: loadClaudeMigrationManifest(),  // migration manifest (skills/agents/runtime lists)

package/bin/lib/i18n.js

@@ -11,6 +11,7 @@
 const SUPPORTED = ['en', 'ja', 'vi'];
 
 const LANGUAGE_LABELS = { en: 'English', ja: '日本語', vi: 'Tiếng Việt' };
+const OTHER_LABEL = { en: 'Other...', ja: 'その他...', vi: 'Ngôn ngữ khác...' };
 
 const MESSAGES = {
   // ─── English ───────────────────────────────────────────────────────────────
@@ -264,4 +265,4 @@ function createTranslator(lang) {
   };
 }
 
-module.exports = { SUPPORTED, LANGUAGE_LABELS, MESSAGES, resolveLang, createTranslator };
+module.exports = { SUPPORTED, LANGUAGE_LABELS, OTHER_LABEL, MESSAGES, resolveLang, createTranslator };

package/bin/phases/post-install.js

@@ -30,8 +30,9 @@ function patchSettingsLanguage(ctx) {
     return;
   }
 
-  const label = LANGUAGE_LABELS[ctx.lang] || ctx.lang;
-  if (settings.language === label) return; // already up to date
+  // Use locale (freeform label) so "Korean" shows correctly, not just "en".
+  const label = ctx.locale || LANGUAGE_LABELS[ctx.lang] || ctx.lang;
+  if (settings.language === label) return;
   settings.language = label;
   fs.writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}\n`, 'utf8');
 }
@@ -46,13 +47,16 @@ function patchSettingsLanguage(ctx) {
  */
 function patchLanguageSection(ctx) {
   if (!ctx.platforms.includes('claude')) return;
-  if (ctx.lang === 'en') return; // English is the default — no override needed.
+  // Skip when locale is English (default — no override needed in CLAUDE.md).
+  const locale = ctx.locale || ctx.lang;
+  if (!locale || locale === 'en' || locale === 'English') return;
 
   const claudeMdFile = path.join(process.cwd(), 'CLAUDE.md');
   if (!fs.existsSync(claudeMdFile)) return;
 
   const LANG_LABEL = { vi: 'Vietnamese', ja: 'Japanese', en: 'English' };
-  const label = LANG_LABEL[ctx.lang] || ctx.lang;
+  // Use locale directly when set (e.g. "Korean"), or map from lang code.
+  const label = locale in LANG_LABEL ? LANG_LABEL[locale] : locale;
 
   const newSection = `## Language Consistency <!-- cafekit:lang -->
 
@@ -86,8 +90,10 @@ function patchRuntimeLocale(ctx) {
       continue;
     }
     data.locale = data.locale || {};
-    if (data.locale.responseLanguage === ctx.lang) continue;
-    data.locale.responseLanguage = ctx.lang;
+    // Use locale (freeform label) so custom languages propagate to the AI hook.
+    const locale = ctx.locale || ctx.lang;
+    if (data.locale.responseLanguage === locale) continue;
+    data.locale.responseLanguage = locale;
     fs.writeFileSync(rtPath, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
     if (ctx.trackers[key]) ctx.trackers[key].record(rtPath);
   }

package/bin/phases/select-platform.js

@@ -12,21 +12,38 @@ const {
   getPlatformKeys,
   warnLegacyClaudeFolder
 } = require('../lib/context');
-const { SUPPORTED, LANGUAGE_LABELS } = require('../lib/i18n');
+const { SUPPORTED, LANGUAGE_LABELS, OTHER_LABEL } = require('../lib/i18n');
+
+const OTHER = '__other__';
 
 /** First step: pick the installer/UI language (interactive only). */
 async function selectLanguage(ctx) {
-  // Honor an explicit --lang or non-interactive default (English) without prompting.
   if (!ctx.interactive || ctx.options.lang) return ctx;
 
+  const options = [
+    ...SUPPORTED.map((code) => ({ value: code, label: LANGUAGE_LABELS[code] })),
+    { value: OTHER, label: OTHER_LABEL.en + ' / その他 / Ngôn ngữ khác' }
+  ];
+
   const r = await ctx.ui.select(
-    {
-      message: 'Select language · 言語を選択 · Chọn ngôn ngữ',
-      options: SUPPORTED.map((code) => ({ value: code, label: LANGUAGE_LABELS[code] }))
-    },
+    { message: 'Select language · 言語を選択 · Chọn ngôn ngữ', options },
     ctx.lang
   );
-  if (!ctx.ui.isCancel(r)) ctx.setLang(r);
+  if (ctx.ui.isCancel(r)) return ctx;
+
+  if (r === OTHER) {
+    // User types their language name — UI stays English, AI responds in that language.
+    const typed = await ctx.ui.text(
+      { message: 'Enter your language (e.g. Korean, French, Spanish…)', placeholder: 'Language name in English' },
+      ''
+    );
+    if (!ctx.ui.isCancel(typed) && typed && typed.trim()) {
+      ctx.setLang('en', typed.trim()); // UI = English, locale = user's label
+    }
+  } else {
+    ctx.setLang(r, LANGUAGE_LABELS[r]);
+  }
+
   return ctx;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haposoft/cafekit",
-  "version": "0.11.0",
+  "version": "0.11.2",
   "description": "Claude Code-first spec-driven workflow for AI coding assistants. Bundles CafeKit hapo: skills, runtime hooks, agents, and installer scaffolding.",
   "author": "Haposoft <nghialt@haposoft.com>",
   "license": "MIT",

package/src/claude/gitignore

@@ -17,3 +17,4 @@ hooks/.logs/
 agent-memory/
 settings.bak.json
 .mcp.json
+.cafekit-update-cache.json

package/src/claude/hooks/session.cjs

@@ -18,8 +18,6 @@ try {
   const { execSync } = require('child_process');
 
   // ── Utilities ─────────────────────────────────────────────────────────────
-
-  /** Run a shell command safely, return stdout or fallback */
   function run(cmd, fallback = '') {
     try {
       return execSync(cmd, {
@@ -88,8 +86,97 @@ try {
     return '';
   }
 
+  // ── CafeKit Update Check ──────────────────────────────────────────────────
+
+  /**
+   * Fetch the latest published version of @haposoft/cafekit from the npm registry.
+   * Returns a string (e.g. "0.11.2") or null on any failure. Timeout: 3 s.
+   */
+  function fetchLatestVersion() {
+    try {
+      const https = require('https');
+      return new Promise((resolve) => {
+        const req = https.get(
+          'https://registry.npmjs.org/@haposoft/cafekit/latest',
+          { timeout: 3000, headers: { Accept: 'application/json' } },
+          (res) => {
+            let body = '';
+            res.on('data', (chunk) => { body += chunk; });
+            res.on('end', () => {
+              try { resolve(JSON.parse(body).version || null); }
+              catch { resolve(null); }
+            });
+          }
+        );
+        req.on('error', () => resolve(null));
+        req.on('timeout', () => { req.destroy(); resolve(null); });
+      });
+    } catch { return Promise.resolve(null); }
+  }
+
+  /** Simple semver compare: returns true when b > a. */
+  function isNewer(a, b) {
+    const n = (v) => String(v).split('.').map((x) => parseInt(x, 10) || 0);
+    const [aN, bN] = [n(a), n(b)];
+    for (let i = 0; i < 3; i++) {
+      if (bN[i] > aN[i]) return true;
+      if (bN[i] < aN[i]) return false;
+    }
+    return false;
+  }
+
+  /**
+   * Read the installed CafeKit version from .claude/cafekit.json.
+   * Returns null if not found.
+   */
+  function getInstalledVersion(cwd) {
+    try {
+      const p = path.join(cwd, '.claude', 'cafekit.json');
+      if (!fs.existsSync(p)) return null;
+      const meta = JSON.parse(fs.readFileSync(p, 'utf8'));
+      return typeof meta.version === 'string' ? meta.version : null;
+    } catch { return null; }
+  }
+
+  /**
+   * Check for a newer CafeKit version and return an update notice string,
+   * or an empty string if already up to date or check fails.
+   * Result is cached in .claude/.cafekit-update-cache.json for 12 hours.
+   */
+  async function checkCafeKitUpdate(cwd) {
+    const installed = getInstalledVersion(cwd);
+    if (!installed) return '';
+
+    const CACHE_TTL = 12 * 60 * 60 * 1000; // 12 hours
+    const cachePath = path.join(cwd, '.claude', '.cafekit-update-cache.json');
+
+    // Return cached result if still fresh.
+    try {
+      if (fs.existsSync(cachePath)) {
+        const cache = JSON.parse(fs.readFileSync(cachePath, 'utf8'));
+        if (Date.now() - (cache.ts || 0) < CACHE_TTL) {
+          return cache.notice || '';
+        }
+      }
+    } catch { /* stale or corrupt — refetch */ }
+
+    // Fetch from npm registry.
+    const latest = await fetchLatestVersion();
+    const notice = (latest && isNewer(installed, latest))
+      ? `\n⚡ CafeKit update available: ${installed} → ${latest}\n   Run: npx @haposoft/cafekit\n`
+      : '';
+
+    // Persist cache (fail-open if write fails).
+    try {
+      fs.writeFileSync(cachePath, JSON.stringify({ ts: Date.now(), notice }), 'utf8');
+    } catch { /* fail-open */ }
+
+    return notice;
+  }
+
   // ── Main ──────────────────────────────────────────────────────────────────
 
+  (async () => {
   const stdin   = fs.readFileSync(0, 'utf8').trim();
   const payload = stdin ? JSON.parse(stdin) : {};
   const source  = payload.source || 'unknown';
@@ -97,6 +184,9 @@ try {
   const cwd     = process.cwd();
   const runtime = readRuntime(cwd);
 
+  // Check CafeKit update in parallel with project detection (async, fail-open).
+  const updateCheckPromise = checkCafeKitUpdate(cwd);
+
   // Project detection
   const projectType = runtime.project?.type !== 'auto'
     ? (runtime.project?.type || detectProjectType())
@@ -137,14 +227,15 @@ try {
     writeEnv(envFile, 'LOCALE',          process.env.LANG || '');
   }
 
-  // Session summary
+  // Session summary + update notice
+  const updateNotice = await updateCheckPromise;
   const parts = [];
   if (projectType)    parts.push(`Type: ${projectType}`);
   if (packageManager) parts.push(`PM: ${packageManager}`);
   if (framework)      parts.push(`Framework: ${framework}`);
   if (gitBranch)      parts.push(`Branch: ${gitBranch}`);
 
-  console.log(`Session ${source}. ${parts.length ? parts.join(' | ') : 'No project info detected.'}`);
+  console.log(`Session ${source}. ${parts.length ? parts.join(' | ') : 'No project info detected.'}${updateNotice}`);
 
   // Compact warning — context compaction can lose pending approval state
   if (source === 'compact') {
@@ -155,6 +246,7 @@ try {
   }
 
   process.exit(0);
+  })(); // end async IIFE
 
 } catch (e) {
   try {