claude-cli-advanced-starter-pack 1.8.3 → 1.8.5

package/templates/commands/menu-issues-list.template.md

@@ -0,0 +1,288 @@
+---
+description: Mobile-friendly menu of open GitHub issues sorted by date
+type: utility
+complexity: simple
+model: haiku
+allowed-tools:
+  - Bash
+  - AskUserQuestion
+---
+
+# /menu-issues-list - Quick Issues View
+
+**Mobile-friendly list of open GitHub issues with single-character selection.**
+
+---
+
+## EXECUTION
+
+### Step 1: Fetch and Display Issues
+
+Run this command to get open issues:
+
+```bash
+gh issue list --state open --json number,title,createdAt,labels --limit 20
+```
+
+### Step 2: Format for Mobile Display
+
+Display issues in this compact format (sorted newest to oldest):
+
+```
+╔═══════════════════════════════════════╗
+║  📋 Open Issues                       ║
+╠═══════════════════════════════════════╣
+║                                       ║
+║  [A] #123 - Fix login redirect bug    ║
+║      01/30 • P1 • frontend            ║
+║                                       ║
+║  [B] #122 - Add dark mode toggle      ║
+║      01/29 • P2 • feature             ║
+║                                       ║
+║  [C] #121 - Update API docs           ║
+║      01/28 • P3 • docs                ║
+║                                       ║
+║  [D] #120 - Refactor auth module      ║
+║      01/27 • P2 • backend             ║
+║                                       ║
+╠═══════════════════════════════════════╣
+║  [R] Refresh  [X] Exit                ║
+╚═══════════════════════════════════════╝
+```
+
+**Format Rules:**
+- Title: Max 30 chars, truncate with `...` if longer
+- Date: `MM/DD` format (createdAt)
+- Priority: Extract from labels (P0, P1, P2, P3) or show `-`
+- Labels: Show first non-priority label, max 10 chars
+- Sort: Newest first (by createdAt descending)
+
+### Step 3: Ask User Selection
+
+Use AskUserQuestion with single-letter options:
+
+```
+header: "Select"
+question: "Pick an issue (A-Z) or action:"
+options:
+  - label: "A"
+    description: "#123 - Fix login redirect bug"
+  - label: "B"
+    description: "#122 - Add dark mode toggle"
+  - label: "C"
+    description: "#121 - Update API docs"
+  - label: "R"
+    description: "Refresh list"
+```
+
+### Step 4: Handle Selection
+
+**If user selects an issue (A-Z):**
+
+First, fetch full issue details including body:
+
+```bash
+gh issue view [NUMBER] --json number,title,body,createdAt,labels,url
+```
+
+**Detect Issue Format:**
+
+Check if the issue body contains BOTH of these indicators of `/github-task` format:
+- `## Acceptance Criteria` OR `## Task Checklist` section
+- `## Suggested Implementation` OR `## Implementation Approach` section
+
+**If PROPERLY FORMATTED** (created by `/github-task`):
+
+Show issue details with format indicator:
+
+```
+╔═══════════════════════════════════════╗
+║  Issue #123  ✓ Task-Ready             ║
+╠═══════════════════════════════════════╣
+║                                       ║
+║  Fix login redirect bug               ║
+║                                       ║
+║  Created: 01/30/2026                  ║
+║  Labels: P1, frontend, bug            ║
+║  URL: github.com/.../issues/123       ║
+║                                       ║
+║  Format: Task-ready (has checklist)   ║
+║                                       ║
+╠═══════════════════════════════════════╣
+║  [S] Start (use existing tasks)       ║
+║  [V] View details  [B] Back  [X] Exit ║
+╚═══════════════════════════════════════╝
+```
+
+Then ask:
+
+```
+header: "Action"
+question: "What would you like to do?"
+options:
+  - label: "S - Start working"
+    description: "Execute task checklist from issue"
+  - label: "V - View details"
+    description: "Show full issue body"
+  - label: "B - Back"
+    description: "Return to issues list"
+```
+
+**If NOT PROPERLY FORMATTED** (generic issue):
+
+Show issue details with exploration indicator:
+
+```
+╔═══════════════════════════════════════╗
+║  Issue #123  ⚠ Needs Analysis         ║
+╠═══════════════════════════════════════╣
+║                                       ║
+║  Fix login redirect bug               ║
+║                                       ║
+║  Created: 01/30/2026                  ║
+║  Labels: P1, frontend, bug            ║
+║  URL: github.com/.../issues/123       ║
+║                                       ║
+║  Format: Needs task list generation   ║
+║                                       ║
+╠═══════════════════════════════════════╣
+║  [S] Start (explore + generate tasks) ║
+║  [V] View details  [B] Back  [X] Exit ║
+╚═══════════════════════════════════════╝
+```
+
+Then ask:
+
+```
+header: "Action"
+question: "What would you like to do?"
+options:
+  - label: "S - Start working"
+    description: "Run /create-task-list to analyze and generate tasks"
+  - label: "V - View details"
+    description: "Show full issue body"
+  - label: "B - Back"
+    description: "Return to issues list"
+```
+
+### Step 5: Handle "Start Working" - ALWAYS Run Full /create-task-list Process
+
+**BOTH PATHS run the full `/create-task-list` workflow**, including:
+- Agent-based codebase exploration
+- Testing options (Ralph loop, E2E framework selection)
+- Environment configuration from tech-stack.json
+- Workflow options (branch, worktree, project board)
+
+The only difference is whether we **generate** a new task list or **use** the existing one from the issue.
+
+---
+
+**For PROPERLY FORMATTED issues (S action):**
+
+Run `/create-task-list for issue #[NUMBER] --use-existing-tasks`
+
+This executes the full `/create-task-list` process but:
+1. **Skips task generation** - uses the existing `## Task Checklist` from issue body
+2. **Runs codebase exploration** - agents analyze relevant files for context
+3. **Asks testing questions** - Ralph loop, E2E framework, test environment
+4. **Asks workflow questions** - branch creation, worktree, project board sync
+5. **Creates TodoWrite entries** from the issue's existing checklist
+6. **Begins implementation** with full context
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║  📋 Starting Issue #[NUMBER] (Task-Ready)                     ║
+╠═══════════════════════════════════════════════════════════════╣
+║  Using existing task checklist from issue                     ║
+║  Running full /create-task-list workflow for:                 ║
+║    • Codebase exploration & context                           ║
+║    • Testing configuration (Ralph loop, E2E)                  ║
+║    • Workflow setup (branch, board sync)                      ║
+╚═══════════════════════════════════════════════════════════════╝
+```
+
+---
+
+**For NOT PROPERLY FORMATTED issues (S action):**
+
+Run `/create-task-list for issue #[NUMBER]`
+
+This executes the full `/create-task-list` process:
+1. **Generates task list** - agents explore codebase and create tasks
+2. **Runs codebase exploration** - deep analysis of relevant files
+3. **Asks testing questions** - Ralph loop, E2E framework, test environment
+4. **Asks workflow questions** - branch creation, worktree, project board sync
+5. **Creates TodoWrite entries** from generated tasks
+6. **Offers to update GitHub issue** with the generated task list
+7. **Begins implementation** with full context
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║  📋 Starting Issue #[NUMBER] (Needs Analysis)                 ║
+╠═══════════════════════════════════════════════════════════════╣
+║  Running full /create-task-list workflow for:                 ║
+║    • Task generation via codebase exploration                 ║
+║    • Testing configuration (Ralph loop, E2E)                  ║
+║    • Workflow setup (branch, board sync)                      ║
+║    • Option to update issue with generated tasks              ║
+╚═══════════════════════════════════════════════════════════════╝
+```
+
+After task list is generated, ask:
+
+```
+header: "Update"
+question: "Update GitHub issue with generated task list?"
+options:
+  - label: "Y - Yes, update issue"
+    description: "Add task checklist to issue body"
+  - label: "N - No, just implement"
+    description: "Keep issue as-is, start work"
+```
+
+If user selects Y:
+```bash
+# Append task checklist to issue body
+gh issue edit [NUMBER] --body "$(gh issue view [NUMBER] --json body -q .body)
+
+## Task Checklist (Auto-generated)
+
+- [ ] Task 1
+- [ ] Task 2
+..."
+```
+
+**Other Actions:**
+- **V (View)**: Run `gh issue view [NUMBER]` and display full body
+- **B (Back)**: Return to Step 2
+- **R (Refresh)**: Re-fetch issues and display
+- **X (Exit)**: End command
+
+---
+
+## MOBILE OPTIMIZATION
+
+- Single character inputs (A, B, C, S, V, X)
+- Compact display fits small screens
+- No scrolling needed for main list
+- Clear visual hierarchy with boxes
+- Truncated titles prevent overflow
+
+---
+
+## ERROR HANDLING
+
+| Error | Action |
+|-------|--------|
+| No issues found | Display "No open issues" message |
+| gh not authenticated | Show `gh auth login` instructions |
+| Network error | Show retry option |
+
+---
+
+## RELATED COMMANDS
+
+- `/create-task-list-for-issue` - Start issue by number directly
+- `/create-task-list` - Create task list from issue
+- `/github-task-start` - Start working on issue
+- `/github-update` - Sync with project board

package/templates/hooks/github-progress-hook.template.cjs

@@ -0,0 +1,248 @@
+/**
+ * GitHub Progress Hook
+ *
+ * Automatically updates GitHub issues as tasks are completed.
+ * Monitors TodoWrite calls and syncs progress to linked GitHub issues.
+ *
+ * Event: PostToolUse
+ * Matcher: TodoWrite
+ *
+ * This hook reads from stdin (Claude Code passes tool info there)
+ * and updates the linked GitHub issue with progress comments.
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+// Configuration - parse from tech-stack.json dynamically
+function loadConfig() {
+  try {
+    const techStackPath = path.join(process.cwd(), '.claude', 'config', 'tech-stack.json');
+    if (fs.existsSync(techStackPath)) {
+      const techStack = JSON.parse(fs.readFileSync(techStackPath, 'utf8'));
+      const vc = techStack.versionControl || {};
+      const repo = vc.repository || '';
+      const [owner, repoName] = repo.includes('/') ? repo.split('/') : ['', ''];
+
+      return {
+        owner: owner,
+        repo: repoName,
+        projectNumber: vc.projectBoard?.number || null,
+        enabled: !!vc.projectBoard?.type && !!owner && !!repoName,
+      };
+    }
+  } catch (e) {
+    // Silent fail - config not available
+  }
+  return { owner: '', repo: '', projectNumber: null, enabled: false };
+}
+
+const PROGRESS_FILE = '.claude/hooks/cache/github-progress.json';
+
+/**
+ * Load progress tracking data
+ */
+function loadProgress() {
+  const progressPath = path.join(process.cwd(), PROGRESS_FILE);
+
+  if (fs.existsSync(progressPath)) {
+    try {
+      return JSON.parse(fs.readFileSync(progressPath, 'utf8'));
+    } catch (error) {
+      // Could not parse, return default
+    }
+  }
+
+  return {
+    linkedIssue: null,
+    tasks: [],
+    completedTasks: [],
+    lastUpdate: null,
+  };
+}
+
+/**
+ * Save progress tracking data
+ */
+function saveProgress(progress) {
+  const progressPath = path.join(process.cwd(), PROGRESS_FILE);
+  const progressDir = path.dirname(progressPath);
+
+  if (!fs.existsSync(progressDir)) {
+    fs.mkdirSync(progressDir, { recursive: true });
+  }
+
+  progress.lastUpdate = new Date().toISOString();
+  fs.writeFileSync(progressPath, JSON.stringify(progress, null, 2), 'utf8');
+}
+
+/**
+ * Check if gh CLI is available
+ */
+function hasGhCli() {
+  try {
+    execSync('gh --version', { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Update GitHub issue with progress comment
+ */
+function updateGitHubIssue(issueNumber, completedCount, totalCount, latestTask, config) {
+  if (!hasGhCli()) {
+    return false;
+  }
+
+  try {
+    // Create progress comment
+    const percentage = totalCount > 0 ? Math.round((completedCount / totalCount) * 100) : 0;
+    const progressBar = '█'.repeat(Math.floor(percentage / 10)) + '░'.repeat(10 - Math.floor(percentage / 10));
+
+    const comment = `### Progress Update
+
+${progressBar} ${percentage}% (${completedCount}/${totalCount} tasks)
+
+**Latest completed:** ${latestTask || 'N/A'}
+
+---
+*Auto-updated by Claude Code github-progress-hook*`;
+
+    // Add comment to issue - use file to avoid escaping issues
+    const cacheDir = path.join(process.cwd(), '.claude', 'hooks', 'cache');
+    if (!fs.existsSync(cacheDir)) {
+      fs.mkdirSync(cacheDir, { recursive: true });
+    }
+    const tmpFile = path.join(cacheDir, 'tmp-comment.md');
+    fs.writeFileSync(tmpFile, comment, 'utf8');
+
+    execSync(
+      `gh issue comment ${issueNumber} --repo ${config.owner}/${config.repo} --body-file "${tmpFile}"`,
+      { stdio: 'pipe' }
+    );
+
+    // Clean up temp file
+    try { fs.unlinkSync(tmpFile); } catch {}
+
+    console.log(`[github-progress] Updated issue #${issueNumber}: ${percentage}% complete`);
+    return true;
+  } catch (error) {
+    // Silent fail
+    return false;
+  }
+}
+
+/**
+ * Extract linked issue number from todos
+ */
+function findLinkedIssue(todos, progress) {
+  // Check if issue is already linked
+  if (progress.linkedIssue) {
+    return progress.linkedIssue;
+  }
+
+  // Look for issue reference in todo content (e.g., "Issue #11" or "#11")
+  for (const todo of todos) {
+    const content = todo.content || '';
+    const issueMatch = content.match(/(?:Issue\s*)?#(\d+)/i);
+    if (issueMatch) {
+      return parseInt(issueMatch[1], 10);
+    }
+  }
+
+  return null;
+}
+
+/**
+ * Main function - reads from stdin and processes TodoWrite
+ */
+async function main() {
+  const config = loadConfig();
+
+  // Skip if not configured
+  if (!config.enabled) {
+    return;
+  }
+
+  // Read stdin to get tool information
+  let input = '';
+  try {
+    input = fs.readFileSync(0, 'utf8');
+  } catch {
+    // No stdin available
+    return;
+  }
+
+  let toolData;
+  try {
+    toolData = JSON.parse(input);
+  } catch {
+    // Invalid JSON
+    return;
+  }
+
+  // Check if this is a TodoWrite tool
+  const toolName = toolData.tool_name || toolData.name;
+  if (toolName !== 'TodoWrite') {
+    return;
+  }
+
+  // Get todos from input
+  const todos = toolData.tool_input?.todos || toolData.input?.todos || [];
+  if (todos.length === 0) {
+    return;
+  }
+
+  // Load progress tracking
+  const progress = loadProgress();
+
+  // Check for linked issue
+  const issueNumber = findLinkedIssue(todos, progress);
+
+  if (issueNumber && !progress.linkedIssue) {
+    progress.linkedIssue = issueNumber;
+    console.log(`[github-progress] Linked to issue #${issueNumber}`);
+  }
+
+  // Skip if no linked issue
+  if (!progress.linkedIssue) {
+    saveProgress(progress);
+    return;
+  }
+
+  // Count completed vs total tasks (excluding CONTEXT task)
+  const actualTodos = todos.filter(t => !t.content?.startsWith('CONTEXT:'));
+  const completedTodos = actualTodos.filter(t => t.status === 'completed');
+  const totalCount = actualTodos.length;
+  const completedCount = completedTodos.length;
+
+  // Find latest completed task
+  const latestCompleted = completedTodos[completedTodos.length - 1];
+  const latestTask = latestCompleted?.content || null;
+
+  // Check if progress changed (more tasks completed than before)
+  const previousCompleted = progress.completedTasks?.length || 0;
+
+  if (completedCount > previousCompleted) {
+    // Update GitHub issue
+    updateGitHubIssue(progress.linkedIssue, completedCount, totalCount, latestTask, config);
+
+    // Update progress tracking
+    progress.completedTasks = completedTodos.map(t => t.content);
+    progress.tasks = actualTodos.map(t => ({ content: t.content, status: t.status }));
+  }
+
+  // Save progress
+  saveProgress(progress);
+}
+
+// Run the hook
+main().catch(err => {
+  // Silently fail - don't break Claude Code
+  if (process.env.DEBUG) {
+    console.error('github-progress hook error:', err);
+  }
+});