@girardmedia/bootspring 2.0.21 → 2.0.23

package/src/core/context.ts

@@ -0,0 +1,410 @@
+/**
+ * Bootspring Context Manager
+ * Handles project context for AI assistants
+ *
+ * @package bootspring
+ * @module core/context
+ */
+
+import * as path from 'path';
+import * as configModule from './config';
+import * as utils from './utils';
+import type { LoadedConfig, ConfigInput } from './config';
+
+// =============================================================================
+// Types
+// =============================================================================
+
+/**
+ * Enabled plugin info
+ */
+export interface EnabledPlugin {
+  provider: string;
+  features: string[];
+}
+
+/**
+ * Enabled plugins map
+ */
+export interface EnabledPlugins {
+  [name: string]: EnabledPlugin;
+}
+
+/**
+ * Project file structure info
+ */
+export interface ProjectFiles {
+  hasPackageJson: boolean;
+  hasTsConfig: boolean;
+  hasClaudeMd: boolean;
+  hasBootspringConfig: boolean;
+  hasTodoMd: boolean;
+  hasGit: boolean;
+  hasSrcDir: boolean;
+  hasAppDir: boolean;
+  hasPagesDir: boolean;
+  structure: 'app-router' | 'pages-router' | 'src-based' | 'flat';
+}
+
+/**
+ * Git repository info
+ */
+export interface GitInfo {
+  initialized: boolean;
+  branch?: string | undefined;
+  hasRemote?: boolean | undefined;
+}
+
+/**
+ * Project state info
+ */
+export interface ProjectState {
+  phase: 'unknown' | 'uninitialized' | 'initialized' | 'active';
+  health: 'unknown' | 'good' | 'fair' | 'needs-attention';
+  todos: number;
+  lastGenerated: Date | null;
+  issues?: string[] | undefined;
+}
+
+/**
+ * Full project context
+ */
+export interface ProjectContext {
+  project: ConfigInput['project'];
+  stack: ConfigInput['stack'];
+  plugins: EnabledPlugins;
+  files: ProjectFiles;
+  git: GitInfo;
+  state: ProjectState;
+  timestamp: string;
+}
+
+/**
+ * Validation check result
+ */
+export interface ValidationCheck {
+  name: string;
+  status: 'pass' | 'fail' | 'warn';
+  message: string;
+}
+
+/**
+ * Context validation result
+ */
+export interface ContextValidationResult {
+  valid: boolean;
+  score: number;
+  maxScore: number;
+  percentage: number;
+  checks: ValidationCheck[];
+}
+
+/**
+ * Options for get/validate functions
+ */
+export interface ContextOptions {
+  config?: LoadedConfig | undefined;
+}
+
+// =============================================================================
+// Functions
+// =============================================================================
+
+/**
+ * Get current project context
+ */
+export function get(options: ContextOptions = {}): ProjectContext {
+  const cfg = options.config ?? configModule.load();
+  const projectRoot = cfg._projectRoot ?? process.cwd();
+
+  const context: ProjectContext = {
+    project: cfg.project,
+    stack: cfg.stack,
+    plugins: getEnabledPlugins(cfg),
+    files: getProjectFiles(projectRoot),
+    git: getGitInfo(projectRoot),
+    state: getProjectState(projectRoot, cfg),
+    timestamp: new Date().toISOString()
+  };
+
+  return context;
+}
+
+/**
+ * Get enabled plugins from config
+ */
+export function getEnabledPlugins(cfg: LoadedConfig | ConfigInput): EnabledPlugins {
+  const enabled: EnabledPlugins = {};
+
+  const plugins = cfg.plugins ?? {};
+  for (const [name, plugin] of Object.entries(plugins)) {
+    if (plugin && plugin.enabled !== false) {
+      enabled[name] = {
+        provider: (plugin as { provider?: string }).provider ?? 'default',
+        features: (plugin as { features?: string[] }).features ?? []
+      };
+    }
+  }
+
+  return enabled;
+}
+
+/**
+ * Get project file structure summary
+ */
+export function getProjectFiles(projectRoot: string): ProjectFiles {
+  const files: ProjectFiles = {
+    hasPackageJson: utils.fileExists(path.join(projectRoot, 'package.json')),
+    hasTsConfig: utils.fileExists(path.join(projectRoot, 'tsconfig.json')),
+    hasClaudeMd: utils.fileExists(path.join(projectRoot, 'CLAUDE.md')),
+    hasBootspringConfig: utils.fileExists(path.join(projectRoot, 'bootspring.config.js')),
+    hasTodoMd: utils.fileExists(path.join(projectRoot, 'todo.md')),
+    hasGit: utils.fileExists(path.join(projectRoot, '.git')),
+    hasSrcDir: utils.fileExists(path.join(projectRoot, 'src')),
+    hasAppDir: utils.fileExists(path.join(projectRoot, 'app')),
+    hasPagesDir: utils.fileExists(path.join(projectRoot, 'pages')),
+    structure: 'flat'
+  };
+
+  // Detect framework structure
+  if (files.hasAppDir) {
+    files.structure = 'app-router';
+  } else if (files.hasPagesDir) {
+    files.structure = 'pages-router';
+  } else if (files.hasSrcDir) {
+    files.structure = 'src-based';
+  }
+
+  return files;
+}
+
+/**
+ * Get git information
+ */
+export function getGitInfo(projectRoot: string): GitInfo {
+  const gitDir = path.join(projectRoot, '.git');
+
+  if (!utils.fileExists(gitDir)) {
+    return { initialized: false };
+  }
+
+  const info: GitInfo = { initialized: true };
+
+  // Get current branch
+  const headPath = path.join(gitDir, 'HEAD');
+  if (utils.fileExists(headPath)) {
+    const head = utils.readFile(headPath);
+    if (head) {
+      const trimmedHead = head.trim();
+      if (trimmedHead.startsWith('ref: refs/heads/')) {
+        info.branch = trimmedHead.replace('ref: refs/heads/', '');
+      }
+    }
+  }
+
+  // Check for remote
+  const configPath = path.join(gitDir, 'config');
+  if (utils.fileExists(configPath)) {
+    const gitConfig = utils.readFile(configPath);
+    if (gitConfig) {
+      info.hasRemote = gitConfig.includes('[remote "origin"]');
+    }
+  }
+
+  return info;
+}
+
+/**
+ * Get project state
+ */
+export function getProjectState(projectRoot: string, cfg: LoadedConfig | ConfigInput): ProjectState {
+  const state: ProjectState = {
+    phase: 'unknown',
+    health: 'unknown',
+    todos: 0,
+    lastGenerated: null
+  };
+
+  // Count todos
+  const todoPath = path.join(projectRoot, cfg.paths?.todo ?? 'todo.md');
+  if (utils.fileExists(todoPath)) {
+    const content = utils.readFile(todoPath);
+    if (content) {
+      const todoMatches = content.match(/- \[ \]/g);
+      state.todos = todoMatches ? todoMatches.length : 0;
+    }
+  }
+
+  // Check CLAUDE.md generation time
+  const claudePath = path.join(projectRoot, cfg.paths?.context ?? 'CLAUDE.md');
+  if (utils.fileExists(claudePath)) {
+    state.lastGenerated = utils.getFileTime(claudePath);
+  }
+
+  // Determine phase
+  const loadedCfg = cfg as LoadedConfig;
+  if (!loadedCfg._configPath) {
+    state.phase = 'uninitialized';
+  } else if (!state.lastGenerated) {
+    state.phase = 'initialized';
+  } else {
+    state.phase = 'active';
+  }
+
+  // Determine health
+  const issues: string[] = [];
+  if (!utils.fileExists(path.join(projectRoot, 'package.json'))) {
+    issues.push('missing-package-json');
+  }
+  if (!loadedCfg._configPath) {
+    issues.push('missing-config');
+  }
+  if (!state.lastGenerated) {
+    issues.push('missing-context');
+  }
+
+  if (issues.length === 0) {
+    state.health = 'good';
+  } else if (issues.length <= 2) {
+    state.health = 'fair';
+  } else {
+    state.health = 'needs-attention';
+  }
+
+  state.issues = issues;
+
+  return state;
+}
+
+/**
+ * Validate project context
+ */
+export function validate(options: ContextOptions = {}): ContextValidationResult {
+  const cfg = options.config ?? configModule.load();
+  const projectRoot = cfg._projectRoot ?? process.cwd();
+
+  const checks: ValidationCheck[] = [];
+  let score = 0;
+  const maxScore = 10;
+
+  // Check 1: Config exists
+  if (cfg._configPath) {
+    checks.push({ name: 'Configuration', status: 'pass', message: 'bootspring.config.js found' });
+    score += 2;
+  } else {
+    checks.push({ name: 'Configuration', status: 'fail', message: 'bootspring.config.js missing' });
+  }
+
+  // Check 2: CLAUDE.md exists
+  const claudePath = path.join(projectRoot, cfg.paths?.context ?? 'CLAUDE.md');
+  if (utils.fileExists(claudePath)) {
+    checks.push({ name: 'AI Context', status: 'pass', message: 'CLAUDE.md exists' });
+    score += 2;
+  } else {
+    checks.push({ name: 'AI Context', status: 'fail', message: 'CLAUDE.md missing - run bootspring generate' });
+  }
+
+  // Check 3: package.json exists
+  if (utils.fileExists(path.join(projectRoot, 'package.json'))) {
+    checks.push({ name: 'Package', status: 'pass', message: 'package.json found' });
+    score += 1;
+  } else {
+    checks.push({ name: 'Package', status: 'warn', message: 'package.json missing' });
+  }
+
+  // Check 4: Git initialized
+  if (utils.fileExists(path.join(projectRoot, '.git'))) {
+    checks.push({ name: 'Git', status: 'pass', message: 'Git repository initialized' });
+    score += 1;
+  } else {
+    checks.push({ name: 'Git', status: 'warn', message: 'Git not initialized' });
+  }
+
+  // Check 5: TypeScript config (if using TS)
+  if (cfg.stack?.language === 'typescript') {
+    if (utils.fileExists(path.join(projectRoot, 'tsconfig.json'))) {
+      checks.push({ name: 'TypeScript', status: 'pass', message: 'tsconfig.json found' });
+      score += 1;
+    } else {
+      checks.push({ name: 'TypeScript', status: 'fail', message: 'tsconfig.json missing for TypeScript project' });
+    }
+  } else {
+    score += 1;
+  }
+
+  // Check 6: Config validation
+  const configValidation = configModule.validate(cfg);
+  if (configValidation.valid) {
+    checks.push({ name: 'Config Validation', status: 'pass', message: 'Configuration is valid' });
+    score += 2;
+  } else {
+    checks.push({ name: 'Config Validation', status: 'fail', message: configValidation.errors.join(', ') });
+  }
+
+  // Check 7: Todo file
+  if (utils.fileExists(path.join(projectRoot, cfg.paths?.todo ?? 'todo.md'))) {
+    checks.push({ name: 'Todo Tracking', status: 'pass', message: 'todo.md exists' });
+    score += 1;
+  } else {
+    checks.push({ name: 'Todo Tracking', status: 'fail', message: 'todo.md not found' });
+  }
+
+  return {
+    valid: score >= maxScore * 0.6,
+    score,
+    maxScore,
+    percentage: Math.round((score / maxScore) * 100),
+    checks
+  };
+}
+
+/**
+ * Generate context summary for AI
+ */
+export function generateSummary(options: ContextOptions = {}): string {
+  const ctx = get(options);
+
+  const lines: string[] = [
+    '# Project Context',
+    '',
+    `**Project**: ${ctx.project?.name ?? 'Unknown'}`,
+    `**Generated**: ${ctx.timestamp}`,
+    '',
+    '## Stack',
+    `- Framework: ${ctx.stack?.framework ?? 'unknown'}`,
+    `- Language: ${ctx.stack?.language ?? 'unknown'}`,
+    `- Database: ${ctx.stack?.database ?? 'unknown'}`,
+    `- Hosting: ${ctx.stack?.hosting ?? 'unknown'}`,
+    ''
+  ];
+
+  // Plugins
+  const enabledPlugins = Object.keys(ctx.plugins);
+  if (enabledPlugins.length > 0) {
+    lines.push('## Enabled Plugins');
+    for (const [name, plugin] of Object.entries(ctx.plugins)) {
+      lines.push(`- **${name}**: ${plugin.provider}`);
+    }
+    lines.push('');
+  }
+
+  // State
+  lines.push('## Project State');
+  lines.push(`- Phase: ${ctx.state.phase}`);
+  lines.push(`- Health: ${ctx.state.health}`);
+  lines.push(`- Open Todos: ${ctx.state.todos}`);
+  if (ctx.state.lastGenerated) {
+    lines.push(`- Context Last Generated: ${utils.formatRelativeTime(ctx.state.lastGenerated)}`);
+  }
+  lines.push('');
+
+  // Git
+  if (ctx.git.initialized) {
+    lines.push('## Git');
+    lines.push(`- Branch: ${ctx.git.branch ?? 'unknown'}`);
+    lines.push(`- Remote: ${ctx.git.hasRemote ? 'configured' : 'not configured'}`);
+    lines.push('');
+  }
+
+  return lines.join('\n');
+}