@ngockhoale/ukit 1.1.6

package/templates/.claude/hooks/compress-output.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# PostToolUse hook: compress noisy Bash output into a compact runtime summary.
+
+if [ -n "${CLAUDE_PROJECT_DIR}" ] && [ -d "${CLAUDE_PROJECT_DIR}" ]; then
+  cd "${CLAUDE_PROJECT_DIR}"
+fi
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SCRIPT_PATH="$HOOK_DIR/../ukit/runtime/output-compression.mjs"
+
+if [ -f "$SCRIPT_PATH" ]; then
+  INPUT="$(cat)"
+  printf '%s' "$INPUT" | node "$SCRIPT_PATH"
+  exit $?
+fi
+
+exit 0

package/templates/.claude/hooks/protect-files.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+# PreToolUse hook: Block edits to sensitive/protected files
+# Matched on: Edit|Write
+
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+
+if [ -z "$FILE_PATH" ]; then
+  exit 0
+fi
+
+BASENAME=$(basename "$FILE_PATH")
+
+# Allow .env.example explicitly
+if [[ "$BASENAME" == ".env.example" ]]; then
+  exit 0
+fi
+
+PROTECTED_PATTERNS=(
+  ".env"
+  ".env.local"
+  ".env.production"
+  "package-lock.json"
+  "yarn.lock"
+  ".git/"
+  "node_modules/"
+  ".claude/settings.local.json"
+)
+
+for pattern in "${PROTECTED_PATTERNS[@]}"; do
+  if [[ "$FILE_PATH" == *"$pattern"* ]]; then
+    echo "BLOCKED: Cannot modify '$FILE_PATH' — matches protected pattern '$pattern'. Ask the user to modify this file manually." >&2
+    exit 2
+  fi
+done
+
+exit 0

package/templates/.claude/hooks/reinject-context.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# PreCompact hook: re-inject compact critical context before Claude compaction.
+# Reads .claude/ukit/skill-router-state.json and surfaces compact hints such as Recent routed lane / policy=.
+
+if [ -n "${CLAUDE_PROJECT_DIR}" ] && [ -d "${CLAUDE_PROJECT_DIR}" ]; then
+  cd "${CLAUDE_PROJECT_DIR}"
+fi
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+SCRIPT_PATH="$HOOK_DIR/../ukit/runtime/reinject-context.mjs"
+
+if [ -f "$SCRIPT_PATH" ]; then
+  node "$SCRIPT_PATH"
+  exit $?
+fi
+
+cat <<'FALLBACK'
+=== PROJECT CONTEXT (post-compaction) ===
+- Trivial: act directly; no doc reads.
+- Simple: read docs/MEMORY.md; use context resolver for related files.
+- Non-trivial: read docs/MEMORY.md + docs/PROJECT.md + docs/CODE_MAP.md.
+- WORKLOG: read only for continuation/debugging.
+- Auto-activate matching project-local skills from prompt + tool/file signals.
+- Reuse existing code. Use yarn. Run tests after code changes.
+- Scope-based verification: match verify effort to change scope.
+- If broad verification gets blocked by a Claude hook, follow the routed targeted order or ask for explicit full-suite confirmation.
+=== END ===
+FALLBACK

package/templates/.claude/hooks/session-start.md

@@ -0,0 +1,13 @@
+# Session Start
+- Project: {{ project.name }} | Stack: {{ project.stack }} | PM: {{ runtime.packageManager }}
+- Trivial (typo, màu, label, rename) → làm ngay, không overhead.
+- Simple → đọc `docs/MEMORY.md` (constraints + known bugs) là đủ.
+- Non-trivial → đọc `docs/MEMORY.md` + `docs/PROJECT.md` + `docs/CODE_MAP.md`; WORKLOG chỉ đọc phần gần đây khi cần.
+- Trước khi hỏi user nhắc lại quyết định cũ cho task non-trivial, chạy `ukit memory recall "<task hiện tại>"`; nếu block `## Previous Context` liên quan xuất hiện thì reuse trước.
+- Routing by natural language: lỗi/bug/crash → fix flow | tính năng/thêm/tạo → build flow | review/kiểm tra → review flow | test/kiểm thử → test flow | ý tưởng/thiết kế → brainstorm flow.
+- Auto-activate matching project-local skills from prompt + tool/file signals; end users should not need to know skill names.
+- After routing skill + context, prefer verification derived from related tests/context bundle before broad test runs.
+- Follow routed verification policy: auto-run targeted checks when localized, widen in order for shared/risky scope, and ask before blanket broad runs when no related test evidence exists.
+- If Claude blocks a broad verification command, do not fight the hook blindly — use the targeted indexed lane first or get explicit confirmation for a full-suite run.
+- Nếu mơ hồ hoặc risk cao (security/migration/auth/data-loss/uninstall-core), escalate đọc sâu hơn hoặc hỏi 1 câu clarify ngắn.
+- Docs là navigation aid, source code là ground truth. Nếu mâu thuẫn → source thắng, update docs trước khi tiếp tục.