jira-report-tui 1.0.7 → 1.0.10

package/README.md

@@ -114,6 +114,7 @@ Location: /home/user/.jira-daily-report.json
 ✅ **Worklog Enrichment** - Shows task details with time logged
 ✅ **Dark Theme** - Beautiful terminal UI
 ✅ **Single Binary** - No dependencies
+✅ **Smart Caching** - Instant startup with cached data (enabled by default)
 
 ---
 
@@ -126,15 +127,34 @@ Location: `~/.jira-daily-report.json`
   "jiraServer": "https://your-domain.atlassian.net",
   "username": "you@example.com",
   "apiToken": "your-jira-api-token",
-  "tempoApiToken": "your-tempo-api-token",
+  "tempoApiToken": "your-tempo-token",
   "whoAmI": "your-account-id",
   "autoClipboard": false,
-  "theme": "dark"
+  "theme": "dark",
+  "cacheEnabled": true,
+  "cacheTTL": 60
 }
 ```
 
 **Security**: File permissions are set to `0600` (owner read/write only)
 
+### Cache Configuration
+
+- **`cacheEnabled`**: Enable/disable caching (default: `true`)
+- **`cacheTTL`**: Cache time-to-live in minutes (default: `60`)
+- **Cache file**: `~/.jira-daily-report-cache.json` (auto-managed)
+
+**Environment Variables:**
+```bash
+export JIRA_CACHE_ENABLED=true   # Enable/disable cache
+export JIRA_CACHE_TTL=60          # Cache TTL in minutes
+```
+
+**How it works:**
+1. First launch: Fetches fresh data from APIs (~500ms)
+2. Subsequent launches: Shows cached data instantly (~50ms), then refreshes in background
+3. Cache indicator: Shows `📦 Xm old` in status bar when using cached data
+
 ---
 
 ## Install
@@ -156,11 +176,16 @@ cd go-tui
 
 ## Performance
 
-| Metric | TypeScript | Go | Improvement |
-|--------|-----------|-----|-------------|
-| Startup | ~500ms | **~50ms** | **10x faster** |
-| Navigation | ~200ms | **<10ms** | **20x faster** |
-| Memory | ~100MB | **~20MB** | **5x less** |
+| Metric | TypeScript | Go (Cold Start) | Go (Cached) | Best Improvement |
+|--------|-----------|-----------------|-------------|------------------|
+| Startup | ~500ms | ~500ms | **~50ms** | **10x faster** |
+| Navigation | ~200ms | **<10ms** | **<10ms** | **20x faster** |
+| Memory | ~100MB | **~20MB** | **~20MB** | **5x less** |
+
+**Cache Performance:**
+- ⚡ **First launch**: ~500ms (fetches from API)
+- 🚀 **Cached launch**: ~50ms (10x faster)
+- 🔄 **Background refresh**: Data updates seamlessly without blocking UI
 
 ---
 

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "jira-report-tui",
-  "version": "1.0.7",
+  "version": "1.0.10",
   "description": "Fast, performant terminal interface for managing Jira tasks and logging time to Tempo - 20x faster than TypeScript version",
   "main": "index.js",
   "bin": {
-    "jira-report": "cli.js"
+    "jira-report-tui": "cli.js"
   },
   "scripts": {
     "build": "./build-all.sh",
@@ -39,7 +39,9 @@
     "node": ">=14.0.0"
   },
   "os": [
-    "linux"
+    "linux",
+    "darwin",
+    "win32"
   ],
   "cpu": [
     "x64",

package/test-cache.sh

@@ -0,0 +1,107 @@
+#!/bin/bash
+
+set -e
+
+CACHE_FILE="$HOME/.jira-daily-report-cache.json"
+BINARY="./bin/jira-report"
+
+echo "🧪 Testing Cache Functionality"
+echo "================================"
+echo ""
+
+echo "1️⃣  Testing Cold Start (No Cache)"
+echo "-----------------------------------"
+rm -f "$CACHE_FILE"
+echo "Cache file removed: $CACHE_FILE"
+echo "Expected: App should load fresh data from API"
+echo "Run: $BINARY tui"
+echo "Press Ctrl+C to exit after verifying data loads"
+echo ""
+read -p "Press Enter to continue..."
+
+echo ""
+echo "2️⃣  Testing Cache Creation"
+echo "-----------------------------------"
+if [ ! -f "$CACHE_FILE" ]; then
+    echo "❌ Cache file was not created: $CACHE_FILE"
+    exit 1
+fi
+echo "✅ Cache file exists: $CACHE_FILE"
+ls -lh "$CACHE_FILE"
+echo "Cache permissions:"
+stat -c "%a %n" "$CACHE_FILE" || stat -f "%A %N" "$CACHE_FILE"
+echo ""
+
+echo "3️⃣  Testing Cache Contents"
+echo "-----------------------------------"
+echo "First few lines of cache:"
+head -20 "$CACHE_FILE"
+echo ""
+read -p "Press Enter to continue..."
+
+echo ""
+echo "4️⃣  Testing Warm Start (With Valid Cache)"
+echo "-----------------------------------"
+echo "Expected: App should show cached data immediately, then refresh"
+echo "Look for: '📦 Loaded from cache' message in status bar"
+echo "Run: $BINARY tui"
+echo "Press Ctrl+C to exit after verifying cache loads"
+echo ""
+read -p "Press Enter to continue..."
+
+echo ""
+echo "5️⃣  Testing Cache Expiration"
+echo "-----------------------------------"
+echo "Modifying cache to be expired (1 hour ago)..."
+
+TEMP_CACHE=$(mktemp)
+jq '.expiresAt = (now - 3600 | strftime("%Y-%m-%dT%H:%M:%S.000Z"))' "$CACHE_FILE" > "$TEMP_CACHE"
+mv "$TEMP_CACHE" "$CACHE_FILE"
+
+echo "✅ Cache modified to be expired"
+echo "Expected: App should ignore expired cache and load fresh data"
+echo "Run: $BINARY tui"
+echo "Press Ctrl+C to exit after verifying"
+echo ""
+read -p "Press Enter to continue..."
+
+echo ""
+echo "6️⃣  Testing Corrupted Cache"
+echo "-----------------------------------"
+echo "Corrupting cache file..."
+echo "CORRUPTED" > "$CACHE_FILE"
+echo "✅ Cache corrupted"
+echo "Expected: App should handle error gracefully and load fresh data"
+echo "Run: $BINARY tui"
+echo "Press Ctrl+C to exit after verifying"
+echo ""
+read -p "Press Enter to continue..."
+
+echo ""
+echo "7️⃣  Testing Cache Disabled"
+echo "-----------------------------------"
+rm -f "$CACHE_FILE"
+echo "Cache file removed"
+echo "Expected: App should not create cache file when disabled"
+echo "Run: JIRA_CACHE_ENABLED=false $BINARY tui"
+echo "Press Ctrl+C to exit after verifying"
+echo ""
+read -p "Press Enter to continue..."
+
+if [ -f "$CACHE_FILE" ]; then
+    echo "❌ Cache file was created despite being disabled!"
+    exit 1
+fi
+echo "✅ Cache file was not created (as expected)"
+
+echo ""
+echo "✅ All cache tests completed!"
+echo ""
+echo "Manual verification checklist:"
+echo "  □ Cold start shows loading spinner"
+echo "  □ Warm start shows cached data instantly"
+echo "  □ Cache age indicator appears in status bar"
+echo "  □ Fresh data replaces cache after background fetch"
+echo "  □ Expired cache is ignored"
+echo "  □ Corrupted cache is handled gracefully"
+echo "  □ Cache can be disabled via config"

package/.github/workflows/build.yml

@@ -1,80 +0,0 @@
-name: Build and Test
-
-on:
-  push:
-    branches: [ main, develop ]
-  pull_request:
-    branches: [ main, develop ]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Set up Go
-        uses: actions/setup-go@v5
-        with:
-          go-version: '1.21'
-          cache-dependency-path: go-tui/go.sum
-
-      - name: Download dependencies
-        working-directory: ./go-tui
-        run: go mod download
-
-      - name: Build for Linux
-        working-directory: ./go-tui
-        run: go build -o bin/jira-report ./cmd/jira-report
-
-      - name: Verify binary
-        working-directory: ./go-tui
-        run: ./bin/jira-report --help
-
-      - name: Build all platforms
-        working-directory: ./go-tui
-        run: |
-          chmod +x build-all.sh
-          ./build-all.sh
-
-      - name: Upload artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: jira-report-binaries
-          path: go-tui/bin/jira-report-*
-          retention-days: 7
-
-  test-npm-package:
-    runs-on: ubuntu-latest
-    needs: build
-    
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Set up Go
-        uses: actions/setup-go@v5
-        with:
-          go-version: '1.21'
-          cache-dependency-path: go-tui/go.sum
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '18'
-
-      - name: Build binaries
-        working-directory: ./go-tui
-        run: |
-          chmod +x build-all.sh
-          ./build-all.sh
-
-      - name: Test npm package
-        working-directory: ./go-tui
-        run: |
-          npm pack
-          mkdir -p /tmp/test-install
-          cd /tmp/test-install
-          npm install $GITHUB_WORKSPACE/go-tui/jira-report-tui-*.tgz
-          npx jira-report --help

package/.github/workflows/publish.yml

@@ -1,71 +0,0 @@
-name: Publish to npm
-
-on:
-  push:
-    tags:
-      - 'v*.*.*'
-  workflow_dispatch:
-    inputs:
-      version:
-        description: 'Version to publish (e.g., 1.0.0)'
-        required: true
-        type: string
-
-jobs:
-  build-and-publish:
-    runs-on: ubuntu-latest
-    
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Set up Go
-        uses: actions/setup-go@v5
-        with:
-          go-version: '1.21'
-          cache-dependency-path: go-tui/go.sum
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '18'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Build binaries for all platforms
-        working-directory: ./go-tui
-        run: |
-          chmod +x build-all.sh
-          ./build-all.sh
-
-      - name: Update version in package.json
-        if: github.event_name == 'workflow_dispatch'
-        working-directory: ./go-tui
-        run: |
-          npm version ${{ github.event.inputs.version }} --no-git-tag-version
-
-      - name: Extract version from tag
-        if: github.event_name == 'push'
-        id: extract_version
-        run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
-
-      - name: Update version from tag
-        if: github.event_name == 'push'
-        working-directory: ./go-tui
-        run: |
-          npm version ${{ steps.extract_version.outputs.VERSION }} --no-git-tag-version
-
-      - name: Publish to npm
-        working-directory: ./go-tui
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Create GitHub Release
-        if: github.event_name == 'push'
-        uses: softprops/action-gh-release@v1
-        with:
-          generate_release_notes: true
-          files: |
-            go-tui/bin/jira-report-*
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}