claude-cli-advanced-starter-pack 1.0.0

package/src/github/client.js

@@ -0,0 +1,359 @@
+/**
+ * GitHub CLI Wrapper
+ *
+ * Provides clean interface for gh CLI operations
+ */
+
+import { execCommand, execAsync } from '../utils.js';
+import chalk from 'chalk';
+
+/**
+ * Check if gh CLI is authenticated
+ */
+export function isAuthenticated() {
+  const result = execCommand('gh auth status');
+  return result.success;
+}
+
+/**
+ * Get current authenticated user
+ */
+export function getCurrentUser() {
+  const result = execCommand('gh api user --jq ".login"');
+  if (result.success) {
+    return result.output;
+  }
+  return null;
+}
+
+/**
+ * List repositories for a user/org
+ */
+export function listRepos(owner, options = {}) {
+  const { limit = 30, type = 'all' } = options;
+  const cmd = owner
+    ? `gh repo list ${owner} --limit ${limit} --json name,description,isPrivate`
+    : `gh repo list --limit ${limit} --json name,description,isPrivate`;
+
+  const result = execCommand(cmd);
+  if (result.success) {
+    try {
+      return JSON.parse(result.output);
+    } catch {
+      return [];
+    }
+  }
+  return [];
+}
+
+/**
+ * Check if repo exists and is accessible
+ */
+export function repoExists(owner, repo) {
+  const result = execCommand(`gh repo view ${owner}/${repo} --json name`);
+  return result.success;
+}
+
+/**
+ * Get repository info
+ */
+export function getRepoInfo(owner, repo) {
+  const result = execCommand(
+    `gh repo view ${owner}/${repo} --json name,description,isPrivate,defaultBranchRef`
+  );
+  if (result.success) {
+    try {
+      return JSON.parse(result.output);
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+
+/**
+ * List GitHub Projects for a user/org
+ */
+export function listProjects(owner) {
+  const result = execCommand(
+    `gh project list --owner ${owner} --format json`
+  );
+  if (result.success) {
+    try {
+      const data = JSON.parse(result.output);
+      return data.projects || [];
+    } catch {
+      return [];
+    }
+  }
+  return [];
+}
+
+/**
+ * Get project details
+ */
+export function getProject(owner, projectNumber) {
+  const result = execCommand(
+    `gh project view ${projectNumber} --owner ${owner} --format json`
+  );
+  if (result.success) {
+    try {
+      return JSON.parse(result.output);
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+
+/**
+ * List project fields
+ */
+export function listProjectFields(owner, projectNumber) {
+  const result = execCommand(
+    `gh project field-list ${projectNumber} --owner ${owner} --format json`
+  );
+  if (result.success) {
+    try {
+      const data = JSON.parse(result.output);
+      return data.fields || [];
+    } catch {
+      return [];
+    }
+  }
+  return [];
+}
+
+/**
+ * Get field options for single-select fields via GraphQL
+ */
+export function getFieldOptions(projectId, fieldId) {
+  const query = `
+    query($projectId: ID!) {
+      node(id: $projectId) {
+        ... on ProjectV2 {
+          field(name: "${fieldId}") {
+            ... on ProjectV2SingleSelectField {
+              name
+              options {
+                id
+                name
+              }
+            }
+          }
+        }
+      }
+    }
+  `;
+
+  const result = execCommand(
+    `gh api graphql -f query='${query.replace(/\n/g, ' ')}' -F projectId="${projectId}"`
+  );
+
+  if (result.success) {
+    try {
+      const data = JSON.parse(result.output);
+      return data?.data?.node?.field?.options || [];
+    } catch {
+      return [];
+    }
+  }
+  return [];
+}
+
+/**
+ * Get all single-select field options for a project
+ */
+export function getAllFieldOptions(projectId) {
+  const query = `
+    query($projectId: ID!) {
+      node(id: $projectId) {
+        ... on ProjectV2 {
+          fields(first: 50) {
+            nodes {
+              ... on ProjectV2SingleSelectField {
+                id
+                name
+                options {
+                  id
+                  name
+                }
+              }
+              ... on ProjectV2Field {
+                id
+                name
+              }
+              ... on ProjectV2IterationField {
+                id
+                name
+              }
+            }
+          }
+        }
+      }
+    }
+  `;
+
+  const escapedQuery = query.replace(/\n/g, ' ').replace(/"/g, '\\"');
+  const result = execCommand(
+    `gh api graphql -f query="${escapedQuery}" -F projectId="${projectId}"`
+  );
+
+  if (result.success) {
+    try {
+      const data = JSON.parse(result.output);
+      return data?.data?.node?.fields?.nodes || [];
+    } catch {
+      return [];
+    }
+  }
+  return [];
+}
+
+/**
+ * Create a GitHub issue
+ */
+export async function createIssue(owner, repo, options) {
+  const { title, body, labels = [], assignees = [] } = options;
+
+  let cmd = `gh issue create --repo ${owner}/${repo}`;
+  cmd += ` --title "${title.replace(/"/g, '\\"')}"`;
+  cmd += ` --body "${body.replace(/"/g, '\\"').replace(/\n/g, '\\n')}"`;
+
+  if (labels.length > 0) {
+    cmd += ` --label "${labels.join(',')}"`;
+  }
+
+  if (assignees.length > 0) {
+    cmd += ` --assignee "${assignees.join(',')}"`;
+  }
+
+  const result = execCommand(cmd);
+  if (result.success) {
+    // Extract issue URL from output
+    const urlMatch = result.output.match(
+      /https:\/\/github\.com\/[^/]+\/[^/]+\/issues\/\d+/
+    );
+    if (urlMatch) {
+      const issueNumber = urlMatch[0].split('/').pop();
+      return {
+        success: true,
+        url: urlMatch[0],
+        number: parseInt(issueNumber, 10),
+      };
+    }
+  }
+
+  return {
+    success: false,
+    error: result.error || result.stderr || 'Failed to create issue',
+  };
+}
+
+/**
+ * Add issue to project board
+ */
+export function addIssueToProject(owner, projectNumber, issueUrl) {
+  const result = execCommand(
+    `gh project item-add ${projectNumber} --owner ${owner} --url "${issueUrl}"`
+  );
+  return result.success;
+}
+
+/**
+ * Get project item ID for an issue
+ */
+export function getProjectItemId(owner, projectNumber, issueNumber) {
+  const result = execCommand(
+    `gh project item-list ${projectNumber} --owner ${owner} --format json`
+  );
+
+  if (result.success) {
+    try {
+      const data = JSON.parse(result.output);
+      const item = data.items?.find(
+        (i) => i.content?.number === issueNumber
+      );
+      return item?.id || null;
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+
+/**
+ * Update project item field
+ */
+export function updateProjectItemField(
+  projectId,
+  itemId,
+  fieldId,
+  value,
+  fieldType = 'text'
+) {
+  let cmd = `gh project item-edit --id "${itemId}" --project-id "${projectId}" --field-id "${fieldId}"`;
+
+  if (fieldType === 'single-select') {
+    cmd += ` --single-select-option-id "${value}"`;
+  } else if (fieldType === 'number') {
+    cmd += ` --number ${value}`;
+  } else {
+    cmd += ` --text "${value.replace(/"/g, '\\"')}"`;
+  }
+
+  const result = execCommand(cmd);
+  return result.success;
+}
+
+/**
+ * List issues for a repo
+ */
+export function listIssues(owner, repo, options = {}) {
+  const { limit = 10, state = 'open', assignee } = options;
+
+  let cmd = `gh issue list --repo ${owner}/${repo} --limit ${limit} --state ${state} --json number,title,state,labels,createdAt,author`;
+
+  if (assignee) {
+    cmd += ` --assignee ${assignee}`;
+  }
+
+  const result = execCommand(cmd);
+  if (result.success) {
+    try {
+      return JSON.parse(result.output);
+    } catch {
+      return [];
+    }
+  }
+  return [];
+}
+
+/**
+ * Get issue details
+ */
+export function getIssue(owner, repo, issueNumber) {
+  const result = execCommand(
+    `gh issue view ${issueNumber} --repo ${owner}/${repo} --json number,title,body,state,labels,assignees,createdAt,author`
+  );
+
+  if (result.success) {
+    try {
+      return JSON.parse(result.output);
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+
+/**
+ * Add comment to issue
+ */
+export function addIssueComment(owner, repo, issueNumber, body) {
+  const escapedBody = body.replace(/"/g, '\\"').replace(/\n/g, '\\n');
+  const result = execCommand(
+    `gh issue comment ${issueNumber} --repo ${owner}/${repo} --body "${escapedBody}"`
+  );
+  return result.success;
+}

package/src/index.js

@@ -0,0 +1,84 @@
+/**
+ * Claude CLI Advanced Starter Pack - Main Export
+ *
+ * Platform-agnostic Claude Code enhancement toolkit with:
+ * - Tech stack auto-detection
+ * - Templated .claude file generation
+ * - GitHub Project Board integration
+ * - Advanced testing configuration
+ */
+
+// CLI
+export { showMainMenu, showHeader, showSuccess, showError } from './cli/menu.js';
+
+// Commands
+export { runSetup } from './commands/setup.js';
+export { runCreate } from './commands/create.js';
+export { runList } from './commands/list.js';
+export { runInstall } from './commands/install.js';
+export { showHelp } from './commands/help.js';
+export { runClaudeSettings } from './commands/claude-settings.js';
+export { runGtaskInit } from './commands/gtask-init.js';
+export { detectTechStack, runDetection } from './commands/detect-tech-stack.js';
+export {
+  runClaudeAudit,
+  showClaudeAuditMenu,
+  ENHANCEMENT_TEMPLATES,
+  runEnhancement,
+} from './commands/claude-audit.js';
+export { runSetupWizard, generateSlashCommand } from './commands/setup-wizard.js';
+
+// Template Engine
+export {
+  replacePlaceholders,
+  processFile,
+  processDirectory,
+  generateTechStack,
+  flattenObject,
+  extractPlaceholders,
+  validateTechStack,
+} from './utils/template-engine.js';
+
+// GitHub client
+export {
+  isAuthenticated,
+  getCurrentUser,
+  listRepos,
+  repoExists,
+  listProjects,
+  getProject,
+  listProjectFields,
+  createIssue,
+  addIssueToProject,
+  listIssues,
+} from './github/client.js';
+
+// Codebase analysis
+export {
+  searchFiles,
+  searchContent,
+  findDefinitions,
+  extractSnippet,
+  analyzeForIssue,
+  detectProjectType,
+} from './analysis/codebase.js';
+
+// Templates
+export {
+  generateIssueBody,
+  generateSimpleIssueBody,
+  suggestAcceptanceCriteria,
+} from './templates/issue-body.js';
+
+export {
+  generateClaudeCommand,
+  generateMinimalClaudeCommand,
+} from './templates/claude-command.js';
+
+// Utils
+export {
+  getVersion,
+  checkPrerequisites,
+  loadConfigSync,
+  execCommand,
+} from './utils.js';

package/src/templates/claude-command.js

@@ -0,0 +1,244 @@
+/**
+ * Claude Code Command Template Generator
+ *
+ * Generates a .claude/commands/ file that integrates with GitHub Task Kit
+ */
+
+/**
+ * Generate Claude Code command file content
+ */
+export function generateClaudeCommand(config) {
+  const { owner, repo, projectNumber, projectId, fieldIds, statusOptions } = config;
+
+  return `---
+description: Create tracked GitHub issue with comprehensive metadata and codebase analysis
+type: project
+complexity: medium
+model: claude-sonnet-4-5-20250929
+---
+
+# GitHub Create Task
+# QUICK: Create comprehensive GitHub issue with rich documentation
+
+Create a fully documented GitHub issue with codebase analysis, references, and testing workflow.
+
+## Overview
+
+This command creates a comprehensive, well-documented GitHub issue with:
+- Detailed problem statement and acceptance criteria
+- Automatic codebase analysis with file/line references
+- Reference documentation links
+- Recommended approach with todo checklist
+
+**Project**: ${owner}/${repo} (Project #${projectNumber})
+
+---
+
+## Configuration
+
+\`\`\`yaml
+# Auto-generated by GitHub Task Kit
+project_board:
+  owner: "${owner}"
+  repo: "${repo}"
+  project_number: ${projectNumber}
+  project_id: "${projectId}"
+
+field_ids:
+  status: "${fieldIds?.status || 'CONFIGURE_ME'}"
+  priority: "${fieldIds?.priority || 'CONFIGURE_ME'}"
+  qa: "${fieldIds?.qa || ''}"
+
+status_options:
+  todo: "${statusOptions?.todo || 'CONFIGURE_ME'}"
+  in_progress: "${statusOptions?.in_progress || 'CONFIGURE_ME'}"
+  done: "${statusOptions?.done || 'CONFIGURE_ME'}"
+\`\`\`
+
+---
+
+## Workflow
+
+### PHASE 1: Gather Information
+
+Use AskUserQuestion to collect:
+
+1. **Issue Title** - Clear, concise description
+2. **Issue Description** - Problem statement, expected vs actual behavior
+3. **Labels** - Type (bug, feature, refactor), Stack (frontend, backend)
+4. **Priority** - P0-Critical, P1-High, P2-Medium, P3-Low
+
+### PHASE 2: Codebase Analysis
+
+**Deploy Explore Agent** to gather:
+
+1. Find relevant files matching the issue domain
+2. Locate key functions with line numbers
+3. Identify patterns to follow
+4. Gather code snippets
+
+### PHASE 3: Create Issue
+
+\`\`\`bash
+# Create the issue
+ISSUE_URL=$(gh issue create --repo ${owner}/${repo} \\
+  --title "[TITLE]" \\
+  --body "[GENERATED_BODY]" \\
+  --label "[LABELS]" \\
+  --assignee "${owner}")
+
+# Extract issue number
+ISSUE_NUM=$(echo "$ISSUE_URL" | grep -oP '\\d+$')
+
+# Add to project board
+gh project item-add ${projectNumber} --owner ${owner} --url "$ISSUE_URL"
+
+echo "Created: Issue #$ISSUE_NUM"
+echo "URL: $ISSUE_URL"
+\`\`\`
+
+### PHASE 4: Update Project Board Fields
+
+\`\`\`bash
+# Get item ID
+ITEM_ID=$(gh project item-list ${projectNumber} --owner ${owner} --format json | jq -r ".items[] | select(.content.number == $ISSUE_NUM) | .id")
+
+# Set Status to Todo
+gh project item-edit --id "$ITEM_ID" \\
+  --field-id ${fieldIds?.status || 'STATUS_FIELD_ID'} \\
+  --project-id ${projectId} \\
+  --single-select-option-id "${statusOptions?.todo || 'TODO_OPTION_ID'}"
+
+# Set Priority (if field exists)
+# gh project item-edit --id "$ITEM_ID" \\
+#   --field-id ${fieldIds?.priority || 'PRIORITY_FIELD_ID'} \\
+#   --project-id ${projectId} \\
+#   --single-select-option-id "[PRIORITY_OPTION_ID]"
+\`\`\`
+
+---
+
+## Issue Body Template
+
+The generated issue body includes:
+
+\`\`\`markdown
+## Problem Statement
+
+[Clear description of the issue]
+
+## Expected vs Actual Behavior
+
+**Expected**: [What should happen]
+**Actual**: [What currently happens]
+
+## Acceptance Criteria
+
+- [ ] Criterion 1
+- [ ] Criterion 2
+
+---
+
+## Code Analysis
+
+### Relevant Files & Functions
+
+| File | Line | Function/Component | Purpose |
+|------|------|-------------------|---------|
+| [file] | [line] | [function] | [purpose] |
+
+### Patterns to Follow
+
+- [Pattern from codebase analysis]
+
+---
+
+## Recommended Approach
+
+### Todo List
+
+- [ ] **Step 1**: [Task]
+- [ ] **Step 2**: [Task]
+
+---
+
+*Created by GitHub Task Kit*
+\`\`\`
+
+---
+
+## Labels Reference
+
+**Type**:
+- \`bug\` - Something isn't working
+- \`feature\` - New functionality
+- \`feature-update\` - Enhancement to existing feature
+- \`refactor\` - Code improvement without behavior change
+- \`documentation\` - Documentation only
+
+**Stack**:
+- \`frontend\` - UI/client changes
+- \`backend\` - API/server changes
+
+**Priority**:
+- \`P0-Critical\` - Production broken
+- \`P1-High\` - Major feature affected
+- \`P2-Medium\` - Minor bug or new feature
+- \`P3-Low\` - Nice to have
+
+---
+
+## Quick Commands
+
+\`\`\`bash
+# After creating issue, start working
+git pull origin main
+
+# When done
+git add -A
+git commit -m "feat: [description] (#[NUM])"
+git push origin main
+\`\`\`
+
+---
+
+## See Also
+
+- \`gh issue list --repo ${owner}/${repo}\` - List issues
+- \`gh project view ${projectNumber} --owner ${owner}\` - View project board
+
+---
+
+*Generated by GitHub Task Kit - https://github.com/yourname/github-task-kit*
+`;
+}
+
+/**
+ * Generate minimal Claude command (just the essentials)
+ */
+export function generateMinimalClaudeCommand(config) {
+  const { owner, repo, projectNumber } = config;
+
+  return `---
+description: Create GitHub issue for ${repo}
+type: project
+---
+
+# Create Task
+
+Quick issue creation for ${owner}/${repo}.
+
+## Usage
+
+1. Provide title and description
+2. Select labels and priority
+3. Issue created and added to project #${projectNumber}
+
+## Command
+
+\`\`\`bash
+gh issue create --repo ${owner}/${repo} --title "[TITLE]" --body "[BODY]"
+gh project item-add ${projectNumber} --owner ${owner} --url "[ISSUE_URL]"
+\`\`\`
+`;
+}