@aicgen/aicgen 1.0.0-beta.1

package/src/utils/logger.ts

@@ -0,0 +1,89 @@
+import winston from 'winston';
+import chalk from 'chalk';
+
+const { combine, timestamp, printf, errors } = winston.format;
+
+const customLevels = {
+  levels: {
+    error: 0,
+    warn: 1,
+    success: 2,
+    info: 3,
+    debug: 4
+  },
+  colors: {
+    error: 'red',
+    warn: 'yellow',
+    success: 'green',
+    info: 'blue',
+    debug: 'gray'
+  }
+};
+
+const consoleFormat = printf(({ level, message }) => {
+  const icon = {
+    error: '❌',
+    warn: '⚠️',
+    success: '✅',
+    info: '📋',
+    debug: '🔍'
+  }[level] || '';
+
+  const colorize = {
+    error: chalk.red,
+    warn: chalk.yellow,
+    success: chalk.green,
+    info: chalk.blue,
+    debug: chalk.gray
+  }[level] || chalk.white;
+
+  return `${icon} ${colorize(message)}`;
+});
+
+const winstonLogger = winston.createLogger({
+  levels: customLevels.levels,
+  level: process.env.LOG_LEVEL || 'info',
+  format: combine(
+    errors({ stack: true }),
+    timestamp()
+  ),
+  transports: [
+    new winston.transports.Console({
+      format: consoleFormat
+    })
+  ],
+  exitOnError: false,
+  silent: process.env.NODE_ENV === 'test'
+});
+
+winston.addColors(customLevels.colors);
+
+export const logger = winstonLogger;
+
+export const setLogLevel = (level: 'error' | 'warn' | 'success' | 'info' | 'debug') => {
+  winstonLogger.level = level;
+};
+
+export function logInfo(message: string): void {
+  winstonLogger.info(message);
+}
+
+export function logSuccess(message: string): void {
+  winstonLogger.log('success', message);
+}
+
+export function logWarning(message: string): void {
+  winstonLogger.warn(message);
+}
+
+export function logError(message: string): void {
+  winstonLogger.error(message);
+}
+
+export function logGray(message: string): void {
+  winstonLogger.debug(message);
+}
+
+export function logDebug(message: string): void {
+  winstonLogger.debug(message);
+}

package/src/utils/path.ts

@@ -0,0 +1,17 @@
+import { join, normalize } from 'path';
+import { homedir } from 'os';
+
+export const AICGEN_HOME = join(homedir(), '.aicgen');
+export const AICGEN_PROJECT_DIR = '.aicgen';
+
+export function getAicgenHome(...parts: string[]): string {
+  return join(AICGEN_HOME, ...parts);
+}
+
+export function getProjectConfigDir(projectPath: string): string {
+  return join(projectPath, AICGEN_PROJECT_DIR);
+}
+
+export function toUnixPath(path: string): string {
+  return normalize(path).replace(/\\/g, '/');
+}

package/src/utils/wizard-state.ts

@@ -0,0 +1,132 @@
+import { Language, ProjectType, AIAssistant } from '../models/project.js';
+import { InstructionLevel, ArchitectureType, DatasourceType } from '../models/profile.js';
+
+export type WizardStep =
+  | 'language'
+  | 'projectType'
+  | 'assistant'
+  | 'setupType'
+  | 'architecture'
+  | 'datasource'
+  | 'level'
+  | 'guidelines'
+  | 'summary';
+
+export interface WizardState {
+  currentStep: WizardStep;
+  history: WizardStep[];
+
+  // Detected values
+  detectedLanguage?: Language;
+  detectedProjectName?: string;
+  hasExistingConfig?: boolean;
+
+  // User selections
+  language?: Language;
+  projectType?: ProjectType;
+  assistant?: AIAssistant;
+  setupType?: 'quick' | 'custom';
+  architecture?: ArchitectureType;
+  datasource?: DatasourceType;
+  level?: InstructionLevel;
+  selectedGuidelineIds?: string[];
+}
+
+export class WizardStateManager {
+  private state: WizardState;
+  private stepOrder: WizardStep[] = [
+    'language',
+    'projectType',
+    'assistant',
+    'setupType',
+    'architecture',
+    'datasource',
+    'level',
+    'guidelines',
+    'summary'
+  ];
+
+  constructor(initialState: Partial<WizardState> = {}) {
+    this.state = {
+      currentStep: 'language',
+      history: [],
+      ...initialState
+    };
+  }
+
+  getState(): Readonly<WizardState> {
+    return { ...this.state };
+  }
+
+  updateState(updates: Partial<WizardState>): void {
+    this.state = {
+      ...this.state,
+      ...updates
+    };
+  }
+
+  goToStep(step: WizardStep): void {
+    if (!this.state.history.includes(this.state.currentStep)) {
+      this.state.history.push(this.state.currentStep);
+    }
+    this.state.currentStep = step;
+  }
+
+  goToNextStep(): void {
+    const currentIndex = this.stepOrder.indexOf(this.state.currentStep);
+    if (currentIndex < this.stepOrder.length - 1) {
+      const nextStep = this.stepOrder[currentIndex + 1];
+      this.goToStep(nextStep);
+    }
+  }
+
+  goBack(): boolean {
+    if (this.state.history.length === 0) {
+      return false;
+    }
+
+    const previousStep = this.state.history.pop()!;
+    this.state.currentStep = previousStep;
+    return true;
+  }
+
+  canGoBack(): boolean {
+    return this.state.history.length > 0;
+  }
+
+  shouldShowStep(step: WizardStep): boolean {
+    // Skip guidelines step in quick setup
+    if (step === 'guidelines' && this.state.setupType === 'quick') {
+      return false;
+    }
+
+    return true;
+  }
+
+  isComplete(): boolean {
+    return this.state.currentStep === 'summary' &&
+           !!this.state.language &&
+           !!this.state.projectType &&
+           !!this.state.assistant &&
+           !!this.state.setupType &&
+           !!this.state.architecture &&
+           !!this.state.datasource &&
+           !!this.state.level;
+  }
+}
+
+export const BACK_OPTION = '← Back';
+export const BACK_VALUE = '__BACK__';
+
+export function addBackOption<T>(choices: T[], canGoBack: boolean): T[] {
+  if (!canGoBack) return choices;
+
+  return [
+    { value: BACK_VALUE, name: BACK_OPTION, description: 'Go back to previous step' } as T,
+    ...choices
+  ];
+}
+
+export function isBackSelected(value: unknown): boolean {
+  return value === BACK_VALUE;
+}

package/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ESNext"],
+    "types": ["bun-types"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "allowImportingTsExtensions": true,
+    "noEmit": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "isolatedModules": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/__tests__/**"]
+}