@aicgen/aicgen 1.0.0-beta.1

package/packaging/macos/scripts/postinstall

@@ -0,0 +1,12 @@
+#!/bin/bash
+# MacOS Post-install script
+
+# Ensure /usr/local/bin exists
+if [ ! -d "/usr/local/bin" ]; then
+    mkdir -p "/usr/local/bin"
+fi
+
+# Link is handled by pkgbuild usually, but we can double check permission
+chmod +x "/usr/local/bin/aicgen"
+
+exit 0

package/packaging/windows/setup.nsi

@@ -0,0 +1,92 @@
+; aicgen Installer Script
+!include "MUI2.nsh"
+
+; General
+Name "aicgen"
+OutFile "..\..\dist\aicgen-setup-x64.exe"
+Unicode True
+InstallDir "$PROGRAMFILES64\aicgen"
+InstallDirRegKey HKCU "Software\aicgen" ""
+RequestExecutionLevel admin
+
+; Version Information
+VIProductVersion "1.0.0.0"
+VIAddVersionKey "ProductName" "aicgen"
+VIAddVersionKey "CompanyName" "lpsandaruwan"
+VIAddVersionKey "LegalCopyright" "© 2025 lpsandaruwan"
+VIAddVersionKey "FileDescription" "AI Config Generator Installer"
+VIAddVersionKey "FileVersion" "1.0.0.0"
+
+; Icons (Uncomment if .ico files are present in packaging/windows)
+; !define MUI_ICON "install.ico"
+; !define MUI_UNICON "uninstall.ico"
+
+; UI Interface
+!define MUI_ABORTWARNING
+!insertmacro MUI_PAGE_WELCOME
+!insertmacro MUI_PAGE_LICENSE "..\..\LICENSE"
+!insertmacro MUI_PAGE_DIRECTORY
+!insertmacro MUI_PAGE_INSTFILES
+!insertmacro MUI_PAGE_FINISH
+
+!insertmacro MUI_UNPAGE_WELCOME
+!insertmacro MUI_UNPAGE_CONFIRM
+!insertmacro MUI_UNPAGE_INSTFILES
+!insertmacro MUI_UNPAGE_FINISH
+
+!insertmacro MUI_LANGUAGE "English"
+
+; Installer
+Section "aicgen (required)" SecCore
+  SectionIn RO
+  
+  SetOutPath "$INSTDIR"
+  
+  ; Files to install
+  File "..\..\dist\aicgen.exe"
+  File "..\..\LICENSE"
+  File "..\..\README.md"
+  
+  ; Write Uninstaller
+  WriteUninstaller "$INSTDIR\uninstall.exe"
+  
+  ; Start Menu Shortcuts
+  CreateDirectory "$SMPROGRAMS\aicgen"
+  CreateShortcut "$SMPROGRAMS\aicgen\aicgen.lnk" "$INSTDIR\aicgen.exe"
+  CreateShortcut "$SMPROGRAMS\aicgen\Uninstall.lnk" "$INSTDIR\uninstall.exe"
+  
+  ; Registry keys for Add/Remove programs
+  WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\aicgen" "DisplayName" "aicgen"
+  WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\aicgen" "UninstallString" '"$INSTDIR\uninstall.exe"'
+  WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\aicgen" "Publisher" "lpsandaruwan"
+  WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\aicgen" "DisplayVersion" "1.0.0"
+  
+  ; Add to PATH
+  EnVar::SetHKLM
+  EnVar::AddValue "path" "$INSTDIR"
+SectionEnd
+
+; Uninstaller
+Section "Uninstall"
+  ; Remove files
+  Delete "$INSTDIR\aicgen.exe"
+  Delete "$INSTDIR\LICENSE"
+  Delete "$INSTDIR\README.md"
+  Delete "$INSTDIR\uninstall.exe"
+  
+  ; Remove shortcuts
+  Delete "$SMPROGRAMS\aicgen\aicgen.lnk"
+  Delete "$SMPROGRAMS\aicgen\Uninstall.lnk"
+  RMDir "$SMPROGRAMS\aicgen"
+  
+  ; Remove install dir
+  RMDir "$INSTDIR"
+  
+  ; Remove from PATH
+  EnVar::SetHKLM
+  EnVar::DeleteValue "path" "$INSTDIR"
+  
+  ; Remove registry keys
+  DeleteRegKey HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\aicgen"
+  DeleteRegKey HKCU "Software\aicgen"
+SectionEnd

package/planning/BRANDING-SUMMARY.md

@@ -0,0 +1,194 @@
+# Branding Implementation Complete ✅
+
+## What Was Created
+
+### 1. SVG Logo (`assets/logo.svg`)
+- **Design**: Abstract AI → Config transformation
+- **Colors**: Cyan (#06b6d4) → Purple (#a855f7) gradient
+- **Features**:
+  - Neural network nodes (left)
+  - Flow arrows (center)
+  - Document shapes (right)
+  - Animated sparkle particles
+  - Glow effects
+- **Size**: 400x400px, scalable vector
+- **Use**: README, docs, web, social media
+
+### 2. ASCII Art Logo (`assets/logo-ascii.txt`)
+- **Versions**:
+  - Large (main banner)
+  - Medium (compact)
+  - Small (inline)
+  - Minimal (loading)
+- **Colors**: Cyan nodes → Purple docs (with chalk)
+- **Use**: Terminal display
+
+### 3. Banner Utility (`src/utils/banner.ts`)
+Functions:
+```typescript
+showBanner()              // Full logo + version
+showInstructions()        // Navigation help
+showCheckboxInstructions() // Checkbox tips
+getLogoPrefix(animated?)  // Small animated logo
+showSmallLogo()          // Compact version
+```
+
+### 4. Updated Files
+- `README.md` - Logo header, updated features, guidelines system
+- `src/commands/init.ts` - Now shows banner at start
+- `assets/README.md` - Complete branding guide
+- `BRANDING.md` - Usage documentation
+
+## Visual Output
+
+### Terminal Banner (when running `aicgen init`)
+```
+   ●        ╱╲
+  ●  ╲    ╱  ╲    ╭─────────╮
+ ●    ╲  ╱    ╲   │ ≡≡≡≡≡≡  │
+  ●    ╲╱  ▶▶  ╲  │ ≡≡≡≡    │
+   ●   ╱╲      ╱  │ ≡≡≡≡≡   │
+      ╱  ╲    ╱   ╰─────────╯
+           ╲╱         ✓
+
+       aicgen · AI Config Generator
+
+   Version 0.1.0 · MIT License
+
+   Navigation:
+   ↑↓ arrows    - Navigate options
+   Space        - Select/deselect (checkboxes)
+   Enter        - Confirm selection
+   Ctrl+C       - Cancel anytime
+```
+
+### README Header (on GitHub)
+```markdown
+[Logo Image - centered]
+
+aicgen
+AI Config Generator
+
+Enterprise-grade configuration generator for AI coding assistants
+
+[Version Badge] [License Badge] [Bun Badge]
+```
+
+### Loading States
+```
+◉ ▶ ▢   Generating...       (frame 1)
+◉ ▶▶ ▢  Generating...       (frame 2)
+◉ ▶▶▶ ▣ Generating...       (frame 3)
+◉ ▶ ✓  Generated!           (frame 4)
+```
+
+## Color Palette
+
+### Primary
+- **Cyan**: `#06b6d4` - Technology, terminals, code
+- **Purple**: `#a855f7` - AI, intelligence, creativity
+
+### Accent
+- **White**: `#ffffff` - Text, emphasis
+- **Gray**: `#6b7280` - Secondary text
+- **Green**: `#10b981` - Success states
+
+### Usage in Code
+```typescript
+import chalk from 'chalk';
+
+console.log(chalk.cyan('●'));        // Nodes
+console.log(chalk.magenta('▶▶'));    // Flow
+console.log(chalk.gray('≡≡≡'));      // Code lines
+console.log(chalk.green('✓'));       // Success
+```
+
+## Integration Points
+
+### Current Usage
+- ✅ `init` command shows banner on start
+- ✅ README displays logo and branding
+- ✅ Navigation instructions shown to users
+- ✅ Checkbox help with logo tip
+
+### Future Usage Opportunities
+- Loading spinners with logo prefix
+- Error messages with logo
+- Success confirmations with logo
+- Stats command output
+- Help command branding
+
+## Files Created
+
+1. `assets/logo.svg` - Full color vector logo
+2. `assets/logo-ascii.txt` - All ASCII art versions
+3. `assets/README.md` - Branding guidelines
+4. `src/utils/banner.ts` - Banner utility functions
+5. `BRANDING.md` - Implementation documentation
+6. `BRANDING-SUMMARY.md` - This file
+
+## Files Modified
+
+1. `README.md` - Added logo, updated features
+2. `src/commands/init.ts` - Added banner imports and display
+
+## TypeScript Compilation
+
+✅ All code compiles successfully
+```bash
+npx tsc --noEmit
+# No errors
+```
+
+## Testing
+
+To test the branding:
+
+```bash
+# Build binary
+bun run build:binary:windows
+
+# Run init to see banner
+./aicgen.exe init
+```
+
+Expected output:
+1. ASCII logo with cyan/purple colors
+2. Version and license info
+3. Navigation instructions
+4. Continues to wizard...
+
+## Design Philosophy
+
+**Modern & Technical**: Reflects CLI tool nature
+**Abstract & Clean**: Professional, not playful
+**Gradient Flow**: Represents transformation
+**Recognizable**: Works at any size
+
+## Impact
+
+### User Experience
+- ✅ Professional first impression
+- ✅ Clear brand identity
+- ✅ Helpful navigation guidance
+- ✅ Consistent visual language
+
+### Marketing
+- ✅ GitHub-ready README with logo
+- ✅ Social media sharing image
+- ✅ Professional appearance for adoption
+- ✅ Memorable visual identity
+
+## Next Steps (Optional Future Enhancements)
+
+1. **Favicon** - Export 32x32, 64x64 for web
+2. **Social Card** - 1200x630 for Twitter/OG
+3. **Icon Pack** - Various sizes for installers
+4. **Animated GIF** - Terminal recording for README
+5. **More loading states** - Different operations with different animations
+
+---
+
+**Status**: ✅ Complete and production-ready
+**Date**: 2025-12-08
+**Version**: 0.1.0

package/planning/BRANDING.md

@@ -0,0 +1,174 @@
+# aicgen Branding Implementation
+
+## ✅ Completed
+
+### 1. SVG Logo (`assets/logo.svg`)
+
+**Design**: Abstract representation of AI → Config Generation
+- Neural network nodes (left) representing AI intelligence
+- Flow arrows showing transformation process
+- Document shapes (right) representing generated config files
+- Animated sparkle particles for dynamic feel
+
+**Colors**:
+- Primary: Cyan (`#06b6d4`) - Tech, terminals
+- Accent: Purple/Magenta (`#a855f7`) - AI, creativity
+- Gradient: Cyan → Purple - Transformation flow
+
+**Features**:
+- 400x400px scalable SVG
+- Glow effects and animations
+- Optimized for web/docs display
+
+### 2. ASCII Art Versions (`assets/logo-ascii.txt`)
+
+**Large** - Main banner:
+```
+    ●        ╱╲
+   ●  ╲    ╱  ╲    ╭─────────╮
+  ●    ╲  ╱    ╲   │ ≡≡≡≡≡≡  │
+   ●    ╲╱  ▶▶  ╲  │ ≡≡≡≡    │
+    ●   ╱╲      ╱  │ ≡≡≡≡≡   │
+       ╱  ╲    ╱   ╰─────────╯
+            ╲╱         ✓
+```
+
+**Medium** - Compact banner:
+```
+     ●
+    ●  ╲     ╭──────╮
+   ●    ╲▶▶  │ ≡≡≡  │
+    ●   ╱    ╰──────╯
+     ●         ✓
+```
+
+**Small** - Status indicator:
+```
+  ●╲
+ ● ╱▶ ▢
+  ●╱
+```
+
+**Minimal** - Loading animation:
+```
+◉ ▶ ▢   →   ◉ ▶▶ ▢   →   ◉ ▶▶▶ ▣   →   ◉ ▶ ✓
+```
+
+### 3. Banner Utility (`src/utils/banner.ts`)
+
+**Functions**:
+- `showBanner()` - Full logo with name and version
+- `showInstructions()` - Navigation help
+- `showCheckboxInstructions()` - Checkbox-specific help
+- `getLogoPrefix(animated?)` - Small animated logo for status
+- `showSmallLogo()` - Compact version
+
+**Implementation**:
+```typescript
+import { showBanner } from './utils/banner.js';
+
+// Show at start of command
+showBanner();
+```
+
+**Output**:
+```
+   ●        ╱╲
+  ●  ╲    ╱  ╲    ╭─────────╮
+ ●    ╲  ╱    ╲   │ ≡≡≡≡≡≡  │
+  ●    ╲╱  ▶▶  ╲  │ ≡≡≡≡    │
+   ●   ╱╲      ╱  │ ≡≡≡≡≡   │
+      ╱  ╲    ╱   ╰─────────╯
+           ╲╱         ✓
+
+       aicgen · AI Config Generator
+
+   Version 0.1.0 · MIT License
+```
+
+### 4. Asset Documentation (`assets/README.md`)
+
+Complete branding guidelines including:
+- Logo concept explanation
+- Color palette with hex codes
+- Usage guidelines
+- Export sizes
+- Design philosophy
+
+## Usage Examples
+
+### Terminal Banner
+```typescript
+import { showBanner, showInstructions } from './utils/banner.js';
+
+export async function initCommand() {
+  showBanner();           // Logo + branding
+  showInstructions();     // Navigation help
+  // ... rest of command
+}
+```
+
+### Loading States
+```typescript
+import ora from 'ora';
+import { getLogoPrefix } from './utils/banner.js';
+
+const spinner = ora({
+  text: 'Generating configuration...',
+  prefixText: getLogoPrefix(true)  // Animated logo
+}).start();
+```
+
+### Status Messages
+```typescript
+console.log(`${getLogoPrefix()} Configuration ready!`);
+// Output: ◉ ▶ ▢ Configuration ready!
+```
+
+### README Header
+```markdown
+<p align="center">
+  <img src="assets/logo.svg" width="200" alt="aicgen" />
+</p>
+
+<h1 align="center">aicgen</h1>
+<p align="center">AI Config Generator</p>
+```
+
+## Visual Identity
+
+### Primary Palette
+- **Cyan**: Technology, terminals, code
+- **Purple**: AI, intelligence, automation
+- **Gradient**: Transformation and flow
+
+### Typography (Terminal)
+- **Brand Name**: Bold white
+- **Tagline**: Gray
+- **Version**: Gray with separator
+
+### Spacing
+- Logo: 2 lines padding top/bottom
+- Version: 1 line below logo
+- Instructions: 1 line below version
+
+## Future Enhancements
+
+### Possible Additions:
+1. **Favicon** - Export 32x32, 64x64 for web
+2. **Social Cards** - 1200x630 for Twitter/OG tags
+3. **Icon Pack** - Various sizes for installers
+4. **Animated GIF** - For README showcase
+5. **Terminal Recording** - Asciinema demo with branding
+
+### Integration Points:
+- Package manager listings (npm, cargo, etc.)
+- Documentation sites
+- GitHub social preview
+- Installation screens
+
+---
+
+**Status**: ✅ Complete and integrated
+**Files**: 4 created (SVG, ASCII, README, Implementation)
+**Impact**: Professional, recognizable brand identity across all touchpoints

package/planning/BUILD.md

@@ -0,0 +1,186 @@
+# Build Instructions
+
+## Prerequisites
+
+- **Bun** >= 1.0.0 installed ([Download](https://bun.sh))
+- Windows, Linux, or macOS
+
+## Quick Build (Current Platform)
+
+```bash
+# Navigate to project
+cd F:\aicgen\aicgen
+
+# Install dependencies
+bun install
+
+# Build standalone executable
+bun run build:binary
+```
+
+This will create `aicgen.exe` (on Windows) in the project root.
+
+## Build for All Platforms
+
+```bash
+# Build for all platforms at once
+bun run build:all
+```
+
+This creates:
+- `aicgen.exe` (Windows)
+- `aicgen-linux` (Linux x64)
+- `aicgen-macos` (macOS ARM64)
+
+## Step-by-Step Build Process
+
+### 1. Install Dependencies
+
+```bash
+bun install
+```
+
+### 2. Pre-build (Generate Profile Files)
+
+```bash
+bun run prebuild
+```
+
+This runs `scripts/prebuild-profiles-chunks.ts` which validates the chunk system.
+
+### 3. Type Check (Optional but Recommended)
+
+```bash
+bun run typecheck
+```
+
+### 4. Build Binary
+
+**Windows:**
+```bash
+bun run build:binary:windows
+```
+
+**Linux:**
+```bash
+bun run build:binary:linux
+```
+
+**macOS:**
+```bash
+bun run build:binary:macos
+```
+
+## Testing the Binary
+
+### On Windows
+
+```bash
+# Test stats command
+.\aicgen.exe stats
+
+# Test init with dry-run
+.\aicgen.exe init --dry-run
+
+# Test full init (creates files)
+.\aicgen.exe init
+```
+
+### On Linux/macOS
+
+```bash
+# Make executable
+chmod +x aicgen-linux
+
+# Test
+./aicgen-linux stats
+./aicgen-linux init --dry-run
+```
+
+## Troubleshooting
+
+### "bun: command not found"
+
+Install Bun:
+```bash
+# Windows (PowerShell)
+powershell -c "irm bun.sh/install.ps1 | iex"
+
+# Linux/macOS
+curl -fsSL https://bun.sh/install | bash
+```
+
+### "Permission denied" on Linux/macOS
+
+```bash
+chmod +x aicgen-linux
+```
+
+### Build fails with "Cannot find module"
+
+```bash
+# Clean and reinstall
+rm -rf node_modules
+bun install
+bun run build:binary
+```
+
+### Type errors
+
+```bash
+# Check what's wrong
+bun run typecheck
+
+# Often fixed by:
+bun install
+```
+
+## Development Build (No Binary)
+
+For development without creating a binary:
+
+```bash
+# Watch mode (auto-rebuild on changes)
+bun run dev
+
+# Run directly with Bun
+bun run start init
+bun run start stats
+```
+
+## File Sizes
+
+Expected binary sizes:
+- Windows: ~45-50 MB
+- Linux: ~45-50 MB
+- macOS: ~45-50 MB
+
+These are standalone executables with Bun runtime embedded.
+
+## Distribution
+
+After building, you can distribute the binary:
+
+1. **Single file** - No dependencies needed
+2. **Cross-platform** - Build on any OS for any OS
+3. **Fast startup** - Bun's optimized runtime
+
+Share the appropriate binary:
+- `aicgen.exe` for Windows users
+- `aicgen-linux` for Linux users
+- `aicgen-macos` for macOS users
+
+## Next Steps
+
+After building successfully:
+
+```bash
+# Move to a directory in your PATH (optional)
+# Windows: Copy to C:\Windows\System32 or add to PATH
+# Linux/macOS:
+sudo mv aicgen-linux /usr/local/bin/aicgen
+
+# Test in any directory
+cd ~/some-project
+aicgen init
+```