gencode-ai 0.1.0 → 0.1.2

package/src/config/test-utils.ts

@@ -0,0 +1,79 @@
+/**
+ * Shared test utilities for config tests
+ */
+
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+
+export interface TestProject {
+  tempDir: string;
+  projectDir: string;
+  cleanup: () => Promise<void>;
+}
+
+/**
+ * Create a test project with temp directory and git marker
+ */
+export async function createTestProject(prefix = 'gencode-test-'): Promise<TestProject> {
+  const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), prefix));
+  const projectDir = path.join(tempDir, 'project');
+
+  await fs.mkdir(projectDir, { recursive: true });
+  await fs.mkdir(path.join(projectDir, '.git'));
+
+  return {
+    tempDir,
+    projectDir,
+    cleanup: async () => {
+      await fs.rm(tempDir, { recursive: true, force: true });
+      delete process.env.GENCODE_CONFIG_DIRS;
+    },
+  };
+}
+
+/**
+ * Write JSON settings to a config directory
+ */
+export async function writeSettings(
+  projectDir: string,
+  namespace: 'claude' | 'gencode',
+  settings: Record<string, unknown>,
+  local = false
+): Promise<string> {
+  const dir = path.join(projectDir, namespace === 'claude' ? '.claude' : '.gencode');
+  await fs.mkdir(dir, { recursive: true });
+
+  const filename = local ? 'settings.local.json' : 'settings.json';
+  const filePath = path.join(dir, filename);
+  await fs.writeFile(filePath, JSON.stringify(settings));
+
+  return filePath;
+}
+
+/**
+ * Write memory file to a directory
+ */
+export async function writeMemory(
+  projectDir: string,
+  namespace: 'claude' | 'gencode',
+  content: string,
+  options: { local?: boolean; inDir?: boolean } = {}
+): Promise<string> {
+  const { local = false, inDir = true } = options;
+  const filename = namespace === 'claude'
+    ? (local ? 'CLAUDE.local.md' : 'CLAUDE.md')
+    : (local ? 'AGENT.local.md' : 'AGENT.md');
+
+  let filePath: string;
+  if (inDir) {
+    const dir = path.join(projectDir, namespace === 'claude' ? '.claude' : '.gencode');
+    await fs.mkdir(dir, { recursive: true });
+    filePath = path.join(dir, filename);
+  } else {
+    filePath = path.join(projectDir, filename);
+  }
+
+  await fs.writeFile(filePath, content);
+  return filePath;
+}

package/src/config/types.ts

@@ -1,25 +1,202 @@
 /**
- * Settings Types - User settings persistence (Claude Code style)
+ * Configuration Types - Multi-level configuration system (Claude Code compatible)
+ *
+ * Configuration hierarchy (priority from low to high):
+ * 1. User Level: ~/.gencode/ + ~/.claude/ (merged, gencode wins)
+ * 2. Extra Dirs: GENCODE_CONFIG_DIRS environment variable
+ * 3. Project Level: .gencode/ + .claude/ (merged, gencode wins)
+ * 4. Local Level: .gencode/*.local.* + .claude/*.local.* (merged, gencode wins)
+ * 5. CLI Arguments: Command line overrides
+ * 6. Managed Level: System-wide enforced settings (cannot be overridden)
  */
 
-export type ProviderName = 'openai' | 'anthropic' | 'gemini';
+import * as os from 'os';
+import * as path from 'path';
+
+// =============================================================================
+// Provider Types
+// =============================================================================
+
+export type ProviderName = 'openai' | 'anthropic' | 'gemini' | 'vertex-ai';
+
+// =============================================================================
+// Settings Types
+// =============================================================================
+
+/**
+ * Permission rules for tools
+ */
+export interface PermissionRules {
+  allow?: string[];
+  ask?: string[];
+  deny?: string[];
+}
 
 /**
- * Settings file structure (~/.gencode/settings.json)
- * Similar to Claude Code's settings.json
+ * Settings file structure
+ * Compatible with Claude Code's settings.json
  */
 export interface Settings {
+  // Provider configuration
   model?: string;
   provider?: ProviderName;
-  permissions?: {
-    allow?: string[];
-    deny?: string[];
+
+  // Permissions
+  permissions?: PermissionRules;
+
+  // UI/Display
+  theme?: string;
+  language?: string;
+  alwaysThinkingEnabled?: boolean;
+
+  // Environment variables
+  env?: Record<string, string>;
+
+  // Attribution for commits/PRs
+  attribution?: {
+    commit?: string;
+    pr?: string;
   };
+
+  // Plugin configuration
+  enabledPlugins?: Record<string, boolean>;
+  extraKnownMarketplaces?: Record<string, unknown>;
+
+  // Managed-only fields (cannot be overridden by lower levels)
+  strictKnownMarketplaces?: unknown[];
+
+  // Catch-all for future fields
+  [key: string]: unknown;
+}
+
+// =============================================================================
+// Configuration Level Types
+// =============================================================================
+
+/**
+ * Configuration level identifiers
+ */
+export type ConfigLevelType = 'managed' | 'user' | 'extra' | 'project' | 'local' | 'cli';
+
+/**
+ * Represents a configuration level with its metadata
+ */
+export interface ConfigLevel {
+  type: ConfigLevelType;
+  priority: number; // Higher number = higher priority
+  paths: string[]; // Paths to check (in order: gencode first, then claude)
+  description: string;
+}
+
+/**
+ * A loaded configuration source
+ */
+export interface ConfigSource {
+  level: ConfigLevelType;
+  path: string;
+  namespace: 'gencode' | 'claude' | 'extra';
+  settings: Settings;
+}
+
+/**
+ * Result of merging all configuration sources
+ */
+export interface MergedConfig {
+  settings: Settings;
+  sources: ConfigSource[];
+  managedDeny: string[]; // Deny rules that cannot be overridden
 }
 
+// =============================================================================
+// Constants
+// =============================================================================
+
+export const GENCODE_CONFIG_DIRS_ENV = 'GENCODE_CONFIG_DIRS';
+
+// File names
+export const SETTINGS_FILE_NAME = 'settings.json';
+export const SETTINGS_LOCAL_FILE_NAME = 'settings.local.json';
+export const MANAGED_SETTINGS_FILE_NAME = 'managed-settings.json';
+export const PROVIDERS_FILE_NAME = 'providers.json';
+
+// Directory names
+export const GENCODE_DIR = '.gencode';
+export const CLAUDE_DIR = '.claude';
+
+// User directory paths
+export const USER_GENCODE_DIR = path.join(os.homedir(), GENCODE_DIR);
+export const USER_CLAUDE_DIR = path.join(os.homedir(), CLAUDE_DIR);
+
+// Managed settings locations by platform
+export function getManagedPaths(): { gencode: string; claude: string } {
+  const platform = os.platform();
+
+  if (platform === 'darwin') {
+    return {
+      gencode: '/Library/Application Support/GenCode',
+      claude: '/Library/Application Support/ClaudeCode',
+    };
+  } else if (platform === 'win32') {
+    return {
+      gencode: 'C:\\Program Files\\GenCode',
+      claude: 'C:\\Program Files\\ClaudeCode',
+    };
+  } else {
+    // Linux and other Unix-like systems
+    return {
+      gencode: '/etc/gencode',
+      claude: '/etc/claude-code',
+    };
+  }
+}
+
+// =============================================================================
+// Legacy Types (for backward compatibility)
+// =============================================================================
+
 export interface SettingsManagerOptions {
   settingsDir?: string;
 }
 
-export const DEFAULT_SETTINGS_DIR = '~/.gencode';
-export const SETTINGS_FILE_NAME = 'settings.json';
+// Legacy exports
+export const DEFAULT_SETTINGS_DIR = '~/.claude';
+export const PROJECT_SETTINGS_DIR = '.claude';
+export const FALLBACK_SETTINGS_DIR = '~/.gencode';
+export const FALLBACK_PROJECT_DIR = '.gencode';
+
+// =============================================================================
+// Provider Connection Types
+// =============================================================================
+
+/**
+ * Provider connection info
+ */
+export interface ProviderConnection {
+  method: 'api_key' | 'vertex' | 'oauth';
+  connectedAt: string;
+}
+
+/**
+ * Cached model info
+ */
+export interface CachedModel {
+  id: string;
+  name: string;
+  description?: string;
+}
+
+/**
+ * Cached models for a provider
+ */
+export interface ProviderModels {
+  cachedAt: string;
+  list: CachedModel[];
+}
+
+/**
+ * Providers config file structure (~/.gencode/providers.json)
+ */
+export interface ProvidersConfig {
+  connections: Record<string, ProviderConnection>;
+  models: Record<string, ProviderModels>;
+}

package/src/memory/import-resolver.test.ts

@@ -0,0 +1,117 @@
+/**
+ * Import Resolver Tests
+ *
+ * These tests focus on the core logic that can be tested without complex mocking.
+ * For integration tests, use the test-memory.ts script.
+ */
+
+import { describe, it, expect, beforeEach } from '@jest/globals';
+import { ImportResolver } from './import-resolver.js';
+import { DEFAULT_MEMORY_CONFIG } from './types.js';
+
+describe('ImportResolver', () => {
+  let resolver: ImportResolver;
+
+  beforeEach(() => {
+    resolver = new ImportResolver(DEFAULT_MEMORY_CONFIG);
+    resolver.setProjectRoot('/project');
+  });
+
+  describe('constructor', () => {
+    it('should create resolver with config', () => {
+      const resolver = new ImportResolver(DEFAULT_MEMORY_CONFIG);
+      expect(resolver).toBeDefined();
+    });
+  });
+
+  describe('setProjectRoot', () => {
+    it('should set project root', () => {
+      const resolver = new ImportResolver(DEFAULT_MEMORY_CONFIG);
+      resolver.setProjectRoot('/my/project');
+      expect(resolver).toBeDefined();
+    });
+  });
+
+  describe('reset', () => {
+    it('should reset resolved paths', () => {
+      const resolver = new ImportResolver(DEFAULT_MEMORY_CONFIG);
+      resolver.reset();
+      expect(resolver).toBeDefined();
+    });
+  });
+
+  describe('resolve', () => {
+    it('should return content unchanged when no @imports exist', async () => {
+      const content = `# Test File
+
+This is a test file with no imports.
+
+## Section
+Some content here.`;
+
+      const result = await resolver.resolve(content, '/project');
+      expect(result.content).toBe(content);
+      expect(result.importedPaths).toEqual([]);
+      expect(result.errors).toEqual([]);
+    });
+
+    it('should not treat email addresses as imports', async () => {
+      const content = `# Contact
+
+Email: test@example.com
+Support: help@company.org`;
+
+      const result = await resolver.resolve(content, '/project');
+      expect(result.content).toBe(content);
+      expect(result.importedPaths).toEqual([]);
+      expect(result.errors).toEqual([]);
+    });
+
+    it('should not treat inline @ mentions as imports', async () => {
+      const content = `Some text with @mention inside
+
+Not an import because @ is not at line start`;
+
+      const result = await resolver.resolve(content, '/project');
+      expect(result.content).toBe(content);
+      expect(result.importedPaths).toEqual([]);
+    });
+
+    it('should handle content with no imports and special characters', async () => {
+      const content = `# Special Characters
+
+Code: \`@decorator\`
+Symbol: @todo
+Email: user@domain.com`;
+
+      const result = await resolver.resolve(content, '/project');
+      expect(result.content).toBe(content);
+      expect(result.errors).toEqual([]);
+    });
+
+    it('should handle missing file gracefully', async () => {
+      const content = `@./nonexistent.md`;
+
+      const result = await resolver.resolve(content, '/project');
+
+      // Should have an error about failed import
+      expect(result.errors.some(e => e.includes('Failed to import'))).toBe(true);
+    });
+
+    it('should respect max depth limit', async () => {
+      // Create resolver with depth limit of 0
+      const limitedResolver = new ImportResolver({
+        ...DEFAULT_MEMORY_CONFIG,
+        maxImportDepth: 0,
+      });
+      limitedResolver.setProjectRoot('/project');
+
+      const content = `@./file.md`;
+
+      const result = await limitedResolver.resolve(content, '/project');
+
+      // Should have error about max depth
+      expect(result.errors.some(e => e.includes('depth'))).toBe(true);
+    });
+  });
+});

package/src/memory/import-resolver.ts

@@ -0,0 +1,149 @@
+/**
+ * Import Resolver - Handle @import syntax in memory files
+ *
+ * Supports:
+ * - @path/to/file.md - Relative imports
+ * - @./file.md - Current directory imports
+ * - @../parent/file.md - Parent directory imports
+ *
+ * Security:
+ * - Circular import detection
+ * - Max depth limit (5 levels)
+ * - Path traversal protection
+ */
+
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import type { MemoryConfig } from './types.js';
+
+export interface ImportResult {
+  content: string;
+  importedPaths: string[];
+  errors: string[];
+}
+
+export class ImportResolver {
+  private config: MemoryConfig;
+  private resolvedPaths: Set<string> = new Set();
+  private projectRoot: string = '';
+
+  constructor(config: MemoryConfig) {
+    this.config = config;
+  }
+
+  /**
+   * Set the project root for path traversal protection
+   */
+  setProjectRoot(root: string): void {
+    this.projectRoot = root;
+  }
+
+  /**
+   * Resolve all @imports in content
+   */
+  async resolve(
+    content: string,
+    basePath: string,
+    depth: number = 0
+  ): Promise<ImportResult> {
+    const importedPaths: string[] = [];
+    const errors: string[] = [];
+
+    if (depth >= this.config.maxImportDepth) {
+      errors.push(`Max import depth (${this.config.maxImportDepth}) exceeded`);
+      return { content, importedPaths, errors };
+    }
+
+    // Match @import lines: lines starting with @ followed by a path
+    // Pattern: @path/to/file or @./file or @../file
+    const importRegex = /^@([^\s]+\.md)$/gm;
+    let resolvedContent = content;
+    const matches = [...content.matchAll(importRegex)];
+
+    for (const match of matches) {
+      const importPath = match[1].trim();
+      const absolutePath = this.resolvePath(importPath, basePath);
+
+      // Circular import detection
+      if (this.resolvedPaths.has(absolutePath)) {
+        errors.push(`Circular import detected: ${importPath}`);
+        resolvedContent = resolvedContent.replace(match[0], `<!-- Circular import: ${importPath} -->`);
+        continue;
+      }
+
+      // Path traversal security check
+      if (!this.isPathSafe(absolutePath)) {
+        errors.push(`Import path outside allowed scope: ${importPath}`);
+        resolvedContent = resolvedContent.replace(match[0], `<!-- Blocked import: ${importPath} -->`);
+        continue;
+      }
+
+      try {
+        const stat = await fs.stat(absolutePath);
+
+        // Size limit check
+        if (stat.size > this.config.maxFileSize) {
+          errors.push(`Import too large (${Math.round(stat.size / 1024)}KB): ${importPath}`);
+          resolvedContent = resolvedContent.replace(match[0], `<!-- Import too large: ${importPath} -->`);
+          continue;
+        }
+
+        this.resolvedPaths.add(absolutePath);
+        let importedContent = await fs.readFile(absolutePath, 'utf-8');
+        importedPaths.push(absolutePath);
+
+        // Recursively resolve imports in the imported file
+        const nested = await this.resolve(importedContent, path.dirname(absolutePath), depth + 1);
+
+        importedContent = nested.content;
+        importedPaths.push(...nested.importedPaths);
+        errors.push(...nested.errors);
+
+        // Replace @import with content
+        resolvedContent = resolvedContent.replace(match[0], importedContent);
+      } catch {
+        errors.push(`Failed to import: ${importPath}`);
+        resolvedContent = resolvedContent.replace(match[0], `<!-- Failed to import: ${importPath} -->`);
+      }
+    }
+
+    return { content: resolvedContent, importedPaths, errors };
+  }
+
+  /**
+   * Resolve import path to absolute path
+   */
+  private resolvePath(importPath: string, basePath: string): string {
+    if (path.isAbsolute(importPath)) {
+      return importPath;
+    }
+    return path.resolve(basePath, importPath);
+  }
+
+  /**
+   * Check if path is safe (within project or home directory)
+   */
+  private isPathSafe(targetPath: string): boolean {
+    const home = process.env.HOME || '';
+    const normalized = path.normalize(targetPath);
+
+    // Allow imports within project root
+    if (this.projectRoot && normalized.startsWith(this.projectRoot)) {
+      return true;
+    }
+
+    // Allow imports from home directory (for user-level imports)
+    if (home && normalized.startsWith(home)) {
+      return true;
+    }
+
+    return false;
+  }
+
+  /**
+   * Reset resolver state for new file
+   */
+  reset(): void {
+    this.resolvedPaths.clear();
+  }
+}

package/src/memory/index.ts

@@ -0,0 +1,11 @@
+/**
+ * Memory System - Claude Code compatible memory management
+ *
+ * Provides hierarchical memory loading with AGENT.md (primary) and CLAUDE.md (fallback)
+ */
+
+export * from './types.js';
+export { MemoryManager } from './memory-manager.js';
+export { ImportResolver } from './import-resolver.js';
+export { parseRuleFrontmatter, matchesPatterns, activateRules, getActiveRules } from './rules-parser.js';
+export { gatherContextFiles, buildInitPrompt, getContextSummary } from './init-prompt.js';

package/src/memory/init-prompt.ts

@@ -0,0 +1,113 @@
+/**
+ * Init Prompt Builder - Generate prompts for /init command
+ *
+ * Gathers context files (package.json, README.md, etc.) and builds
+ * a prompt for the AI to generate AGENT.md
+ */
+
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { glob } from 'glob';
+
+export interface ContextFiles {
+  [path: string]: string;
+}
+
+/**
+ * Gather context files for project analysis
+ */
+export async function gatherContextFiles(cwd: string): Promise<ContextFiles> {
+  const patterns = [
+    'package.json',
+    'README.md',
+    'CONTRIBUTING.md',
+    '.cursor/rules/**/*.md',
+    '.cursorrules',
+    '.github/copilot-instructions.md',
+    'Cargo.toml',
+    'go.mod',
+    'pyproject.toml',
+    'tsconfig.json',
+    'Makefile',
+    'docker-compose.yml',
+    'docker-compose.yaml',
+  ];
+
+  const files: ContextFiles = {};
+
+  for (const pattern of patterns) {
+    try {
+      const matches = await glob(pattern, { cwd, absolute: false });
+      for (const match of matches.slice(0, 3)) {
+        // Limit per pattern
+        try {
+          const filePath = path.join(cwd, match);
+          const content = await fs.readFile(filePath, 'utf-8');
+          if (content.length < 50000) {
+            // 50KB limit per file
+            files[match] = content;
+          }
+        } catch {
+          // Skip files that can't be read
+        }
+      }
+    } catch {
+      // Skip patterns that fail
+    }
+  }
+
+  return files;
+}
+
+/**
+ * Build the init prompt for generating AGENT.md
+ */
+export function buildInitPrompt(contextFiles: ContextFiles, existingAgentMd?: string): string {
+  const contextParts = Object.entries(contextFiles)
+    .map(([filePath, content]) => `### ${filePath}\n\`\`\`\n${content}\n\`\`\``)
+    .join('\n\n');
+
+  const existingSection = existingAgentMd
+    ? `\n\n## Existing AGENT.md\n\`\`\`markdown\n${existingAgentMd}\n\`\`\`\n`
+    : '';
+
+  return `Please analyze this codebase and create an AGENT.md file, which will be given to future AI assistants to operate in this repository.
+
+## Context Files
+
+${contextParts}
+${existingSection}
+## Instructions
+
+What to add:
+1. Commands that will be commonly used, such as how to build, lint, and run tests.
+   Include the necessary commands to develop in this codebase, such as how to run a single test.
+2. High-level code architecture and structure so that future instances can be productive more quickly.
+   Focus on the "big picture" architecture that requires reading multiple files to understand.
+
+Usage notes:
+- ${existingAgentMd ? 'Suggest improvements to the existing AGENT.md.' : 'Create a new AGENT.md.'}
+- Do not repeat yourself and do not include obvious instructions like "Provide helpful error messages" or "Write tests for new code".
+- Avoid listing every component or file structure that can be easily discovered.
+- Don't include generic development practices.
+- Do not make up information unless it's expressly included in the files above.
+- Keep it concise - aim for ~20-40 lines.
+- Start the file with:
+
+# AGENT.md
+
+This file provides guidance to AI assistants when working with code in this repository.
+
+After generating the content, use the Write tool to save it to ./AGENT.md`;
+}
+
+/**
+ * Get a summary of files found for user feedback
+ */
+export function getContextSummary(contextFiles: ContextFiles): string {
+  const fileNames = Object.keys(contextFiles);
+  if (fileNames.length === 0) {
+    return 'No context files found';
+  }
+  return `Found ${fileNames.length} context file(s): ${fileNames.join(', ')}`;
+}