den-github-manager 1.0.0

package/docs/backlog.md

@@ -0,0 +1,78 @@
+# Product Backlog
+
+Generated: 2026-02-06
+
+## Milestones
+
+| ID | Milestone | Objective | State |
+|----|-----------|-----------|-------|
+| M0 | Foundation | Setup and initial configuration | ✅ closed |
+| M1 | Core Features | Main functionality | ⬜ open |
+| M2 | Polish | Testing and refinement | ⬜ open |
+
+---
+
+## Epics
+
+| ID | Epic | Description | Milestone |
+|----|------|-------------|-----------||
+| E1 | Setup & Configuration | | M0 |
+| E2 | Core Functionality | | M1 |
+| E3 | User Interface | | M1 |
+
+---
+
+## User Stories
+
+### US-E1-01: Setup repository
+
+**Priority**: P0 | **Points**: 3 | **Status**: ✅ completed
+
+**Epic**: E1 | **Milestone**: M0
+
+**Criterios de Aceptación**:
+- [ ] Implement functionality
+- [ ] Add tests
+- [ ] Update documentation
+
+---
+
+### US-E1-02: Configure development environment
+
+**Priority**: P0 | **Points**: 5 | **Status**: ✅ completed
+
+**Epic**: E1 | **Milestone**: M0
+
+**Criterios de Aceptación**:
+- [ ] Implement functionality
+- [ ] Add tests
+- [ ] Update documentation
+
+---
+
+### US-E2-01: Implement core logic
+
+**Priority**: P0 | **Points**: 8 | **Status**: ⬜ pending
+
+**Epic**: E2 | **Milestone**: M1
+
+**Criterios de Aceptación**:
+- [ ] Implement functionality
+- [ ] Add tests
+- [ ] Update documentation
+
+---
+
+### US-E3-01: Create main UI components
+
+**Priority**: P1 | **Points**: 5 | **Status**: ⬜ pending
+
+**Epic**: E3 | **Milestone**: M1
+
+**Criterios de Aceptación**:
+- [ ] Implement functionality
+- [ ] Add tests
+- [ ] Update documentation
+
+---
+

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "den-github-manager",
+  "version": "1.0.0",
+  "description": "CLI tool to setup GitHub Projects automatically - Analyze, generate backlog, and configure milestones, issues, and project boards in minutes",
+  "main": "src/index.js",
+  "type": "module",
+  "bin": {
+    "den": "./bin/den.js",
+    "den-github-manager": "./bin/den.js"
+  },
+  "scripts": {
+    "start": "node bin/den.js",
+    "test": "jest",
+    "lint": "eslint src/",
+    "format": "prettier --write \"src/**/*.js\"",
+    "prepare": "chmod +x bin/den.js"
+  },
+  "keywords": [
+    "github",
+    "project-management",
+    "cli",
+    "automation",
+    "kanban",
+    "agile",
+    "scrum",
+    "milestones",
+    "issues",
+    "project-board",
+    "backlog",
+    "devtools"
+  ],
+  "author": "wolfcito <@akawolfcito>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wolfcito/den-github-manager.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wolfcito/den-github-manager/issues"
+  },
+  "homepage": "https://github.com/wolfcito/den-github-manager#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "inquirer": "^9.2.12",
+    "ora": "^7.0.1",
+    "@octokit/rest": "^20.0.2",
+    "js-yaml": "^4.1.0",
+    "marked": "^11.1.0"
+  },
+  "devDependencies": {
+    "eslint": "^8.55.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.1.1"
+  }
+}

package/scripts/pre-publish-test.sh

@@ -0,0 +1,122 @@
+#!/bin/bash
+
+# Pre-publish test script
+# Run this before publishing to npm
+
+set -e
+
+echo "🧪 Pre-Publish Testing"
+echo "======================"
+echo ""
+
+# 1. Syntax check
+echo "1️⃣  Checking syntax..."
+node --check bin/den.js
+echo "✅ Syntax OK"
+echo ""
+
+# 2. Check permissions
+echo "2️⃣  Checking permissions..."
+if [ -x "bin/den.js" ]; then
+  echo "✅ bin/den.js is executable"
+else
+  echo "❌ bin/den.js is not executable"
+  echo "Run: chmod +x bin/den.js"
+  exit 1
+fi
+echo ""
+
+# 3. Install dependencies
+echo "3️⃣  Installing dependencies..."
+npm ci > /dev/null 2>&1
+echo "✅ Dependencies installed"
+echo ""
+
+# 4. Test basic commands
+echo "4️⃣  Testing CLI commands..."
+./bin/den.js --version > /dev/null
+echo "✅ Version command works"
+
+./bin/den.js --help > /dev/null
+echo "✅ Help command works"
+
+./bin/den.js templates --list > /dev/null
+echo "✅ Templates command works"
+
+./bin/den.js analyze > /dev/null 2>&1 || true
+echo "✅ Analyze command works"
+
+./bin/den.js init --template simple --auto --dry-run > /dev/null 2>&1
+echo "✅ Init command works (dry-run)"
+echo ""
+
+# 5. Check package
+echo "5️⃣  Checking package contents..."
+npm pack --dry-run > /tmp/pack-contents.txt 2>&1
+
+EXPECTED_FILES=(
+  "package.json"
+  "README.md"
+  "LICENSE"
+  "bin/den.js"
+  "src/"
+)
+
+for file in "${EXPECTED_FILES[@]}"; do
+  if grep -q "$file" /tmp/pack-contents.txt; then
+    echo "✅ $file included"
+  else
+    echo "⚠️  $file might be missing"
+  fi
+done
+
+echo ""
+
+# 6. Check package.json
+echo "6️⃣  Validating package.json..."
+required_fields=("name" "version" "description" "main" "bin" "author" "license")
+
+for field in "${required_fields[@]}"; do
+  if grep -q "\"$field\"" package.json; then
+    echo "✅ $field present"
+  else
+    echo "❌ $field missing"
+    exit 1
+  fi
+done
+
+echo ""
+
+# 7. Size check
+echo "7️⃣  Package size check..."
+npm pack --quiet > /dev/null
+TARBALL=$(ls -1 den-github-manager-*.tgz 2>/dev/null | head -1)
+
+if [ -f "$TARBALL" ]; then
+  SIZE=$(du -h "$TARBALL" | cut -f1)
+  echo "📦 Package size: $SIZE"
+
+  # Clean up
+  rm "$TARBALL"
+
+  # Warn if > 1MB
+  SIZE_KB=$(du -k "$TARBALL" 2>/dev/null | cut -f1 || echo 0)
+  if [ $SIZE_KB -gt 1024 ]; then
+    echo "⚠️  Package is larger than 1MB"
+  fi
+else
+  echo "⚠️  Could not determine package size"
+fi
+
+echo ""
+
+# Summary
+echo "✅ All pre-publish tests passed!"
+echo ""
+echo "📋 Next steps:"
+echo "  1. Commit all changes: git add . && git commit"
+echo "  2. Push to GitHub: git push"
+echo "  3. Login to npm: npm login"
+echo "  4. Publish: npm publish"
+echo "  5. Create release: gh release create v1.0.0"
+echo ""

package/src/commands/analyze.js

@@ -0,0 +1,35 @@
+import { Analyzer } from '../core/analyzer.js';
+import { Logger } from '../utils/logger.js';
+
+export async function analyzeCommand(options) {
+  const logger = new Logger();
+  const analyzer = new Analyzer();
+
+  logger.info('Analyzing project...');
+
+  const analysis = await analyzer.analyze();
+
+  if (options.json) {
+    logger.json(analysis);
+  } else {
+    analyzer.generateReport(analysis);
+
+    // Additional insights
+    logger.newline();
+    logger.section('💡 Recommendations');
+
+    if (!analysis.hasBacklog.exists) {
+      logger.info('Consider creating a backlog with: den init');
+    }
+
+    if (!analysis.hasDocumentation.exists) {
+      logger.info('Consider adding documentation in docs/');
+    }
+
+    if (analysis.phase === 'new') {
+      logger.info('Perfect time to set up project management!');
+    }
+
+    logger.newline();
+  }
+}

package/src/commands/config.js

@@ -0,0 +1,42 @@
+import { Config } from '../utils/config.js';
+import { Logger } from '../utils/logger.js';
+
+export async function configCommand(options) {
+  const logger = new Logger();
+  const config = new Config();
+
+  await config.load();
+
+  if (options.set) {
+    const [key, value] = options.set.split('=');
+
+    if (!key || !value) {
+      logger.error('Invalid format. Use: --set key=value');
+      return;
+    }
+
+    config.set(key, value);
+    await config.save();
+    logger.success(`Set ${key} = ${value}`);
+  }
+
+  if (options.get) {
+    const value = config.get(options.get);
+    console.log(value);
+  }
+
+  if (options.list || (!options.set && !options.get)) {
+    logger.section('⚙️  Configuration');
+    logger.newline();
+
+    const allConfig = config.getAll();
+
+    for (const [key, value] of Object.entries(allConfig)) {
+      logger.info(`${key}: ${JSON.stringify(value)}`);
+    }
+
+    logger.newline();
+    logger.dim('Config file: ~/.den-github-manager/config.json');
+    logger.newline();
+  }
+}

package/src/commands/init.js

@@ -0,0 +1,224 @@
+import inquirer from 'inquirer';
+import ora from 'ora';
+import fs from 'fs/promises';
+import path from 'path';
+import { Analyzer } from '../core/analyzer.js';
+import { Generator } from '../core/generator.js';
+import { GitHubClient } from '../core/github-client.js';
+import { Logger } from '../utils/logger.js';
+
+export async function initCommand(options) {
+  const logger = new Logger();
+
+  logger.section('🦁 Den GitHub Manager - Project Setup');
+
+  // Step 1: Analyze project
+  const analyzer = new Analyzer();
+  const spinner = ora('Analyzing project...').start();
+
+  let analysis;
+  try {
+    analysis = await analyzer.analyze();
+    spinner.succeed('Project analyzed');
+  } catch (error) {
+    spinner.fail('Analysis failed');
+    logger.error(error.message);
+    return;
+  }
+
+  // Show analysis report
+  if (!options.auto) {
+    logger.newline();
+    analyzer.generateReport(analysis);
+    logger.newline();
+  }
+
+  // Step 2: Determine backlog strategy
+  let backlogContent;
+  let template = options.template || 'simple';
+
+  if (analysis.hasBacklog.exists) {
+    logger.success(`Found existing backlog: ${analysis.hasBacklog.path}`);
+
+    if (!options.auto) {
+      const { useExisting } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'useExisting',
+        message: 'Use existing backlog?',
+        default: true
+      }]);
+
+      if (!useExisting) {
+        template = await selectTemplate();
+      } else {
+        // Read existing backlog
+        const backlogPath = path.join(process.cwd(), analysis.hasBacklog.path);
+        backlogContent = await fs.readFile(backlogPath, 'utf-8');
+      }
+    }
+  } else {
+    logger.warn('No backlog found');
+
+    if (!options.auto) {
+      const { action } = await inquirer.prompt([{
+        type: 'list',
+        name: 'action',
+        message: 'How would you like to proceed?',
+        choices: [
+          { name: '📋 Use a template (recommended)', value: 'template' },
+          { name: '🤖 Generate from project structure', value: 'generate' },
+          { name: '✍️  Create manually later', value: 'skip' }
+        ]
+      }]);
+
+      if (action === 'template') {
+        template = await selectTemplate();
+      } else if (action === 'skip') {
+        logger.info('Skipping backlog generation. You can create it manually later.');
+        return;
+      }
+    }
+  }
+
+  // Step 3: Generate or parse backlog
+  const generator = new Generator();
+
+  if (!backlogContent) {
+    spinner.start('Generating backlog...');
+    backlogContent = await generator.generateBacklog(analysis, template);
+    spinner.succeed(`Backlog generated using "${template}" template`);
+
+    // Save backlog
+    const backlogPath = path.join(process.cwd(), 'docs', 'backlog.md');
+    await fs.mkdir(path.dirname(backlogPath), { recursive: true });
+    await fs.writeFile(backlogPath, backlogContent);
+    logger.success(`Saved to: docs/backlog.md`);
+  }
+
+  // Step 4: Parse backlog to extract structure
+  const backlog = {
+    milestones: generator.generateMilestones(analysis, template),
+    stories: generator.generateStories(analysis, template)
+  };
+
+  // Step 5: Confirm before creating on GitHub
+  logger.newline();
+  logger.section('📦 GitHub Setup Plan');
+  logger.info(`Milestones to create: ${backlog.milestones.length}`);
+  logger.info(`Issues to create: ${backlog.stories.length}`);
+  logger.info(`Labels: Priority, Status, Story Points, Epics`);
+  logger.newline();
+
+  if (options.dryRun) {
+    logger.warn('DRY RUN - No changes will be made');
+    logger.json({ backlog });
+    return;
+  }
+
+  if (!options.auto) {
+    const { proceed } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'proceed',
+      message: 'Proceed with GitHub setup?',
+      default: true
+    }]);
+
+    if (!proceed) {
+      logger.info('Setup cancelled');
+      return;
+    }
+  }
+
+  // Step 6: Initialize GitHub client
+  const github = new GitHubClient();
+
+  spinner.start('Initializing GitHub client...');
+  const initialized = await github.init();
+
+  if (!initialized) {
+    spinner.fail('GitHub initialization failed');
+    return;
+  }
+
+  spinner.succeed('GitHub client ready');
+
+  // Get repo info
+  const repoInfo = await github.getRepoInfo();
+  if (repoInfo) {
+    logger.info(`Repository: ${repoInfo.fullName}`);
+    logger.newline();
+  }
+
+  // Step 7: Create milestones
+  spinner.start('Creating milestones...');
+  try {
+    await github.createMilestones(backlog.milestones);
+    spinner.succeed(`Created ${backlog.milestones.length} milestones`);
+  } catch (error) {
+    spinner.fail('Milestone creation failed');
+    logger.error(error.message);
+  }
+
+  // Step 8: Create labels
+  spinner.start('Creating labels...');
+  try {
+    const epicLabels = (analysis.techStack || []).map((tech, i) => ({
+      name: `Epic:E${i + 1}-${tech}`,
+      color: '0e8a16'
+    }));
+
+    await github.createLabels(epicLabels);
+    spinner.succeed('Labels created');
+  } catch (error) {
+    spinner.fail('Label creation failed');
+    logger.error(error.message);
+  }
+
+  // Step 9: Create issues
+  spinner.start('Creating issues...');
+  try {
+    await github.createIssues(backlog.stories, backlog.milestones);
+    spinner.succeed(`Created ${backlog.stories.length} issues`);
+  } catch (error) {
+    spinner.fail('Issue creation failed');
+    logger.error(error.message);
+  }
+
+  // Step 10: Success summary
+  logger.newline();
+  logger.section('✅ Setup Complete!');
+  logger.newline();
+
+  if (repoInfo) {
+    logger.info(`📊 Milestones: ${repoInfo.url}/milestones`);
+    logger.info(`📝 Issues: ${repoInfo.url}/issues`);
+    logger.newline();
+  }
+
+  logger.info('💡 Next steps:');
+  logger.dim('  1. Create a GitHub Project Board manually');
+  logger.dim('  2. Add all issues to the project');
+  logger.dim('  3. Configure project views');
+  logger.newline();
+
+  logger.info('🎯 Or run:');
+  logger.dim('  $ gh project create --owner <user> --title "<Name>"');
+  logger.dim('  $ den add-to-project <project-number>');
+  logger.newline();
+}
+
+async function selectTemplate() {
+  const { template } = await inquirer.prompt([{
+    type: 'list',
+    name: 'template',
+    message: 'Select a template:',
+    choices: [
+      { name: '📦 Simple (3 milestones, ~10 issues)', value: 'simple' },
+      { name: '🚀 Startup MVP (4 milestones, ~30 issues)', value: 'startup' },
+      { name: '🏃 Agile/Scrum (Sprint-based)', value: 'agile' },
+      { name: '🏢 Enterprise (5+ phases)', value: 'enterprise' }
+    ]
+  }]);
+
+  return template;
+}

package/src/commands/templates.js

@@ -0,0 +1,71 @@
+import { Logger } from '../utils/logger.js';
+
+const TEMPLATES = {
+  simple: {
+    name: 'Simple',
+    description: 'Basic 3-milestone structure for small projects',
+    milestones: 3,
+    issues: '~10',
+    bestFor: 'Personal projects, side projects'
+  },
+  startup: {
+    name: 'Startup MVP',
+    description: 'MVP-focused with 4 milestones',
+    milestones: 4,
+    issues: '~30',
+    bestFor: 'Startups, product development'
+  },
+  agile: {
+    name: 'Agile/Scrum',
+    description: 'Sprint-based with recurring milestones',
+    milestones: 'Flexible (sprints)',
+    issues: '~50',
+    bestFor: 'Teams using Scrum/Agile'
+  },
+  enterprise: {
+    name: 'Enterprise',
+    description: 'Comprehensive 5+ phase structure',
+    milestones: '5+',
+    issues: '50+',
+    bestFor: 'Large organizations, complex projects'
+  }
+};
+
+export async function templatesCommand(options) {
+  const logger = new Logger();
+
+  if (options.list || !options.show) {
+    logger.section('📋 Available Templates');
+    logger.newline();
+
+    for (const [key, template] of Object.entries(TEMPLATES)) {
+      logger.bold(`${template.name} (${key})`);
+      logger.dim(`  ${template.description}`);
+      logger.info(`  Milestones: ${template.milestones} | Issues: ${template.issues}`);
+      logger.dim(`  Best for: ${template.bestFor}`);
+      logger.newline();
+    }
+
+    logger.info('💡 Usage:');
+    logger.dim('  $ den init --template simple');
+    logger.dim('  $ den init --template startup');
+    logger.newline();
+  }
+
+  if (options.show) {
+    const template = TEMPLATES[options.show];
+
+    if (!template) {
+      logger.error(`Template "${options.show}" not found`);
+      return;
+    }
+
+    logger.section(`📋 Template: ${template.name}`);
+    logger.newline();
+    logger.info(`Description: ${template.description}`);
+    logger.info(`Milestones: ${template.milestones}`);
+    logger.info(`Expected Issues: ${template.issues}`);
+    logger.info(`Best For: ${template.bestFor}`);
+    logger.newline();
+  }
+}