@ngxtm/devkit 2.1.0 → 3.0.0

package/statusline.ps1

@@ -1,307 +0,0 @@
-#Requires -Version 5.1
-# Custom Claude Code statusline for PowerShell
-# Cross-platform support: Windows PowerShell 5.1+, PowerShell Core 7+
-# Theme: detailed | Features: directory, git, model, usage, session, tokens
-#
-# Context Window Calculation:
-# - 100% = compaction threshold (not model limit)
-# - Self-calibrates via PreCompact hook
-# - Falls back to smart defaults based on window size
-
-# Set UTF-8 encoding
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-$OutputEncoding = [System.Text.Encoding]::UTF8
-
-# Calibration file path (now in ck/ namespace - fixes #178)
-$CalibrationPath = Join-Path (Join-Path $env:TEMP "ck") "calibration.json"
-
-# Time conversion functions
-function ConvertTo-Epoch {
-    param([string]$Timestamp)
-
-    try {
-        $dt = [DateTime]::Parse($Timestamp).ToUniversalTime()
-        $epoch = [DateTimeOffset]::new($dt).ToUnixTimeSeconds()
-        return $epoch
-    }
-    catch {
-        return 0
-    }
-}
-
-function Format-TimeHM {
-    param([long]$Epoch)
-
-    try {
-        $dt = [DateTimeOffset]::FromUnixTimeSeconds($Epoch).LocalDateTime
-        return $dt.ToString("HH:mm")
-    }
-    catch {
-        return "00:00"
-    }
-}
-
-# Get smart default compact threshold based on context window size
-# Research-based defaults:
-# - 200k window: ~80% (160k) - confirmed from GitHub issues
-# - 500k window: ~60% (300k) - estimated
-# - 1M window: ~33% (330k) - derived from user observations
-function Get-DefaultCompactThreshold {
-    param([int]$ContextWindowSize)
-
-    # Known thresholds (autocompact buffer = 22.5% for 200k)
-    $KnownThresholds = @{
-        200000 = 155000   # 77.5% - confirmed via /context
-        1000000 = 330000  # 33% - 1M beta window
-    }
-
-    # Exact match
-    if ($KnownThresholds.ContainsKey($ContextWindowSize)) {
-        return $KnownThresholds[$ContextWindowSize]
-    }
-
-    # Tiered defaults based on window size
-    if ($ContextWindowSize -ge 1000000) {
-        return [Math]::Floor($ContextWindowSize * 0.33)
-    }
-    else {
-        # Default: ~77.5% for standard windows (200k confirmed)
-        return [Math]::Floor($ContextWindowSize * 0.775)
-    }
-}
-
-# Read calibrated threshold from file if available
-function Get-CompactThreshold {
-    param([int]$ContextWindowSize)
-
-    # Try to read calibration file
-    if (Test-Path $CalibrationPath) {
-        try {
-            $calibration = Get-Content $CalibrationPath -Raw | ConvertFrom-Json
-            $key = [string]$ContextWindowSize
-            if ($calibration.$key -and $calibration.$key.threshold -gt 0) {
-                return [int]$calibration.$key.threshold
-            }
-        }
-        catch {
-            # Silent fail - use defaults
-        }
-    }
-
-    # Fall back to smart defaults
-    return Get-DefaultCompactThreshold $ContextWindowSize
-}
-
-function Get-ProgressBar {
-    param(
-        [int]$Percent = 0,
-        [int]$Width = 12
-    )
-
-    if ($Percent -lt 0) { $Percent = 0 }
-    if ($Percent -gt 100) { $Percent = 100 }
-
-    $filled = [Math]::Round($Percent * $Width / 100)
-    $empty = $Width - $filled
-
-    # ▰ (U+25B0) filled, ▱ (U+25B1) empty - smooth horizontal rectangles
-    $bar = ("▰" * $filled) + ("▱" * $empty)
-    return $bar
-}
-
-# Get severity emoji based on percentage (no color codes)
-function Get-SeverityEmoji {
-    param([int]$Percent)
-
-    if ($Percent -ge 90) {
-        return "🔴"      # Critical
-    }
-    elseif ($Percent -ge 70) {
-        return "🟡"      # Warning
-    }
-    else {
-        return "🟢"      # Healthy
-    }
-}
-
-# Read JSON from stdin
-try {
-    $inputLines = @()
-    while ($null -ne ($line = [Console]::In.ReadLine())) {
-        $inputLines += $line
-    }
-    $inputJson = $inputLines -join "`n"
-
-    if ([string]::IsNullOrWhiteSpace($inputJson)) {
-        Write-Error "No input provided"
-        exit 1
-    }
-
-    $data = $inputJson | ConvertFrom-Json
-}
-catch {
-    Write-Error "Failed to parse JSON input: $_"
-    exit 1
-}
-
-# Extract basic information
-$currentDir = "unknown"
-if ($data.workspace.current_dir) {
-    $currentDir = $data.workspace.current_dir
-}
-elseif ($data.cwd) {
-    $currentDir = $data.cwd
-}
-
-# Replace home directory with ~
-$homeDir = $env:USERPROFILE
-if (-not $homeDir) {
-    $homeDir = $env:HOME
-}
-if ($homeDir -and $currentDir.StartsWith($homeDir)) {
-    $currentDir = $currentDir.Replace($homeDir, "~")
-}
-
-$modelName = "Claude"
-if ($data.model.display_name) {
-    $modelName = $data.model.display_name
-}
-
-$modelVersion = ""
-if ($data.model.version -and $data.model.version -ne "null") {
-    $modelVersion = $data.model.version
-}
-
-# Git branch detection
-$gitBranch = ""
-try {
-    $null = git rev-parse --git-dir 2>$null
-    if ($LASTEXITCODE -eq 0) {
-        $gitBranch = git branch --show-current 2>$null
-        if ([string]::IsNullOrWhiteSpace($gitBranch)) {
-            $gitBranch = git rev-parse --short HEAD 2>$null
-        }
-    }
-}
-catch {
-    # Not in a git repository
-}
-
-# Context window usage (Claude Code v2.0.65+)
-# Calculate percentage against COMPACT THRESHOLD, not model limit
-# 100% = compaction imminent
-$contextPercent = 0
-$contextText = ""
-
-$contextInput = 0
-$contextOutput = 0
-$contextSize = 0
-
-if ($data.context_window) {
-    $contextInput = [int]($data.context_window.total_input_tokens ?? 0)
-    $contextOutput = [int]($data.context_window.total_output_tokens ?? 0)
-    $contextSize = [int]($data.context_window.context_window_size ?? 0)
-}
-
-if ($contextSize -gt 0) {
-    $contextTotal = $contextInput + $contextOutput
-    $compactThreshold = Get-CompactThreshold $contextSize
-
-    # Calculate percentage against compact threshold
-    $contextPercent = [Math]::Floor($contextTotal * 100 / $compactThreshold)
-    # Clamp to 100% max to handle edge cases
-    if ($contextPercent -gt 100) { $contextPercent = 100 }
-
-    # Get severity emoji and progress bar
-    $severityEmoji = Get-SeverityEmoji $contextPercent
-    $bar = Get-ProgressBar $contextPercent 12
-    $contextText = "$severityEmoji $bar ${contextPercent}%"
-}
-
-# Session timer
-$sessionText = ""
-
-try {
-    # Try npx first, then ccusage
-    $blocksOutput = $null
-    try {
-        $blocksOutput = npx ccusage@latest blocks --json 2>$null
-    }
-    catch {
-        try {
-            $blocksOutput = ccusage blocks --json 2>$null
-        }
-        catch {
-            # ccusage not available
-        }
-    }
-
-    if ($blocksOutput) {
-        $blocks = $blocksOutput | ConvertFrom-Json
-        $activeBlock = $blocks.blocks | Where-Object { $_.isActive -eq $true } | Select-Object -First 1
-
-        if ($activeBlock) {
-            # Session time calculation
-            $resetTimeStr = $activeBlock.usageLimitResetTime
-            if (-not $resetTimeStr) {
-                $resetTimeStr = $activeBlock.endTime
-            }
-            $startTimeStr = $activeBlock.startTime
-
-            if ($resetTimeStr -and $startTimeStr) {
-                $startSec = ConvertTo-Epoch $startTimeStr
-                $endSec = ConvertTo-Epoch $resetTimeStr
-                $nowSec = [DateTimeOffset]::UtcNow.ToUnixTimeSeconds()
-
-                $total = $endSec - $startSec
-                if ($total -lt 1) { $total = 1 }
-
-                $elapsed = $nowSec - $startSec
-                if ($elapsed -lt 0) { $elapsed = 0 }
-                if ($elapsed -gt $total) { $elapsed = $total }
-
-                $remaining = $endSec - $nowSec
-                if ($remaining -lt 0) { $remaining = 0 }
-
-                if ($remaining -gt 0 -and $remaining -lt 18000) {
-                    $rh = [Math]::Floor($remaining / 3600)
-                    $rm = [Math]::Floor(($remaining % 3600) / 60)
-                    $endHM = Format-TimeHM $endSec
-                    $sessionText = "${rh}h ${rm}m until reset at ${endHM}"
-                }
-            }
-        }
-    }
-}
-catch {
-    # Silent fail - ccusage not available
-}
-
-# Render statusline (no ANSI colors - emoji only)
-$output = ""
-$output += "📁 ${currentDir}"
-
-# Git branch
-if ($gitBranch) {
-    $output += "  🌿 ${gitBranch}"
-}
-
-# Model
-$output += "  🤖 ${modelName}"
-
-# Model version
-if ($modelVersion) {
-    $output += " ${modelVersion}"
-}
-
-# Session time
-if ($sessionText) {
-    $output += "  ⌛ ${sessionText}"
-}
-
-# Context window usage (Claude Code v2.0.65+)
-if ($contextText) {
-    $output += "  $contextText"
-}
-
-Write-Host $output

package/statusline.sh

@@ -1,237 +0,0 @@
-#!/bin/bash
-# Custom Claude Code statusline for Bash
-# Cross-platform support: macOS, Linux
-# Theme: detailed | Features: directory, git, model, usage, session, tokens
-#
-# Context Window Calculation:
-# - 100% = compaction threshold (not model limit)
-# - Self-calibrates via PreCompact hook
-# - Falls back to smart defaults based on window size
-
-input=$(cat)
-
-# Calibration file path (now in /tmp/ck/ namespace - fixes #178)
-CALIBRATION_PATH="${TMPDIR:-/tmp}/ck/calibration.json"
-
-# ---- time helpers ----
-to_epoch() {
-  ts="$1"
-  if command -v gdate >/dev/null 2>&1; then gdate -d "$ts" +%s 2>/dev/null && return; fi
-  date -u -j -f "%Y-%m-%dT%H:%M:%S%z" "${ts/Z/+0000}" +%s 2>/dev/null && return
-  python3 - "$ts" <<'PY' 2>/dev/null
-import sys, datetime
-s=sys.argv[1].replace('Z','+00:00')
-print(int(datetime.datetime.fromisoformat(s).timestamp()))
-PY
-}
-
-fmt_time_hm() {
-  epoch="$1"
-  if date -r 0 +%s >/dev/null 2>&1; then date -r "$epoch" +"%H:%M"; else date -d "@$epoch" +"%H:%M"; fi
-}
-
-# ---- compact threshold calculation ----
-# Get smart default compact threshold based on context window size
-# Research-based defaults:
-# - 200k window: ~80% (160k) - confirmed from GitHub issues
-# - 500k window: ~60% (300k) - estimated
-# - 1M window: ~33% (330k) - derived from user observations
-get_default_compact_threshold() {
-  local context_size="$1"
-
-  # Known thresholds (autocompact buffer = 22.5% for 200k)
-  case "$context_size" in
-    200000) echo 155000; return ;;  # 77.5% - confirmed via /context
-    1000000) echo 330000; return ;; # 33% - 1M beta window
-  esac
-
-  # Tiered defaults based on window size
-  if [ "$context_size" -ge 1000000 ] 2>/dev/null; then
-    echo $((context_size * 33 / 100))
-  else
-    # Default: ~77.5% for standard windows (200k confirmed)
-    echo $((context_size * 775 / 1000))
-  fi
-}
-
-# Read calibrated threshold from file if available
-get_compact_threshold() {
-  local context_size="$1"
-
-  # Try to read calibration file
-  if [ -f "$CALIBRATION_PATH" ] && command -v jq >/dev/null 2>&1; then
-    local calibrated
-    calibrated=$(jq -r --arg key "$context_size" '.[$key].threshold // empty' "$CALIBRATION_PATH" 2>/dev/null)
-    if [ -n "$calibrated" ] && [ "$calibrated" -gt 0 ] 2>/dev/null; then
-      echo "$calibrated"
-      return
-    fi
-  fi
-
-  # Fall back to smart defaults
-  get_default_compact_threshold "$context_size"
-}
-
-# ---- progress bar ----
-progress_bar() {
-  pct="${1:-0}"; width="${2:-12}"
-  [[ "$pct" =~ ^[0-9]+$ ]] || pct=0; ((pct<0))&&pct=0; ((pct>100))&&pct=100
-  filled=$(( pct * width / 100 )); empty=$(( width - filled ))
-  # ▰ (U+25B0) filled, ▱ (U+25B1) empty - smooth horizontal rectangles
-  for ((i=0; i<filled; i++)); do printf '▰'; done
-  for ((i=0; i<empty; i++)); do printf '▱'; done
-}
-
-# ---- severity emoji (no colors) ----
-get_severity_emoji() {
-  local pct="$1"
-  if [ "$pct" -ge 90 ] 2>/dev/null; then
-    echo "🔴"      # Critical
-  elif [ "$pct" -ge 70 ] 2>/dev/null; then
-    echo "🟡"      # Warning
-  else
-    echo "🟢"      # Healthy
-  fi
-}
-
-# git utilities
-num_or_zero() { v="$1"; [[ "$v" =~ ^[0-9]+$ ]] && echo "$v" || echo 0; }
-
-# ---- git (detect early for fallback mode) ----
-git_branch=""
-if git rev-parse --git-dir >/dev/null 2>&1; then
-  git_branch=$(git branch --show-current 2>/dev/null || git rev-parse --short HEAD 2>/dev/null)
-fi
-
-# ---- basics ----
-if command -v jq >/dev/null 2>&1; then
-  current_dir=$(echo "$input" | jq -r '.workspace.current_dir // .cwd // "unknown"' 2>/dev/null | sed "s|^$HOME|~|g")
-  model_name=$(echo "$input" | jq -r '.model.display_name // "Claude"' 2>/dev/null)
-  model_version=$(echo "$input" | jq -r '.model.version // ""' 2>/dev/null)
-else
-  # Fallback: Extract basic info without jq using grep/sed
-  current_dir=$(echo "$input" | grep -o '"current_dir"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*:.*"\([^"]*\)".*/\1/' | sed "s|^$HOME|~|g")
-  [ -z "$current_dir" ] && current_dir=$(pwd | sed "s|^$HOME|~|g")
-  model_name=$(echo "$input" | grep -o '"display_name"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*:.*"\([^"]*\)".*/\1/')
-  [ -z "$model_name" ] && model_name="Claude"
-  model_version=""
-  # Render minimal statusline without jq and exit
-  printf '📁 %s' "$current_dir"
-  if [ -n "$git_branch" ]; then
-    printf '  🌿 %s' "$git_branch"
-  fi
-  printf '  🤖 %s' "$model_name"
-  printf '\n'
-  exit 0
-fi
-
-# ---- Native Claude Code data integration ----
-session_txt=""
-cost_usd=""; lines_added=0; lines_removed=0
-context_pct=0; context_txt=""
-BILLING_MODE="${CLAUDE_BILLING_MODE:-api}"
-
-# Extract native cost data from Claude Code
-cost_usd=$(echo "$input" | jq -r '.cost.total_cost_usd // empty' 2>/dev/null)
-lines_added=$(echo "$input" | jq -r '.cost.total_lines_added // 0' 2>/dev/null)
-lines_removed=$(echo "$input" | jq -r '.cost.total_lines_removed // 0' 2>/dev/null)
-
-# Extract context window usage (Claude Code v2.0.65+)
-# Calculate percentage against COMPACT THRESHOLD, not model limit
-# 100% = compaction imminent
-context_input=$(echo "$input" | jq -r '.context_window.total_input_tokens // 0' 2>/dev/null)
-context_output=$(echo "$input" | jq -r '.context_window.total_output_tokens // 0' 2>/dev/null)
-context_size=$(echo "$input" | jq -r '.context_window.context_window_size // 0' 2>/dev/null)
-
-if [ -n "$context_size" ] && [ "$context_size" -gt 0 ] 2>/dev/null; then
-  context_total=$((context_input + context_output))
-  compact_threshold=$(get_compact_threshold "$context_size")
-
-  # Calculate percentage against compact threshold
-  context_pct=$((context_total * 100 / compact_threshold))
-  # Clamp to 100% max to handle edge cases
-  ((context_pct > 100)) && context_pct=100
-
-  # Get severity emoji and progress bar
-  severity_emoji=$(get_severity_emoji "$context_pct")
-  bar=$(progress_bar "$context_pct" 12)
-  context_txt="${severity_emoji} ${bar} ${context_pct}%"
-fi
-
-# Session timer - parse local transcript JSONL (zero external dependencies)
-transcript_path=$(echo "$input" | jq -r '.transcript_path // empty' 2>/dev/null)
-
-if [ -n "$transcript_path" ] && [ -f "$transcript_path" ]; then
-  # Get first API call timestamp from session JSONL
-  first_api_call=$(grep -m1 '"usage"' "$transcript_path" 2>/dev/null | jq -r '.timestamp // empty' 2>/dev/null)
-
-  if [ -n "$first_api_call" ]; then
-    # Calculate 5-hour billing block (Anthropic windows)
-    # Blocks: 00:00-05:00, 05:00-10:00, 10:00-15:00, 15:00-20:00, 20:00-01:00 UTC
-    current_utc_hour=$(date -u +%H)
-    block_start=$((10#$current_utc_hour / 5 * 5))
-    block_end=$((block_start + 5))
-
-    # Handle day wraparound (e.g., 20:00 UTC block ends at 01:00 UTC next day)
-    if [ $block_end -ge 24 ]; then
-      block_end=$((block_end - 24))
-      block_end_date="tomorrow"
-    else
-      block_end_date="today"
-    fi
-
-    # Calculate remaining time until block reset
-    now_sec=$(date +%s)
-    block_end_sec=$(date -u -d "${block_end_date} ${block_end}:00 UTC" +%s 2>/dev/null)
-
-    if [ -n "$block_end_sec" ] && [ "$block_end_sec" -gt 0 ]; then
-      remaining=$((block_end_sec - now_sec))
-
-      if [ $remaining -gt 0 ] && [ $remaining -lt 18000 ]; then
-        rh=$((remaining / 3600))
-        rm=$(((remaining % 3600) / 60))
-        block_end_local=$(date -d "@${block_end_sec}" +"%H:%M" 2>/dev/null)
-        session_txt="${rh}h ${rm}m until reset at ${block_end_local}"
-      fi
-    fi
-  fi
-fi
-
-# ---- render statusline (no ANSI colors - emoji only) ----
-printf '📁 %s' "$current_dir"
-
-# git display
-if [ -n "$git_branch" ]; then
-  printf '  🌿 %s' "$git_branch"
-fi
-
-printf '  🤖 %s' "$model_name"
-
-if [ -n "$model_version" ] && [ "$model_version" != "null" ]; then
-  printf ' %s' "$model_version"
-fi
-
-# session time
-if [ -n "$session_txt" ]; then
-  printf '  ⌛ %s' "$session_txt"
-fi
-
-# cost (only show for API billing mode)
-if [ "$BILLING_MODE" = "api" ] && [ -n "$cost_usd" ] && [[ "$cost_usd" =~ ^[0-9.]+$ ]]; then
-  printf '  💵 $%.4f' "$cost_usd"
-fi
-
-# lines changed
-if [ -n "$lines_added" ] && [ -n "$lines_removed" ] && [[ "$lines_added" =~ ^[0-9]+$ ]] && [[ "$lines_removed" =~ ^[0-9]+$ ]]; then
-  if [ "$lines_added" -gt 0 ] || [ "$lines_removed" -gt 0 ]; then
-    printf '  📝 +%d -%d' "$lines_added" "$lines_removed"
-  fi
-fi
-
-# context window usage (Claude Code v2.0.65+)
-if [ -n "$context_txt" ]; then
-  printf '  %s' "$context_txt"
-fi
-
-# trailing newline (POSIX compliance)
-printf '\n'

package/workflows/development-rules.md

@@ -1,42 +0,0 @@
-# Development Rules
-
-**IMPORTANT:** Analyze the skills catalog and activate the skills that are needed for the task during the process.
-**IMPORTANT:** You ALWAYS follow these principles: **YAGNI (You Aren't Gonna Need It) - KISS (Keep It Simple, Stupid) - DRY (Don't Repeat Yourself)**
-
-## General
-- **File Naming**: Use kebab-case for file names with a meaningful name that describes the purpose of the file, doesn't matter if the file name is long, just make sure when LLMs read the file names while using Grep or other tools, they can understand the purpose of the file right away without reading the file content.
-- **File Size Management**: Keep individual code files under 200 lines for optimal context management
-  - Split large files into smaller, focused components/modules
-  - Use composition over inheritance for complex widgets
-  - Extract utility functions into separate modules
-  - Create dedicated service classes for business logic
-- When looking for docs, activate `docs-seeker` skill (`context7` reference) for exploring latest docs.
-- Use `gh` bash command to interact with Github features if needed
-- Use `psql` bash command to query Postgres database for debugging if needed
-- Use `ai-multimodal` skill for describing details of images, videos, documents, etc. if needed
-- Use `ai-multimodal` skill and `imagemagick` skill for generating and editing images, videos, documents, etc. if needed
-- Use `sequential-thinking` and `debugging` skills for sequential thinking, analyzing code, debugging, etc. if needed
-- **[IMPORTANT]** Follow the codebase structure and code standards in `./docs` during implementation.
-- **[IMPORTANT]** Do not just simulate the implementation or mocking them, always implement the real code.
-
-## Code Quality Guidelines
-- Read and follow codebase structure and code standards in `./docs`
-- Don't be too harsh on code linting, but **make sure there are no syntax errors and code are compilable**
-- Prioritize functionality and readability over strict style enforcement and code formatting
-- Use reasonable code quality standards that enhance developer productivity
-- Use try catch error handling & cover security standards
-- Use `code-reviewer` agent to review code after every implementation
-
-## Pre-commit/Push Rules
-- Run linting before commit
-- Run tests before push (DO NOT ignore failed tests just to pass the build or github actions)
-- Keep commits focused on the actual code changes
-- **DO NOT** commit and push any confidential information (such as dotenv files, API keys, database credentials, etc.) to git repository!
-- Create clean, professional commit messages without AI references. Use conventional commit format.
-
-## Code Implementation
-- Write clean, readable, and maintainable code
-- Follow established architectural patterns
-- Implement features according to specifications
-- Handle edge cases and error scenarios
-- **DO NOT** create new enhanced files, update to the existing files directly.