den-github-manager 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-02-06
+
+### Added
+- Initial release of den-github-manager
+- Project analyzer to detect structure and status
+- Backlog generator with 4 templates (Simple, Startup, Agile, Enterprise)
+- GitHub integration for milestones, labels, and issues creation
+- Interactive CLI with `init`, `analyze`, `templates`, and `config` commands
+- Auto-mode for CI/CD integration
+- Dry-run support for testing
+- Configuration management
+- Comprehensive README and documentation
+
+### Features
+- Smart project analysis
+- Template-based backlog generation
+- Automatic GitHub setup
+- Multiple templates for different project types
+- Works with new and existing projects
+
+### Templates
+- Simple: 3 milestones, ~10 issues
+- Startup MVP: 4 milestones, ~30 issues
+- Agile/Scrum: Sprint-based
+- Enterprise: 5+ phases
+
+## [Unreleased]
+
+### Planned
+- Project board auto-creation
+- AI-powered backlog generation
+- Multi-repo support
+- Web UI
+- GitHub Actions integration

package/CONTRIBUTING.md

@@ -0,0 +1,91 @@
+# Contributing to Den GitHub Manager
+
+First off, thank you for considering contributing to Den GitHub Manager! 🎉
+
+## How Can I Contribute?
+
+### Reporting Bugs
+
+Before creating bug reports, please check the issue list as you might find out that you don't need to create one. When you are creating a bug report, please include as many details as possible:
+
+* Use a clear and descriptive title
+* Describe the exact steps to reproduce the problem
+* Provide specific examples
+* Describe the behavior you observed and what you expected
+* Include screenshots if relevant
+* Include your environment (OS, Node version, etc.)
+
+### Suggesting Enhancements
+
+Enhancement suggestions are tracked as GitHub issues. When creating an enhancement suggestion, please include:
+
+* A clear and descriptive title
+* A detailed description of the proposed functionality
+* Explain why this enhancement would be useful
+* List any alternative solutions you've considered
+
+### Pull Requests
+
+1. Fork the repo and create your branch from `main`
+2. If you've added code, add tests
+3. Ensure the test suite passes
+4. Make sure your code lints
+5. Issue that pull request!
+
+## Development Setup
+
+```bash
+# Clone your fork
+git clone https://github.com/YOUR_USERNAME/den-github-manager.git
+cd den-github-manager
+
+# Install dependencies
+npm install
+
+# Run in development
+npm start -- init
+
+# Run tests
+npm test
+
+# Lint
+npm run lint
+```
+
+## Project Structure
+
+```
+src/
+├── commands/       # CLI commands
+├── core/           # Core functionality
+└── utils/          # Utilities
+
+bin/                # CLI executable
+templates/          # Project templates
+```
+
+## Coding Standards
+
+* Use ES modules (import/export)
+* Follow existing code style
+* Add JSDoc comments for public APIs
+* Write meaningful commit messages
+
+## Commit Messages
+
+* Use the present tense ("Add feature" not "Added feature")
+* Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
+* Limit the first line to 72 characters
+* Reference issues and pull requests
+
+## Testing
+
+* Write tests for new features
+* Ensure all tests pass before submitting PR
+* Aim for high code coverage
+
+## Questions?
+
+Feel free to open an issue with your question or reach out in Discussions.
+
+Thank you! ❤️

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wolfcito (@akawolfcito)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PRE_PUBLISH_CHECKLIST.md

@@ -0,0 +1,165 @@
+# Pre-Publish Checklist
+
+## ✅ Pre-Publication Testing
+
+### 1. Code Quality
+- [ ] No syntax errors
+- [ ] All imports/exports work
+- [ ] ESLint passes (if configured)
+- [ ] Code is formatted
+
+### 2. Dependencies
+- [ ] All dependencies in package.json
+- [ ] No missing imports
+- [ ] Version numbers are correct
+- [ ] Peer dependencies declared
+
+### 3. Executable
+- [ ] bin/den.js has correct shebang
+- [ ] bin/den.js is executable (chmod +x)
+- [ ] Runs without errors
+
+### 4. Local Testing
+- [ ] `npm link` works
+- [ ] Commands work: init, analyze, templates, config
+- [ ] Test in different project
+- [ ] Works with/without existing backlog
+- [ ] GitHub integration works
+
+### 5. Package Metadata
+- [ ] package.json has correct info
+- [ ] README is complete
+- [ ] LICENSE is included
+- [ ] Version number is correct
+- [ ] Keywords are relevant
+
+### 6. Files
+- [ ] .npmignore configured
+- [ ] Only necessary files in package
+- [ ] No sensitive data (tokens, keys)
+
+### 7. Documentation
+- [ ] README has examples
+- [ ] Installation instructions clear
+- [ ] Usage examples work
+- [ ] All commands documented
+
+### 8. Publishing
+- [ ] Logged into npm (`npm whoami`)
+- [ ] Package name available
+- [ ] Git committed and pushed
+- [ ] Tagged version (`git tag v1.0.0`)
+
+## 🧪 Testing Commands
+
+```bash
+# 1. Check syntax
+node --check bin/den.js
+
+# 2. Install dependencies
+npm install
+
+# 3. Link locally
+npm link
+
+# 4. Test help
+den --help
+
+# 5. Test analyze
+cd ../test-project
+den analyze
+
+# 6. Test init (dry-run)
+den init --dry-run
+
+# 7. Unlink
+npm unlink -g den-github-manager
+
+# 8. Pack and inspect
+npm pack
+tar -xzf den-github-manager-1.0.0.tgz
+ls -la package/
+
+# 9. Install from tarball
+npm install -g den-github-manager-1.0.0.tgz
+den --version
+
+# 10. Final test
+cd ../another-project
+den init --template simple --dry-run
+```
+
+## 🚀 Publication Steps
+
+```bash
+# 1. Ensure everything is committed
+git status
+
+# 2. Run tests
+npm test
+
+# 3. Build if needed
+npm run build
+
+# 4. Check what will be published
+npm pack --dry-run
+
+# 5. Login to npm
+npm login
+
+# 6. Publish
+npm publish
+
+# 7. Verify on npm
+npm view den-github-manager
+
+# 8. Create GitHub release
+gh release create v1.0.0 \
+  --title "v1.0.0 - Initial Release" \
+  --notes "Initial release with MVP functionality"
+```
+
+## 🔍 Post-Publish Verification
+
+```bash
+# Uninstall local version
+npm uninstall -g den-github-manager
+
+# Install from npm
+npm install -g den-github-manager
+
+# Test
+den --version
+den --help
+den analyze
+
+# Test in real project
+cd ~/projects/my-app
+den init --dry-run
+```
+
+## ❌ Common Issues
+
+### Shebang not working
+```bash
+chmod +x bin/den.js
+```
+
+### Module not found
+- Check all imports use `.js` extension
+- Verify package.json has `"type": "module"`
+
+### Command not found after install
+- Check `bin` field in package.json
+- Verify executable permissions
+
+### GitHub integration fails
+- Ensure `gh` CLI is installed
+- Check `gh auth status`
+
+## 📝 Notes
+
+- First publication cannot be unpublished after 72 hours
+- Choose package name carefully
+- Test thoroughly before publishing
+- Version numbers cannot be reused

package/README.md

@@ -0,0 +1,307 @@
+# 🦁 Den GitHub Manager
+
+> Automate your GitHub Projects setup in minutes. Analyze projects, generate backlogs, and configure milestones, issues, and project boards - all from the command line.
+
+[![npm version](https://img.shields.io/npm/v/den-github-manager.svg)](https://www.npmjs.com/package/den-github-manager)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## ✨ Features
+
+- 🔍 **Smart Analysis** - Automatically analyzes your project structure
+- 📋 **Auto-Generate Backlog** - Creates backlog from your codebase if none exists
+- 🎨 **Multiple Templates** - Simple, Startup MVP, Agile, Enterprise
+- 🚀 **One Command Setup** - Configure everything in minutes
+- 💾 **Reusable** - Works with any project, new or existing
+- 🤖 **GitHub Integration** - Creates milestones, issues, labels automatically
+
+## 🚀 Quick Start
+
+### Install
+
+```bash
+# Global installation
+npm install -g den-github-manager
+
+# Or use with npx (no installation needed)
+npx den-github-manager init
+```
+
+### Basic Usage
+
+```bash
+# Navigate to your project
+cd my-project
+
+# Initialize GitHub project setup
+den init
+
+# That's it! Follow the interactive prompts
+```
+
+## 📖 Usage
+
+### Initialize Project Setup
+
+```bash
+# Interactive mode (recommended for first time)
+den init
+
+# Use specific template
+den init --template startup
+
+# Auto mode (no prompts, use defaults)
+den init --auto
+
+# Dry run (see what would be done)
+den init --dry-run
+```
+
+### Analyze Project
+
+```bash
+# Get detailed project analysis
+den analyze
+
+# Output as JSON
+den analyze --json
+```
+
+### List Templates
+
+```bash
+# See available templates
+den templates --list
+
+# Show template details
+den templates --show startup
+```
+
+### Configuration
+
+```bash
+# List all configuration
+den config --list
+
+# Set config value
+den config --set defaultTemplate=agile
+
+# Get config value
+den config --get defaultTemplate
+```
+
+## 🎨 Templates
+
+### 📦 Simple
+- **Best for:** Personal projects, side projects
+- **Milestones:** 3 (Foundation, Core, Polish)
+- **Issues:** ~10
+- **Duration:** Flexible
+
+### 🚀 Startup MVP
+- **Best for:** Startups, product development
+- **Milestones:** 4 (Foundation, MVP Core, User Testing, Production)
+- **Issues:** ~30
+- **Duration:** 2-3 months
+
+### 🏃 Agile/Scrum
+- **Best for:** Teams using Agile/Scrum
+- **Milestones:** Sprint-based (recurring)
+- **Issues:** ~50
+- **Duration:** 2-week sprints
+
+### 🏢 Enterprise
+- **Best for:** Large organizations, complex projects
+- **Milestones:** 5+ phases (Discovery, Design, Development, Testing, Deployment)
+- **Issues:** 50+
+- **Duration:** 6+ months
+
+## 📊 What Gets Created
+
+When you run `den init`, it creates:
+
+### Milestones
+- Organized phases/sprints with descriptions
+- Properly configured (open/closed based on completion)
+
+### Labels
+- **Priority:** P0:Critical, P1:High, P2:Medium
+- **Status:** in-progress, completed
+- **Story Points:** 3, 5, 8
+- **Epics:** Custom based on your project
+
+### Issues
+- Structured user stories
+- Acceptance criteria
+- Labels and milestones assigned
+- Story points estimated
+
+### Documentation
+- `docs/backlog.md` - Complete backlog
+- `.den-config.json` - Project configuration
+
+## 🔧 Requirements
+
+- **Node.js** >= 18.0.0
+- **GitHub CLI** (`gh`) installed and authenticated
+- **Git** repository initialized
+
+### Setup GitHub CLI
+
+```bash
+# Install gh CLI
+brew install gh  # macOS
+# or visit: https://cli.github.com/
+
+# Authenticate
+gh auth login
+```
+
+## 💡 Examples
+
+### New Project
+
+```bash
+$ cd my-new-app
+$ den init
+
+🦁 Den GitHub Manager - Project Setup
+
+🔍 Analyzing project...
+✓ Project analyzed
+
+❌ No backlog found
+
+? How would you like to proceed?
+  ❯ 📋 Use a template (recommended)
+    🤖 Generate from project structure
+    ✍️  Create manually later
+
+? Select a template:
+  ❯ 🚀 Startup MVP (4 milestones, ~30 issues)
+
+✓ Backlog generated
+✓ GitHub client ready
+✓ Created 4 milestones
+✓ Labels created
+✓ Created 28 issues
+
+✅ Setup Complete!
+
+📊 View: https://github.com/user/my-new-app/milestones
+```
+
+### Existing Project with Backlog
+
+```bash
+$ cd existing-project
+$ den init
+
+🦁 Den GitHub Manager - Project Setup
+
+🔍 Analyzing project...
+✓ Found backlog: docs/backlog.md
+✓ Detected structure:
+  - 4 milestones
+  - 32 user stories
+
+? Proceed with this structure? Yes
+
+✓ Created 4 milestones
+✓ Labels created
+✓ Created 32 issues
+
+✅ Setup Complete!
+```
+
+## 🎯 Use Cases
+
+| Project Type | Recommended Template | Setup Time |
+|--------------|---------------------|------------|
+| Personal side project | Simple | 2 min |
+| Startup MVP | Startup | 3 min |
+| Team project (Agile) | Agile | 5 min |
+| Enterprise application | Enterprise | 10 min |
+| Open source library | Simple/Agile | 3 min |
+
+## 🤝 Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details.
+
+```bash
+# Clone repository
+git clone https://github.com/wolfcito/den-github-manager.git
+cd den-github-manager
+
+# Install dependencies
+npm install
+
+# Run locally
+npm start -- init
+
+# Run tests
+npm test
+
+# Lint code
+npm run lint
+```
+
+## 📚 Documentation
+
+- [Installation Guide](docs/installation.md)
+- [Usage Guide](docs/usage.md)
+- [Templates Guide](docs/templates.md)
+- [Configuration](docs/configuration.md)
+- [API Reference](docs/api.md)
+
+## 🐛 Troubleshooting
+
+### GitHub CLI not authenticated
+```bash
+gh auth login
+```
+
+### Permission denied
+Make sure gh CLI has necessary scopes:
+```bash
+gh auth refresh -s project,repo
+```
+
+### Template not found
+List available templates:
+```bash
+den templates --list
+```
+
+## 🗺️ Roadmap
+
+- [x] v1.0 - Core functionality
+- [ ] v1.1 - Project board auto-creation
+- [ ] v1.2 - AI-powered backlog generation
+- [ ] v1.3 - Multi-repo support
+- [ ] v2.0 - Web UI
+
+## 📄 License
+
+MIT © [wolfcito](https://github.com/wolfcito)
+
+## 🙏 Acknowledgments
+
+Built with:
+- [Commander.js](https://github.com/tj/commander.js/) - CLI framework
+- [Inquirer.js](https://github.com/SBoudrias/Inquirer.js/) - Interactive prompts
+- [Chalk](https://github.com/chalk/chalk) - Terminal styling
+- [Octokit](https://github.com/octokit/octokit.js) - GitHub API client
+
+## 🌟 Star History
+
+If this tool helps you, consider giving it a star! ⭐
+
+## 📞 Support
+
+- 🐛 [Report a bug](https://github.com/wolfcito/den-github-manager/issues)
+- 💡 [Request a feature](https://github.com/wolfcito/den-github-manager/issues)
+- 💬 [Discussions](https://github.com/wolfcito/den-github-manager/discussions)
+
+---
+
+Made with ❤️ by [wolfcito](https://github.com/wolfcito)

package/bin/den.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import chalk from 'chalk';
+import { initCommand } from '../src/commands/init.js';
+import { analyzeCommand } from '../src/commands/analyze.js';
+import { templatesCommand } from '../src/commands/templates.js';
+import { configCommand } from '../src/commands/config.js';
+
+const pkg = {
+  name: 'den-github-manager',
+  version: '1.0.0',
+  description: 'CLI tool to setup GitHub Projects automatically'
+};
+
+console.log(chalk.blue.bold(`\n🦁 ${pkg.name} v${pkg.version}`));
+console.log(chalk.gray('GitHub Project Management Made Easy\n'));
+
+program
+  .name('den')
+  .description(pkg.description)
+  .version(pkg.version);
+
+// Init command - Main setup
+program
+  .command('init')
+  .description('Initialize GitHub Project setup for current repository')
+  .option('-t, --template <name>', 'Use specific template (simple, startup, agile, enterprise)')
+  .option('-a, --auto', 'Auto mode - use defaults without prompts')
+  .option('-d, --dry-run', 'Show what would be done without executing')
+  .option('--repo <owner/repo>', 'Target repository (default: current)')
+  .action(initCommand);
+
+// Analyze command
+program
+  .command('analyze')
+  .description('Analyze current project structure')
+  .option('--json', 'Output as JSON')
+  .action(analyzeCommand);
+
+// Templates command
+program
+  .command('templates')
+  .description('List or manage templates')
+  .option('-l, --list', 'List available templates')
+  .option('-s, --show <name>', 'Show template details')
+  .action(templatesCommand);
+
+// Config command
+program
+  .command('config')
+  .description('Configure den-github-manager settings')
+  .option('--set <key=value>', 'Set configuration value')
+  .option('--get <key>', 'Get configuration value')
+  .option('--list', 'List all configuration')
+  .action(configCommand);
+
+// Parse arguments
+program.parse(process.argv);
+
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+  console.log(chalk.yellow('\n💡 Quick start:'));
+  console.log(chalk.gray('  $ den init                 # Interactive setup'));
+  console.log(chalk.gray('  $ den init --template agile --auto'));
+  console.log(chalk.gray('  $ den analyze              # Analyze project'));
+  console.log(chalk.gray('  $ den templates --list     # Show templates\n'));
+}