@aicgen/aicgen 1.0.0-beta.1 → 1.0.0

package/src/__tests__/services/tarball-extraction.test.ts

@@ -1,125 +0,0 @@
-import { describe, test, expect } from 'bun:test';
-import { CONFIG } from '../../config.js';
-
-describe('Tarball Extraction Configuration', () => {
-  describe('CONFIG-based Prefix', () => {
-    test('should have correct GitHub owner configured', () => {
-      expect(CONFIG.GITHUB_REPO_OWNER).toBe('aicgen');
-    });
-
-    test('should have correct GitHub repo configured', () => {
-      expect(CONFIG.GITHUB_REPO_NAME).toBe('aicgen-data');
-    });
-
-    test('should construct correct expected prefix', () => {
-      const expectedPrefix = `${CONFIG.GITHUB_REPO_OWNER}-${CONFIG.GITHUB_REPO_NAME}-`;
-      expect(expectedPrefix).toBe('aicgen-aicgen-data-');
-    });
-
-    test('should not use hardcoded lpsandaruwan prefix', () => {
-      const expectedPrefix = `${CONFIG.GITHUB_REPO_OWNER}-${CONFIG.GITHUB_REPO_NAME}-`;
-      expect(expectedPrefix).not.toBe('lpsandaruwan-aicgen-docs-');
-    });
-  });
-
-  describe('Directory Name Matching', () => {
-    test('should match correct tarball directory format', () => {
-      const expectedPrefix = `${CONFIG.GITHUB_REPO_OWNER}-${CONFIG.GITHUB_REPO_NAME}-`;
-      const sampleDirectories = [
-        'aicgen-aicgen-data-abc123',
-        'aicgen-aicgen-data-def456',
-        'aicgen-aicgen-data-1234567890abcdef'
-      ];
-
-      sampleDirectories.forEach(dir => {
-        expect(dir.startsWith(expectedPrefix)).toBe(true);
-      });
-    });
-
-    test('should not match incorrect directory formats', () => {
-      const expectedPrefix = `${CONFIG.GITHUB_REPO_OWNER}-${CONFIG.GITHUB_REPO_NAME}-`;
-      const incorrectDirectories = [
-        'lpsandaruwan-aicgen-docs-abc123',
-        'other-repo-abc123',
-        'random-directory'
-      ];
-
-      incorrectDirectories.forEach(dir => {
-        expect(dir.startsWith(expectedPrefix)).toBe(false);
-      });
-    });
-
-    test('should find correct directory in mixed entries', () => {
-      const expectedPrefix = `${CONFIG.GITHUB_REPO_OWNER}-${CONFIG.GITHUB_REPO_NAME}-`;
-      const entries = [
-        'archive.tar.gz',
-        'aicgen-aicgen-data-abc123',
-        'other-file.md',
-        '.temp'
-      ];
-
-      const rootDir = entries.find(entry => entry.startsWith(expectedPrefix));
-      expect(rootDir).toBe('aicgen-aicgen-data-abc123');
-    });
-  });
-
-  describe('GitHub API URLs', () => {
-    test('should construct correct releases URL', () => {
-      const repoUrl = `${CONFIG.GITHUB_API_BASE}/repos/${CONFIG.GITHUB_REPO_OWNER}/${CONFIG.GITHUB_REPO_NAME}`;
-      expect(repoUrl).toBe('https://api.github.com/repos/aicgen/aicgen-data');
-    });
-
-    test('should construct correct releases latest URL', () => {
-      const releasesUrl = `${CONFIG.GITHUB_API_BASE}/repos/${CONFIG.GITHUB_REPO_OWNER}/${CONFIG.GITHUB_REPO_NAME}/releases/latest`;
-      expect(releasesUrl).toBe('https://api.github.com/repos/aicgen/aicgen-data/releases/latest');
-    });
-  });
-
-  describe('Cache Directory Structure', () => {
-    test('should have correct cache directory name', () => {
-      expect(CONFIG.CACHE_DIR_NAME).toBe('.aicgen');
-    });
-
-    test('should have correct data directory name', () => {
-      expect(CONFIG.DATA_DIR).toBe('data');
-    });
-
-    test('should have correct cache subdirectory', () => {
-      expect(CONFIG.CACHE_DIR).toBe('cache/official');
-    });
-  });
-
-  describe('Version Management', () => {
-    test('should have valid version format', () => {
-      const version = CONFIG.APP_VERSION;
-      // Valid version: X.Y.Z-prerelease or X.Y-prerelease (e.g., "1.0.0-beta.1" or "1.0-beta")
-      const versionPattern = /^\d+\.\d+(\.\d+)?(-[a-z0-9.]+)?$/i;
-      expect(versionPattern.test(version)).toBe(true);
-    });
-
-    test('should not have invalid version patterns', () => {
-      const version = CONFIG.APP_VERSION;
-      // Should not match invalid patterns like "0.1.0b1" or "0.1b"
-      expect(version).not.toMatch(/\d+\.\d+\.\d+b\d*/);
-      expect(version).not.toMatch(/\d+b$/);
-    });
-  });
-
-  describe('Environment Variable Override', () => {
-    test('should allow GitHub owner override via env', () => {
-      // This tests that the priority system exists (ENV > Config > Default)
-      // Actual override would need to be tested in integration tests
-      const hasEnvSupport = CONFIG.GITHUB_REPO_OWNER === (
-        process.env.AICGEN_GITHUB_OWNER || 'aicgen'
-      );
-      expect(hasEnvSupport).toBe(true);
-    });
-
-    test('should allow GitHub repo override via env', () => {
-      const hasEnvSupport = CONFIG.GITHUB_REPO_NAME === (
-        process.env.AICGEN_GITHUB_REPO || 'aicgen-data'
-      );
-      expect(hasEnvSupport).toBe(true);
-    });
-  });
-});

package/src/commands/add-guideline.ts

@@ -1,296 +0,0 @@
-import { select, input, checkbox, confirm, editor } from '@inquirer/prompts';
-import chalk from 'chalk';
-import { homedir } from 'os';
-import { join, dirname } from 'path';
-import { mkdir, writeFile, readFile, access } from 'fs/promises';
-import YAML from 'yaml';
-import { GuidelineLoader, GuidelineMapping } from '../services/guideline-loader.js';
-import { showBanner } from '../utils/banner.js';
-import { createSummaryBox } from '../utils/formatting.js';
-import { Language } from '../models/project.js';
-import { InstructionLevel, ArchitectureType } from '../models/profile.js';
-import { CONFIG } from '../config.js';
-
-
-const LANGUAGES: { value: Language; name: string }[] = [
-  { value: 'typescript', name: 'TypeScript' },
-  { value: 'javascript', name: 'JavaScript' },
-  { value: 'python', name: 'Python' },
-  { value: 'go', name: 'Go' },
-  { value: 'rust', name: 'Rust' },
-  { value: 'java', name: 'Java' },
-  { value: 'csharp', name: 'C#' },
-  { value: 'ruby', name: 'Ruby' }
-];
-
-const LEVELS: { value: InstructionLevel; name: string }[] = [
-  { value: 'basic', name: 'Basic' },
-  { value: 'standard', name: 'Standard' },
-  { value: 'expert', name: 'Expert' },
-  { value: 'full', name: 'Full' }
-];
-
-const ARCHITECTURES: { value: ArchitectureType; name: string }[] = [
-  { value: 'layered', name: 'Layered' },
-  { value: 'modular-monolith', name: 'Modular Monolith' },
-  { value: 'microservices', name: 'Microservices' },
-  { value: 'event-driven', name: 'Event-Driven' },
-  { value: 'hexagonal', name: 'Hexagonal' },
-  { value: 'clean-architecture', name: 'Clean Architecture' },
-  { value: 'ddd', name: 'Domain-Driven Design' },
-  { value: 'serverless', name: 'Serverless' },
-  { value: 'other', name: 'Other / None' }
-];
-
-export async function addGuidelineCommand() {
-  showBanner();
-
-  console.log(chalk.cyan('\n📝 Add Custom Guideline\n'));
-
-  try {
-    // 1. Load existing guidelines to show categories
-    const loader = await GuidelineLoader.create();
-    const stats = loader.getStats();
-    const existingCategories = Object.keys(stats.byCategory).sort();
-
-    // 2. Select or create category
-    const categoryChoice = await select({
-      message: 'Select category:',
-      choices: [
-        { value: '__new__', name: chalk.green('+ Create new category') },
-        { value: '__separator__', name: chalk.gray('─'.repeat(50)), disabled: true },
-        ...existingCategories.map(c => ({ value: c, name: c })),
-        { value: 'cancel', name: 'Cancel', description: 'Exit' }
-      ]
-    });
-
-    if (categoryChoice === 'cancel') {
-      console.log(chalk.gray('\nCancelled.'));
-      return;
-    }
-
-    let category: string;
-    if (categoryChoice === '__new__') {
-      category = await input({
-        message: 'Category name:',
-        validate: (value) => {
-          if (!value.trim()) return 'Category name is required';
-          if (value.length > 50) return 'Category name too long (max 50 characters)';
-          return true;
-        }
-      });
-    } else {
-      category = categoryChoice;
-    }
-
-    // 3. Guideline details
-    const name = await input({
-      message: 'Guideline name:',
-      validate: (value) => {
-        if (!value.trim()) return 'Name is required';
-        if (value.length > 100) return 'Name too long (max 100 characters)';
-        return true;
-      }
-    });
-
-    const description = await input({
-      message: 'Short description (optional):',
-      default: ''
-    });
-
-    // 4. Applicability - Languages
-    const languageChoice = await select({
-      message: 'Applicable to languages:',
-      choices: [
-        { value: 'all', name: 'All languages' },
-        { value: 'specific', name: 'Specific languages only' }
-      ]
-    });
-
-    let languages: Language[] = [];
-    if (languageChoice === 'specific') {
-      languages = await checkbox({
-        message: 'Select languages:',
-        choices: LANGUAGES.map(l => ({ value: l.value, name: l.name }))
-      }) as Language[];
-
-      if (languages.length === 0) {
-        console.log(chalk.yellow('\n⚠️  No languages selected, applying to all languages'));
-      }
-    }
-
-    // 5. Applicability - Levels
-    const levels = await checkbox({
-      message: 'Applicable to instruction levels:',
-      choices: LEVELS.map(l => ({ value: l.value, name: l.name, checked: true }))
-    }) as InstructionLevel[];
-
-    if (levels.length === 0) {
-      console.log(chalk.yellow('\n⚠️  No levels selected, using all levels'));
-      levels.push('basic', 'standard', 'expert', 'full');
-    }
-
-    // 6. Applicability - Architectures
-    const architectureChoice = await select({
-      message: 'Applicable to architectures:',
-      choices: [
-        { value: 'all', name: 'All architectures' },
-        { value: 'specific', name: 'Specific architectures only' }
-      ]
-    });
-
-    let architectures: ArchitectureType[] = [];
-    if (architectureChoice === 'specific') {
-      architectures = await checkbox({
-        message: 'Select architectures:',
-        choices: ARCHITECTURES.map(a => ({ value: a.value, name: a.name }))
-      }) as ArchitectureType[];
-
-      if (architectures.length === 0) {
-        console.log(chalk.yellow('\n⚠️  No architectures selected, applying to all'));
-      }
-    }
-
-    // 7. Tags
-    const tagsInput = await input({
-      message: 'Tags (comma-separated, optional):',
-      default: ''
-    });
-
-    const tags = tagsInput
-      ? tagsInput.split(',').map(t => t.trim()).filter(t => t.length > 0)
-      : [];
-
-    // 8. Content
-    console.log(chalk.cyan('\n📄 Guideline Content\n'));
-
-    const contentChoice = await select({
-      message: 'How to provide content?',
-      choices: [
-        { value: 'editor', name: 'Open in default editor (recommended)', description: 'Uses $EDITOR or default system editor' },
-        { value: 'file', name: 'Import from file', description: 'Copy content from existing markdown file' },
-        { value: 'inline', name: 'Type inline', description: 'For short content only' }
-      ]
-    });
-
-    let content: string;
-    switch (contentChoice) {
-      case 'file': {
-        const filePath = await input({
-          message: 'File path:',
-          validate: async (value) => {
-            try {
-              await access(value);
-              return true;
-            } catch {
-              return 'File not found';
-            }
-          }
-        });
-        content = await readFile(filePath, 'utf-8');
-        break;
-      }
-
-      case 'editor':
-        content = await editor({
-          message: 'Write your guideline (will open in editor):',
-          default: `# ${name}\n\n${description ? description + '\n\n' : ''}## Overview\n\nWrite your guideline content here...\n\n## Examples\n\n\`\`\`\n// Code examples\n\`\`\`\n\n## Best Practices\n\n- Point 1\n- Point 2\n`
-        });
-        break;
-
-      case 'inline':
-        content = await editor({
-          message: 'Content (markdown):',
-          default: `# ${name}\n\n`
-        });
-        break;
-
-      default:
-        content = '';
-    }
-
-    if (!content.trim()) {
-      console.log(chalk.red('\n❌ Content cannot be empty'));
-      return;
-    }
-
-    // 9. Generate ID and paths
-    const id = generateGuidelineId(category, name);
-    const categorySlug = category.toLowerCase().replace(/\s+/g, '-');
-    const nameSlug = name.toLowerCase().replace(/[^a-z0-9]+/g, '-');
-    const relativePath = `${categorySlug}/${nameSlug}.md`;
-
-    // 10. Show preview
-    console.log('\n' + createSummaryBox('📋 Guideline Preview', [
-      { label: 'ID', value: id },
-      { label: 'Category', value: category },
-      { label: 'Name', value: name },
-      { label: 'Path', value: relativePath },
-      { label: 'Languages', value: languages.length > 0 ? languages.join(', ') : 'All' },
-      { label: 'Levels', value: levels.join(', ') },
-      { label: 'Architectures', value: architectures.length > 0 ? architectures.join(', ') : 'All' },
-      { label: 'Tags', value: tags.length > 0 ? tags.join(', ') : 'None' },
-      { label: 'Size', value: `${content.length} characters, ${content.split('\n').length} lines` }
-    ]));
-
-    const shouldAdd = await confirm({
-      message: 'Add this guideline?',
-      default: true
-    });
-
-    if (!shouldAdd) {
-      console.log(chalk.gray('\nCancelled.'));
-      return;
-    }
-
-    // 11. Write files
-    const userDataPath = join(homedir(), CONFIG.CACHE_DIR_NAME, CONFIG.DATA_DIR);
-    const guidelinePath = join(userDataPath, 'guidelines', relativePath);
-    const mappingsPath = join(userDataPath, 'custom-mappings.yml');
-
-    // Ensure directories exist
-    await mkdir(dirname(guidelinePath), { recursive: true });
-
-    // Write guideline content
-    await writeFile(guidelinePath, content, 'utf-8');
-
-    // Update mappings
-    let mappings: Record<string, GuidelineMapping> = {};
-    try {
-      const mappingsContent = await readFile(mappingsPath, 'utf-8');
-      mappings = YAML.parse(mappingsContent) as Record<string, GuidelineMapping>;
-    } catch {
-      // File doesn't exist yet, start with empty mappings
-    }
-
-    mappings[id] = {
-      path: relativePath,
-      category,
-      ...(languages.length > 0 && { languages }),
-      levels,
-      ...(architectures.length > 0 && { architectures }),
-      ...(tags.length > 0 && { tags })
-    };
-
-    await writeFile(mappingsPath, YAML.stringify(mappings), 'utf-8');
-
-    console.log(chalk.green('\n✅ Guideline added successfully!'));
-    console.log(chalk.gray(`\n   Guideline: ${guidelinePath}`));
-    console.log(chalk.gray(`   Mapping: ${mappingsPath}`));
-    console.log(chalk.cyan(`\n   Run ${chalk.white('aicgen init')} to use your custom guideline`));
-
-  } catch (error) {
-    if ((error as Error).message.includes('User force closed')) {
-      console.log(chalk.gray('\n\nCancelled.'));
-      return;
-    }
-    console.error(chalk.red(`\n❌ ${(error as Error).message}`));
-    process.exit(1);
-  }
-}
-
-function generateGuidelineId(category: string, name: string): string {
-  const categorySlug = category.toLowerCase().replace(/\s+/g, '-');
-  const nameSlug = name.toLowerCase().replace(/[^a-z0-9]+/g, '-');
-  return `custom-${categorySlug}-${nameSlug}`;
-}

package/src/commands/clear.ts

@@ -1,61 +0,0 @@
-import { confirm } from '@inquirer/prompts';
-import chalk from 'chalk';
-import { rm } from 'fs/promises';
-import { join } from 'path';
-import { existsSync } from 'fs';
-
-export async function clearCommand(options: { force?: boolean } = {}) {
-  const projectPath = process.cwd();
-
-  // Define all possible config directories
-  const configDirs = [
-    { path: '.claude', name: 'Claude Code' },
-    { path: '.github/copilot-instructions.md', name: 'GitHub Copilot', isFile: true },
-    { path: '.gemini', name: 'Google Gemini' },
-    { path: '.agent', name: 'Google Antigravity' },
-    { path: '.codex', name: 'Codex' },
-    { path: 'AGENTS.md', name: 'Universal AGENTS.md', isFile: true }
-  ];
-
-  // Find which configs exist
-  const existingConfigs = configDirs.filter(dir =>
-    existsSync(join(projectPath, dir.path))
-  );
-
-  if (existingConfigs.length === 0) {
-    console.log(chalk.gray('\nNo AI configurations found in this project.'));
-    return;
-  }
-
-  console.log(chalk.cyan('\n📂 Found AI Configurations:'));
-  existingConfigs.forEach(config => {
-    console.log(`   • ${config.name} (${config.path})`);
-  });
-
-  if (!options.force) {
-    const shouldDelete = await confirm({
-      message: chalk.yellow('\n⚠️  Delete all AI configurations?'),
-      default: false
-    });
-
-    if (!shouldDelete) {
-      console.log(chalk.gray('\nCancelled.'));
-      return;
-    }
-  }
-
-  // Delete configs
-  let deletedCount = 0;
-  for (const config of existingConfigs) {
-    try {
-      const fullPath = join(projectPath, config.path);
-      await rm(fullPath, { recursive: true, force: true });
-      console.log(chalk.green(`✓ Removed ${config.name}`));
-      deletedCount++;
-    } catch (error) {
-      console.log(chalk.red(`✗ Failed to remove ${config.name}: ${error}`));
-    }
-  }
-
-  console.log(chalk.green(`\n✅ Cleared ${deletedCount} configuration(s)`));
-}

package/src/commands/guideline-selector.ts

@@ -1,123 +0,0 @@
-import { checkbox } from '@inquirer/prompts';
-import chalk from 'chalk';
-import { Language } from '../models/project.js';
-import { InstructionLevel, ArchitectureType, DatasourceType } from '../models/profile.js';
-import { GuidelineLoader } from '../services/guideline-loader.js';
-import { showCheckboxInstructions } from '../utils/banner.js';
-import { BACK_VALUE } from '../utils/wizard-state.js';
-
-interface CheckboxChoice {
-  name: string;
-  value: string;
-  checked?: boolean;
-  disabled?: boolean | string;
-}
-
-export async function selectGuidelines(
-  language: Language,
-  level: InstructionLevel,
-  architecture: ArchitectureType,
-  canGoBack: boolean,
-  datasource?: DatasourceType
-): Promise<string[] | typeof BACK_VALUE> {
-  const loader = await GuidelineLoader.create();
-  const categoryTree = loader.getCategoryTree(language, level, architecture, datasource);
-
-  console.log(chalk.cyan('\n📚 Select Guidelines'));
-  showCheckboxInstructions();
-
-  const allGuidelineIds: string[] = [];
-  const categoryToGuidelines = new Map<string, string[]>();
-  const choices: CheckboxChoice[] = [];
-
-  // Add back option if applicable
-  if (canGoBack) {
-    choices.push({
-      name: chalk.gray('← Back to previous step'),
-      value: BACK_VALUE,
-      checked: false
-    });
-    choices.push({
-      name: chalk.gray('─'.repeat(50)),
-      value: '__SEPARATOR__',
-      disabled: true
-    });
-  }
-
-  // Build choices with categories and guidelines
-  for (const category of categoryTree) {
-    const categoryKey = `category:${category.name}`;
-    const guidelineIds: string[] = [];
-
-    // Category header
-    choices.push({
-      name: chalk.bold.cyan(`${category.name} (${category.count} guidelines)`),
-      value: categoryKey,
-      checked: true
-    });
-
-    // Guidelines under category
-    for (const guideline of category.guidelines) {
-      allGuidelineIds.push(guideline.id);
-      guidelineIds.push(guideline.id);
-      choices.push({
-        name: `   ${guideline.name}`,
-        value: guideline.id,
-        checked: true
-      });
-    }
-
-    categoryToGuidelines.set(categoryKey, guidelineIds);
-  }
-
-  let selected = await checkbox({
-    message: 'Select guidelines to include (Space to toggle, Enter to confirm):',
-    choices,
-    pageSize: 25,
-    loop: false
-  }) as string[];
-
-  // Handle back selection
-  if (selected.includes(BACK_VALUE)) {
-    return BACK_VALUE;
-  }
-
-  // Filter out separator
-  selected = selected.filter(s => s !== '__SEPARATOR__');
-
-  // Smart category-child sync
-  const categories = Array.from(categoryToGuidelines.keys());
-  const selectedCategories = selected.filter(s => s.startsWith('category:'));
-  const selectedGuidelines = selected.filter(s => !s.startsWith('category:'));
-
-  const finalGuidelines = new Set<string>();
-
-  for (const category of categories) {
-    const guidelinesInCategory = categoryToGuidelines.get(category) || [];
-    const isCategorySelected = selectedCategories.includes(category);
-
-    if (isCategorySelected) {
-      // Category is checked → include ALL guidelines in that category
-      guidelinesInCategory.forEach(g => finalGuidelines.add(g));
-    } else {
-      // Category is NOT checked → include only individually selected guidelines
-      guidelinesInCategory.forEach(g => {
-        if (selectedGuidelines.includes(g)) {
-          finalGuidelines.add(g);
-        }
-      });
-    }
-  }
-
-  const result = Array.from(finalGuidelines);
-
-  if (result.length === 0) {
-    console.log(chalk.yellow('\n⚠️  No guidelines selected. Using all available guidelines.'));
-    return allGuidelineIds;
-  }
-
-  // Show selection summary
-  console.log(chalk.cyan(`\n✓ Selected ${result.length} of ${allGuidelineIds.length} guidelines`));
-
-  return result;
-}