@haposoft/cafekit 0.8.12 → 0.8.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haposoft/cafekit",
-  "version": "0.8.12",
+  "version": "0.8.13",
   "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/hooks/docs-sync.cjs

@@ -15,13 +15,15 @@ try {
   const fs = require('fs');
   const path = require('path');
   const { execSync } = require('child_process');
+  const { loadConfig } = require('./lib/config.cjs');
 
   // Đọc stdin theo chuẩn hook
   const stdin = fs.readFileSync(0, 'utf8').trim();
   const payload = stdin ? JSON.parse(stdin) : {};
   const cwd = payload.cwd || process.cwd();
+  const config = loadConfig({ cwd, includeProject: false, includeAssertions: false, includeLocale: false });
 
-  const docsDir = path.join(cwd, 'docs');
+  const docsDir = path.join(cwd, config.paths?.docs || 'docs');
   
   // Xác định dự án đã có cốt lõi code hay chưa?
   const hasCode = fs.existsSync(path.join(cwd, 'src')) ||

package/src/claude/hooks/lib/color.cjs

@@ -16,14 +16,20 @@ const YELLOW = '\x1b[33m';
 const MAGENTA = '\x1b[35m';
 const CYAN = '\x1b[36m';
 
-// Detect color support at module load (cached)
-// Claude Code statusline runs via pipe but output displays in TTY - default to true
-const shouldUseColor = (() => {
+function detectColorDefault() {
   if (process.env.NO_COLOR) return false;
   if (process.env.FORCE_COLOR) return true;
   // Default true for statusline context (Claude Code handles TTY display)
   return true;
-})();
+}
+
+// Detect color support at module load (cached)
+// Claude Code statusline runs via pipe but output displays in TTY - default to true
+let shouldUseColor = detectColorDefault();
+
+function setColorEnabled(enabled) {
+  shouldUseColor = enabled === false ? false : detectColorDefault();
+}
 
 // Detect 256-color support via COLORTERM
 const has256Color = (() => {
@@ -90,6 +96,7 @@ module.exports = {
   dim,
   getContextColor,
   coloredBar,
-  shouldUseColor,
+  get shouldUseColor() { return shouldUseColor; },
+  setColorEnabled,
   has256Color
 };

package/src/claude/hooks/lib/config.cjs

@@ -9,11 +9,9 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
-const LOCAL_CONFIG_PATH = '.claude/.ck.json';
-const GLOBAL_CONFIG_PATH = path.join(os.homedir(), '.claude', '.ck.json');
+const RUNTIME_CONFIG_PATH = '.claude/runtime.json';
 
-// Legacy export for backward compatibility
-const CONFIG_PATH = LOCAL_CONFIG_PATH;
+const CONFIG_PATH = RUNTIME_CONFIG_PATH;
 
 const DEFAULT_CONFIG = {
   plan: {
@@ -61,6 +59,7 @@ const DEFAULT_CONFIG = {
   },
   assertions: [],
   statusline: 'full',
+  statuslineColors: true,
   hooks: {
     'session-init': true,
     'subagent-init': true,
@@ -81,8 +80,8 @@ const DEFAULT_CONFIG = {
  * Arrays are replaced entirely (not concatenated) to avoid duplicate entries
  *
  * IMPORTANT: Empty objects {} are treated as "inherit from parent", not "replace with empty".
- * This allows global config to set hooks.foo: false and have it persist even when
- * local config has hooks: {} (empty = inherit, not reset to defaults).
+ * This allows runtime config to leave hooks as {} (inherit defaults)
+ * without resetting all default hook toggles.
  *
  * @param {Object} target - Base object
  * @param {Object} source - Object to merge (takes precedence)
@@ -464,36 +463,39 @@ function sanitizeConfig(config, projectRoot) {
 }
 
 /**
- * Load config with cascading resolution: DEFAULT → global → local
+ * Load config with cascading resolution: DEFAULT → runtime
  *
  * Resolution order (each layer overrides the previous):
  *   1. DEFAULT_CONFIG (hardcoded defaults)
- *   2. Global config (~/.claude/.ck.json) - user preferences
- *   3. Local config (./.claude/.ck.json) - project-specific overrides
+ *   2. Runtime config (./.claude/runtime.json) - installed CafeKit runtime config
  *
  * @param {Object} options - Options for config loading
  * @param {boolean} options.includeProject - Include project section (default: true)
  * @param {boolean} options.includeAssertions - Include assertions (default: true)
  * @param {boolean} options.includeLocale - Include locale section (default: true)
+ * @param {string} options.cwd - Project root for local config lookup (default: process.cwd())
  */
 function loadConfig(options = {}) {
-  const { includeProject = true, includeAssertions = true, includeLocale = true } = options;
-  const projectRoot = process.cwd();
+  const {
+    includeProject = true,
+    includeAssertions = true,
+    includeLocale = true,
+    cwd = process.cwd()
+  } = options;
+  const projectRoot = cwd;
 
-  // Load configs from both locations
-  const globalConfig = loadConfigFromPath(GLOBAL_CONFIG_PATH);
-  const localConfig = loadConfigFromPath(LOCAL_CONFIG_PATH);
+  // Load config from the installed CafeKit runtime config.
+  const runtimeConfig = loadConfigFromPath(path.join(projectRoot, RUNTIME_CONFIG_PATH));
 
   // No config files found - use defaults
-  if (!globalConfig && !localConfig) {
+  if (!runtimeConfig) {
     return getDefaultConfig(includeProject, includeAssertions, includeLocale);
   }
 
   try {
-    // Deep merge: DEFAULT → global → local (local wins)
+    // Deep merge: DEFAULT → runtime (runtime wins)
     let merged = deepMerge({}, DEFAULT_CONFIG);
-    if (globalConfig) merged = deepMerge(merged, globalConfig);
-    if (localConfig) merged = deepMerge(merged, localConfig);
+    if (runtimeConfig) merged = deepMerge(merged, runtimeConfig);
 
     // Build result with optional sections
     const result = {
@@ -523,6 +525,7 @@ function loadConfig(options = {}) {
     result.hooks = merged.hooks || DEFAULT_CONFIG.hooks;
     // Statusline mode
     result.statusline = merged.statusline || 'full';
+    result.statuslineColors = merged.statuslineColors !== false;
 
     return sanitizeConfig(result, projectRoot);
   } catch (e) {
@@ -541,7 +544,8 @@ function getDefaultConfig(includeProject = true, includeAssertions = true, inclu
     codingLevel: -1,  // Default: disabled (no injection, saves tokens)
     skills: { ...DEFAULT_CONFIG.skills },
     hooks: { ...DEFAULT_CONFIG.hooks },
-    statusline: 'full'
+    statusline: 'full',
+    statuslineColors: true
   };
   if (includeLocale) {
     result.locale = { ...DEFAULT_CONFIG.locale };
@@ -790,8 +794,13 @@ function extractTaskListId(resolved) {
  * @param {string} hookName - Hook name (script basename without .cjs)
  * @returns {boolean} Whether hook is enabled
  */
-function isHookEnabled(hookName) {
-  const config = loadConfig({ includeProject: false, includeAssertions: false, includeLocale: false });
+function isHookEnabled(hookName, options = {}) {
+  const config = loadConfig({
+    includeProject: false,
+    includeAssertions: false,
+    includeLocale: false,
+    cwd: options.cwd
+  });
   const hooks = config.hooks || {};
   // Return true if undefined (default enabled), otherwise return the boolean value
   return hooks[hookName] !== false;
@@ -799,8 +808,7 @@ function isHookEnabled(hookName) {
 
 module.exports = {
   CONFIG_PATH,
-  LOCAL_CONFIG_PATH,
-  GLOBAL_CONFIG_PATH,
+  RUNTIME_CONFIG_PATH,
   DEFAULT_CONFIG,
   INVALID_FILENAME_CHARS,
   deepMerge,

package/src/claude/hooks/lib/skill-router-routes.cjs

@@ -27,8 +27,8 @@ const ROUTES = [
     negative: ['bug', 'debug', 'review', 'test only', 'commit'],
   }),
   route('hapo:test', 'test, verification, QA, or runtime validation', 70, {
-    strong: ['unit test', 'integration test', 'e2e', 'playwright', 'coverage', 'kiểm thử', 'kiem thu', '単体テスト', '結合テスト', 'カバレッジ', 'テストして'],
-    medium: ['test', 'tests', 'testing', 'qa', 'verify', 'verification', 'kiểm tra chạy', 'kiem tra chay', 'xác minh', 'xac minh', 'テスト', '検証', '確認', '動作確認'],
+    strong: ['unit test', 'integration test', 'e2e', 'playwright', 'coverage', 'test all', 'run all tests', 'test toàn bộ', 'test toan bo', 'kiểm thử', 'kiem thu', 'kiểm tra toàn bộ', 'kiem tra toan bo', '単体テスト', '結合テスト', '全体テスト', 'カバレッジ', 'テストして'],
+    medium: ['test', 'tests', 'testing', 'qa', 'verify', 'verification', 'kiểm tra chạy', 'kiem tra chay', 'xác minh', 'xac minh', 'テスト', '検証', '確認', '動作確認', '全体確認'],
     weak: ['assert', 'runtime proof', 'manual qa', 'end to end', 'smoke test', 'アサート', 'スモークテスト'],
     negative: ['spec', 'requirements', 'commit', 'push'],
   }),
@@ -45,8 +45,8 @@ const ROUTES = [
     negative: ['deploy', 'test', 'review only'],
   }),
   route('hapo:inspect', 'codebase discovery, file search, structure scan, or locating implementation areas', 64, {
-    strong: ['inspect', 'codebase scan', 'scan codebase', 'scan source', 'file discovery', 'find files', 'locate files', 'xem source', 'xem codebase', 'quét source', 'quet source', 'quét codebase', 'quet codebase', 'kiểm tra cấu trúc', 'kiem tra cau truc', 'コード構造', 'ソース確認', 'コードベース確認', 'ファイル探索', '構造を確認'],
-    medium: ['search files', 'find where', 'where is', 'project structure', 'code structure', 'repo structure', 'tìm file', 'tim file', 'tìm trong source', 'tim trong source', 'cấu trúc project', 'cau truc project', 'ở đâu', 'o dau', '関連ファイル', 'どこにある', 'プロジェクト構造', 'リポジトリ構造', '探して'],
+    strong: ['inspect', 'codebase scan', 'scan codebase', 'scan source', 'file discovery', 'find files', 'locate files', 'xem source', 'xem codebase', 'kiểm tra source', 'kiem tra source', 'kiểm tra source code', 'kiem tra source code', 'quét source', 'quet source', 'quét codebase', 'quet codebase', 'kiểm tra cấu trúc', 'kiem tra cau truc', 'コード構造', 'ソース確認', 'コードベース確認', 'ファイル探索', '構造を確認'],
+    medium: ['search files', 'find where', 'where is', 'project structure', 'code structure', 'repo structure', 'source code', 'tìm file', 'tim file', 'tìm trong source', 'tim trong source', 'cấu trúc project', 'cau truc project', 'ở đâu', 'o dau', 'nằm đâu', 'nam dau', '関連ファイル', 'どこにある', 'プロジェクト構造', 'リポジトリ構造', '探して'],
     weak: ['scan', 'inspect code', 'explore code', 'xem qua', 'xem giúp', '調べて', '確認して'],
     negative: ['bug', 'error', 'lỗi', 'loi', 'fail', 'failure', 'production', 'hotfix', 'fix', 'sửa', 'sua', 'debug', 'develop', 'implement', 'test', 'commit', 'push', 'slide', 'pptx'],
   }),
@@ -63,8 +63,8 @@ const ROUTES = [
     negative: ['backend', 'api', 'database'],
   }),
   route('hapo:react-best-practices', 'React and Next.js performance patterns, rerender optimization, and Vercel best practices', 60, {
-    strong: ['react best practices', 'next.js best practices', 'vercel react best practices', 'react performance', 'next.js performance', 'optimize react', 'optimize next.js', 'tối ưu react', 'toi uu react', 'tối ưu next.js', 'toi uu next.js', 'reactベストプラクティス', 'next.jsベストプラクティス', 'react最適化', 'next.js最適化', 'react性能'],
-    medium: ['bundle optimization', 'bundle size', 'rerender optimization', 're-render optimization', 'data fetching', 'server component', 'client component', 'suspense', 'hydration', 'waterfall', 'usememo', 'usecallback', 'react cache', 'tối ưu rerender', 'toi uu rerender', 'tối ưu bundle', 'toi uu bundle', 'バンドル最適化', '再レンダー最適化', 'データ取得', 'サーバーコンポーネント', 'クライアントコンポーネント', 'ハイドレーション'],
+    strong: ['react best practices', 'next.js best practices', 'vercel react best practices', 'react performance', 'next.js performance', 'optimize react', 'optimize next.js', 'rerender nhiều', 'rerender nhieu', 'nhiều rerender', 'nhieu rerender', 'tối ưu react', 'toi uu react', 'tối ưu next.js', 'toi uu next.js', 'reactベストプラクティス', 'next.jsベストプラクティス', 'react最適化', 'next.js最適化', 'react性能'],
+    medium: ['bundle optimization', 'bundle size', 'rerender optimization', 're-render optimization', 'data fetching', 'server component', 'client component', 'suspense', 'hydration', 'waterfall', 'usememo', 'usecallback', 'react cache', 'optimize', 'optimization', 'tối ưu', 'toi uu', 'tối ưu rerender', 'toi uu rerender', 'tối ưu bundle', 'toi uu bundle', 'バンドル最適化', '再レンダー最適化', '最適化', 'データ取得', 'サーバーコンポーネント', 'クライアントコンポーネント', 'ハイドレーション'],
     weak: ['react', 'next.js', 'memo', 'rerender', 're-render', 'render performance', 'component performance', 'waterfalls', 'lazy state', 'dynamic import', 'react pattern', 'next.js pattern', 'レンダー性能', 'コンポーネント性能', '動的インポート'],
     negative: ['backend', 'api', 'database', 'slide', 'pptx', 'commit', 'push'],
   }),
@@ -118,7 +118,7 @@ const ROUTES = [
   }),
   route('hapo:agent-browser', 'browser automation with snapshot refs, web interaction, recording, or Browserbase cloud browser workflows', 45, {
     strong: ['agent-browser', 'browser automation', 'web automation', 'browserbase', 'cloud browser', 'snapshot refs', 'browser snapshot', 'automate browser', 'tự động trình duyệt', 'tu dong trinh duyet', 'tự động thao tác trình duyệt', 'tu dong thao tac trinh duyet', 'ブラウザ自動化', 'クラウドブラウザ', 'ブラウザ操作', 'ブラウザスナップショット'],
-    medium: ['open url', 'navigate site', 'click in browser', 'fill form in browser', 'record browser', 'browser session', 'multi tab', 'browser test session', 'mở website', 'mo website', 'truy cập website', 'truy cap website', 'click trên web', 'click tren web', 'điền form web', 'dien form web', 'サイトを開く', 'ブラウザで開く', 'フォーム入力', 'クリック操作', '録画'],
+    medium: ['open url', 'navigate site', 'click in browser', 'fill form in browser', 'record browser', 'browser session', 'multi tab', 'browser test session', 'mở website', 'mo website', 'truy cập website', 'truy cap website', 'click trên web', 'click tren web', 'điền form web', 'dien form web', 'サイトを開く', 'ブラウザで開く', 'ブラウザで', 'フォーム入力', 'フォーム入力を自動化', '自動化して', 'クリック操作', '録画'],
     weak: ['click button', 'fill form', 'open site', 'web session', 'browser ref', 'viewport', 'cookies', 'localstorage', 'ボタンをクリック', 'ビューポート', 'クッキー'],
     negative: ['attached screenshot', 'ảnh đính kèm', 'anh dinh kem', '画像添付', 'source code', 'codebase', 'commit', 'push', 'pptx', 'pdf'],
   }),

package/src/claude/hooks/skill-router.cjs

@@ -38,13 +38,13 @@ try {
     return trimmed.startsWith('/') || /^hapo:[a-z-]+/i.test(trimmed);
   }
 
-  if (!isHookEnabled('skill-router')) process.exit(0);
-
   const stdin = fs.readFileSync(0, 'utf8').trim();
   if (!stdin) process.exit(0);
 
   const payload = JSON.parse(stdin);
+  const cwd = payload.cwd || process.cwd();
   const prompt = payload.prompt || '';
+  if (!isHookEnabled('skill-router', { cwd })) process.exit(0);
   if (!prompt || isExplicitCommand(prompt)) process.exit(0);
 
   const route = findRoute(prompt);

package/src/claude/hooks/usage.cjs

@@ -21,14 +21,15 @@ try {
   const os = require("os");
   const { execSync } = require("child_process");
 
-  // Check if usage tracking is disabled in runtime.json
-  try {
-    const runtimePath = path.join(process.cwd(), '.claude', 'runtime.json');
-    if (fs.existsSync(runtimePath)) {
-      const runtime = JSON.parse(fs.readFileSync(runtimePath, 'utf-8'));
-      if (runtime.usage?.enabled === false) process.exit(0);
-    }
-  } catch { /* fail-open */ }
+  function readRuntime(cwd) {
+    try {
+      const runtimePath = path.join(cwd, '.claude', 'runtime.json');
+      if (fs.existsSync(runtimePath)) {
+        return JSON.parse(fs.readFileSync(runtimePath, 'utf-8'));
+      }
+    } catch { /* fail-open */ }
+    return {};
+  }
 
 // Cache configuration
 const USAGE_CACHE_FILE = path.join(os.tmpdir(), "ck-usage-limits-cache.json");
@@ -151,6 +152,12 @@ async function main() {
 		} catch {}
 
 		const input = JSON.parse(inputStr || "{}");
+		const cwd = input.cwd || process.cwd();
+		const runtime = readRuntime(cwd);
+		if (runtime.usage?.enabled === false) {
+			console.log(JSON.stringify(result));
+			return;
+		}
 
 		// Detect hook type
 		const isUserPrompt = typeof input.prompt === "string";

package/src/claude/skills/ai-multimodal/SKILL.md

@@ -35,7 +35,7 @@ export GEMINI_API_KEY_2="key2"  # auto-rotates on rate limit
 
 **Verify setup**: `python scripts/check_setup.py`
 **Analyze media**: `python scripts/gemini_batch_process.py --files <file> --task <analyze|transcribe|extract>`
-  - TIP: When you're asked to analyze an image, check if `gemini` command is available, then use `echo "<prompt to analyze image>" | gemini -y -m <gemini.model>` command (read model from `$HOME/packages/spec/src/claude/.ck.json`: `gemini.model`). If `gemini` command is not available, use `python scripts/gemini_batch_process.py --files <file> --task analyze` command.
+  - TIP: When you're asked to analyze an image, check if `gemini` command is available, then use `echo "<prompt to analyze image>" | gemini -y -m <gemini.model>` command (read model from `.claude/runtime.json`: `gemini.model`). If `gemini` command is not available, use `python scripts/gemini_batch_process.py --files <file> --task analyze` command.
 
 > **Stdin support**: Pipe files via stdin for Gemini analysis (auto-detects PNG/JPG/PDF/WAV/MP3).
 

package/src/claude/status.cjs

@@ -14,7 +14,8 @@ const fs = require('fs');
 const path = require('path');
 
 // Import modular components
-const { green, yellow, red, cyan, magenta, dim, coloredBar, RESET, shouldUseColor } = require('./hooks/lib/color.cjs');
+const colors = require('./hooks/lib/color.cjs');
+const { green, yellow, red, cyan, magenta, dim, coloredBar, RESET } = colors;
 const { parseTranscript } = require('./hooks/lib/parser.cjs');
 const { countConfigs } = require('./hooks/lib/counter.cjs');
 const { loadConfig } = require('./hooks/lib/config.cjs');
@@ -358,7 +359,7 @@ function render(ctx, singleLineMode = false) {
 
   // Output all lines with non-breaking spaces for alignment
   for (const line of lines) {
-    const outputLine = shouldUseColor ? `${RESET}${line.replace(/ /g, '\u00A0')}` : line;
+    const outputLine = colors.shouldUseColor ? `${RESET}${line.replace(/ /g, '\u00A0')}` : line;
     console.log(outputLine);
   }
 }
@@ -509,6 +510,7 @@ async function main() {
     // Load config and get statusline mode
     const config = loadConfig({ includeProject: false, includeAssertions: false, includeLocale: false });
     const statuslineMode = config.statusline || 'full';
+    colors.setColorEnabled(config.statuslineColors !== false);
 
     // Render based on mode
     switch (statuslineMode) {