@gannonh/kata 0.1.0

package/commands/kata/whats-new.md

@@ -0,0 +1,124 @@
+---
+name: kata:whats-new
+description: See what's new in Kata since your installed version
+---
+
+<objective>
+Display changes between installed version and latest available version.
+
+Shows version comparison, changelog entries for missed versions, and update instructions.
+</objective>
+
+<process>
+
+<step name="get_installed_version">
+Read installed version from VERSION file:
+
+```bash
+cat ~/.claude/kata/VERSION 2>/dev/null
+```
+
+**If VERSION file missing:**
+```
+## Kata What's New
+
+**Installed version:** Unknown
+
+Your installation doesn't include version tracking.
+
+**To fix:** `npx @gannonh/kata --global`
+
+This will reinstall with version tracking enabled.
+```
+
+STOP here if no VERSION file.
+</step>
+
+<step name="fetch_remote_changelog">
+Fetch latest CHANGELOG.md from GitHub:
+
+Use WebFetch tool with:
+- URL: `https://raw.githubusercontent.com/gannonh/kata/main/CHANGELOG.md`
+- Prompt: "Extract all version entries with their dates and changes. Return in Keep-a-Changelog format."
+
+**If fetch fails:**
+Fall back to local changelog:
+```bash
+cat ~/.claude/kata/CHANGELOG.md 2>/dev/null
+```
+
+Note to user: "Couldn't check for updates (offline or GitHub unavailable). Showing local changelog."
+</step>
+
+<step name="parse_versions">
+From the remote (or local) changelog:
+
+1. **Extract latest version** - First `## [X.Y.Z]` line after `## [Unreleased]`
+2. **Compare with installed** - From VERSION file
+3. **Extract entries between** - All version sections from latest down to (but not including) installed
+
+**Version comparison:**
+- If installed == latest: "You're on the latest version"
+- If installed < latest: Show changes since installed version
+- If installed > latest: "You're ahead of latest release (development version?)"
+</step>
+
+<step name="display_output">
+Format output clearly:
+
+**If up to date:**
+```
+## Kata What's New
+
+**Installed:** 1.4.26
+**Latest:** 1.4.26
+
+You're on the latest version.
+
+[View full changelog](https://github.com/gannonh/kata/blob/main/CHANGELOG.md)
+```
+
+**If updates available:**
+```
+## Kata What's New
+
+**Installed:** 1.4.23
+**Latest:** 1.4.26
+
+---
+
+### Changes since your version:
+
+## [1.4.26] - 2026-01-20
+
+### Added
+- Feature X
+- Feature Y
+
+### Changed
+- **BREAKING:** Changed Z behavior
+
+## [1.4.25] - 2026-01-18
+
+### Fixed
+- Bug in feature A
+
+---
+
+[View full changelog](https://github.com/gannonh/kata/blob/main/CHANGELOG.md)
+
+**To update:** `npx @gannonh/kata --global`
+```
+
+**Breaking changes:** Surface prominently with **BREAKING:** prefix in the output.
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Installed version read from VERSION file
+- [ ] Remote changelog fetched (or graceful fallback to local)
+- [ ] Version comparison displayed clearly
+- [ ] Changes since installed version shown (if any)
+- [ ] Update instructions provided when behind
+</success_criteria>

package/hooks/kata-check-update.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+// Check for Kata updates in background, write result to cache
+// Called by SessionStart hook - runs once per session
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync, spawn } = require('child_process');
+
+const homeDir = os.homedir();
+const cacheDir = path.join(homeDir, '.claude', 'cache');
+const cacheFile = path.join(cacheDir, 'kata-update-check.json');
+const versionFile = path.join(homeDir, '.claude', 'kata', 'VERSION');
+
+// Ensure cache directory exists
+if (!fs.existsSync(cacheDir)) {
+  fs.mkdirSync(cacheDir, { recursive: true });
+}
+
+// Run check in background (spawn detached process)
+const child = spawn(process.execPath, ['-e', `
+  const fs = require('fs');
+  const { execSync } = require('child_process');
+
+  const cacheFile = ${JSON.stringify(cacheFile)};
+  const versionFile = ${JSON.stringify(versionFile)};
+
+  let installed = '0.0.0';
+  try {
+    installed = fs.readFileSync(versionFile, 'utf8').trim();
+  } catch (e) {}
+
+  let latest = null;
+  try {
+    latest = execSync('npm view @gannonh/kata version', { encoding: 'utf8', timeout: 10000 }).trim();
+  } catch (e) {}
+
+  const result = {
+    update_available: latest && installed !== latest,
+    installed,
+    latest: latest || 'unknown',
+    checked: Math.floor(Date.now() / 1000)
+  };
+
+  fs.writeFileSync(cacheFile, JSON.stringify(result));
+`], {
+  detached: true,
+  stdio: 'ignore'
+});
+
+child.unref();

package/hooks/statusline.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+// Claude Code Statusline - Kata Edition
+// Shows: model | current task | directory | context usage
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// Read JSON from stdin
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', chunk => input += chunk);
+process.stdin.on('end', () => {
+  try {
+    const data = JSON.parse(input);
+    const model = data.model?.display_name || 'Claude';
+    const dir = data.workspace?.current_dir || process.cwd();
+    const session = data.session_id || '';
+    const remaining = data.context_window?.remaining_percentage;
+
+    // Context window display (shows USED percentage)
+    let ctx = '';
+    if (remaining != null) {
+      const rem = Math.round(remaining);
+      const used = 100 - rem;
+
+      // Build progress bar (10 segments)
+      const filled = Math.floor(used / 10);
+      const bar = '█'.repeat(filled) + '░'.repeat(10 - filled);
+
+      // Color based on usage
+      if (used < 50) {
+        ctx = ` \x1b[32m${bar} ${used}%\x1b[0m`;
+      } else if (used < 65) {
+        ctx = ` \x1b[33m${bar} ${used}%\x1b[0m`;
+      } else if (used < 80) {
+        ctx = ` \x1b[38;5;208m${bar} ${used}%\x1b[0m`;
+      } else {
+        ctx = ` \x1b[5;31m💀 ${bar} ${used}%\x1b[0m`;
+      }
+    }
+
+    // Current task from todos
+    let task = '';
+    const homeDir = os.homedir();
+    const todosDir = path.join(homeDir, '.claude', 'todos');
+    if (session && fs.existsSync(todosDir)) {
+      const files = fs.readdirSync(todosDir)
+        .filter(f => f.startsWith(session) && f.includes('-agent-') && f.endsWith('.json'))
+        .map(f => ({ name: f, mtime: fs.statSync(path.join(todosDir, f)).mtime }))
+        .sort((a, b) => b.mtime - a.mtime);
+
+      if (files.length > 0) {
+        try {
+          const todos = JSON.parse(fs.readFileSync(path.join(todosDir, files[0].name), 'utf8'));
+          const inProgress = todos.find(t => t.status === 'in_progress');
+          if (inProgress) task = inProgress.activeForm || '';
+        } catch (e) {}
+      }
+    }
+
+    // Kata update available?
+    let kataUpdate = '';
+    const cacheFile = path.join(homeDir, '.claude', 'cache', 'kata-update-check.json');
+    if (fs.existsSync(cacheFile)) {
+      try {
+        const cache = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
+        if (cache.update_available) {
+          kataUpdate = '\x1b[33m⬆ /kata:update\x1b[0m │ ';
+        }
+      } catch (e) {}
+    }
+
+    // Output
+    const dirname = path.basename(dir);
+    if (task) {
+      process.stdout.write(`${kataUpdate}\x1b[2m${model}\x1b[0m │ \x1b[1m${task}\x1b[0m │ \x1b[2m${dirname}\x1b[0m${ctx}`);
+    } else {
+      process.stdout.write(`${kataUpdate}\x1b[2m${model}\x1b[0m │ \x1b[2m${dirname}\x1b[0m${ctx}`);
+    }
+  } catch (e) {
+    // Silent fail - don't break statusline on parse errors
+  }
+});