gencode-ai 0.1.3 → 0.3.0

package/src/memory/types.ts

@@ -2,15 +2,15 @@
  * Memory System Types
  *
  * Hierarchical memory loading compatible with Claude Code:
- * At each level, both .gencode and .claude are loaded and merged (gencode has higher priority).
+ * At each level, both .gen and .claude are loaded and merged (gen has higher priority).
  *
  * Levels:
  * - Enterprise: System-wide managed memory (enforced)
- * - User: ~/.gencode/ + ~/.claude/ (both loaded, gencode content appears later)
- * - User Rules: ~/.gencode/rules/ + ~/.claude/rules/
- * - Extra: GENCODE_CONFIG_DIRS directories
- * - Project: ./AGENT.md, .gencode/, ./CLAUDE.md, .claude/ (recursive upward search)
- * - Project Rules: .gencode/rules/ + .claude/rules/
+ * - User: ~/.gen/ + ~/.claude/ (both loaded, gen content appears later)
+ * - User Rules: ~/.gen/rules/ + ~/.claude/rules/
+ * - Extra: GEN_CONFIG_DIRS directories
+ * - Project: ./GEN.md, .gen/, ./CLAUDE.md, .claude/ (recursive upward search)
+ * - Project Rules: .gen/rules/ + .claude/rules/
  * - Local: *.local.md files (gitignored)
  */
 
@@ -23,7 +23,16 @@ export type MemoryLevel =
   | 'project-rules'
   | 'local';
 
-export type MemoryNamespace = 'gencode' | 'claude' | 'extra';
+export type MemoryNamespace = 'gen' | 'claude' | 'extra';
+
+/**
+ * Memory merge strategy - how to combine CLAUDE.md and GEN.md at each level
+ * - fallback: Load GEN.md if exists, else CLAUDE.md (reduces context, default)
+ * - both: Load both CLAUDE.md and GEN.md (current behavior, max context)
+ * - gen-only: Only load .gen/GEN.md files
+ * - claude-only: Only load .claude/CLAUDE.md files
+ */
+export type MemoryMergeStrategy = 'fallback' | 'both' | 'gen-only' | 'claude-only';
 
 export interface MemoryFile {
   path: string;
@@ -46,9 +55,9 @@ export interface MemoryRule {
 
 export interface MemoryConfig {
   // GenCode file names (higher priority)
-  gencodeFilename: string;
-  gencodeLocalFilename: string;
-  gencodeDir: string;
+  genFilename: string;
+  genLocalFilename: string;
+  genDir: string;
 
   // Claude file names (lower priority, loaded first)
   claudeFilename: string;
@@ -64,9 +73,9 @@ export interface MemoryConfig {
 
 export const DEFAULT_MEMORY_CONFIG: MemoryConfig = {
   // GenCode
-  gencodeFilename: 'AGENT.md',
-  gencodeLocalFilename: 'AGENT.local.md',
-  gencodeDir: '.gencode',
+  genFilename: 'GEN.md',
+  genLocalFilename: 'GEN.local.md',
+  genDir: '.gen',
 
   // Claude
   claudeFilename: 'CLAUDE.md',
@@ -82,13 +91,13 @@ export const DEFAULT_MEMORY_CONFIG: MemoryConfig = {
 
 // Legacy compatibility
 export const LEGACY_MEMORY_CONFIG = {
-  primaryFilename: 'AGENT.md',
+  primaryFilename: 'GEN.md',
   fallbackFilename: 'CLAUDE.md',
-  localFilename: 'AGENT.local.md',
+  localFilename: 'GEN.local.md',
   localFallbackFilename: 'CLAUDE.local.md',
-  primaryUserDir: '.gencode',
+  primaryUserDir: '.gen',
   fallbackUserDir: '.claude',
-  primaryLocalDir: '.gencode',
+  primaryLocalDir: '.gen',
   fallbackLocalDir: '.claude',
   rulesDir: 'rules',
   maxFileSize: 100 * 1024,
@@ -103,6 +112,7 @@ export interface LoadedMemory {
   context: string;
   errors: string[];
   sources: MemorySource[]; // For debugging
+  skippedFiles: string[]; // Files skipped due to merge strategy
 }
 
 export interface MemorySource {
@@ -116,4 +126,5 @@ export interface MemorySource {
 export interface MemoryLoadOptions {
   cwd: string;
   currentFile?: string; // For activating path-scoped rules
+  strategy?: MemoryMergeStrategy; // How to merge CLAUDE.md and AGENT.md (default: 'fallback')
 }

package/src/permissions/persistence.ts

@@ -2,8 +2,8 @@
  * Permission Persistence - Store and load permission rules
  *
  * Handles persistent storage of permission rules at:
- * - Global: ~/.gencode/permissions.json
- * - Project: .gencode/permissions.json
+ * - Global: ~/.gen/permissions.json
+ * - Project: .gen/permissions.json
  */
 
 import * as fs from 'fs/promises';
@@ -21,7 +21,7 @@ import { parsePatternString } from './prompt-matcher.js';
 
 const PERMISSIONS_VERSION = 1;
 const PERMISSIONS_FILE = 'permissions.json';
-const GLOBAL_DIR = path.join(os.homedir(), '.gencode');
+const GLOBAL_DIR = path.join(os.homedir(), '.gen');
 
 /**
  * Permission Persistence Manager
@@ -32,7 +32,7 @@ export class PermissionPersistence {
 
   constructor(projectPath?: string) {
     this.globalDir = GLOBAL_DIR;
-    this.projectDir = projectPath ? path.join(projectPath, '.gencode') : null;
+    this.projectDir = projectPath ? path.join(projectPath, '.gen') : null;
   }
 
   /**

package/src/planning/index.ts

@@ -0,0 +1,53 @@
+/**
+ * Planning Module
+ *
+ * Plan Mode for GenCode - allows the LLM to design implementation
+ * approaches before writing code, with read-only exploration tools.
+ */
+
+// Types
+export type {
+  PlanPhase,
+  PlanApprovalOption,
+  AllowedPrompt,
+  PlanModeState,
+  PlanFile,
+  PlanModeAllowedTool,
+  PlanModeBlockedTool,
+  ModeType,
+  PlanApprovalState,
+  PlanModeEvent,
+} from './types.js';
+
+export { PLAN_MODE_ALLOWED_TOOLS, PLAN_MODE_BLOCKED_TOOLS } from './types.js';
+
+// State Management
+export {
+  PlanModeManager,
+  getPlanModeManager,
+  resetPlanModeManager,
+  isPlanModeActive,
+  getCurrentMode,
+  enterPlanMode,
+  exitPlanMode,
+  togglePlanMode,
+} from './state.js';
+
+// Plan File Utilities
+export {
+  generatePlanFileName,
+  getPlansDir,
+  ensurePlansDir,
+  createPlanFile,
+  readPlanFile,
+  writePlanFile,
+  listPlanFiles,
+  deletePlanFile,
+  parseFilesToChange,
+  parsePreApprovedPermissions,
+  getDisplayPath,
+} from './plan-file.js';
+
+// Tools
+export { enterPlanModeTool } from './tools/enter-plan-mode.js';
+export { exitPlanModeTool } from './tools/exit-plan-mode.js';

package/src/planning/plan-file.ts

@@ -0,0 +1,326 @@
+/**
+ * Plan File Utilities
+ *
+ * Manages plan files stored in .gen/plans/ directory.
+ * Generates unique filenames with timestamps and slugs.
+ */
+
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { existsSync } from 'fs';
+import type { PlanFile } from './types.js';
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+const PLANS_DIR = '.gen/plans';
+const PLAN_FILE_EXTENSION = '.md';
+
+// Word lists for generating memorable names (like Claude Code)
+const ADJECTIVES = [
+  'agile', 'bold', 'calm', 'deft', 'eager', 'fair', 'glad', 'humble',
+  'ideal', 'jolly', 'keen', 'lively', 'merry', 'noble', 'polite', 'quiet',
+  'rapid', 'smart', 'tidy', 'unique', 'vivid', 'warm', 'zealous', 'bright',
+  'clear', 'crisp', 'fresh', 'golden', 'happy', 'lovely', 'neat', 'proud',
+];
+
+const NOUNS = [
+  'alpine', 'beacon', 'cipher', 'delta', 'ember', 'falcon', 'glacier', 'harbor',
+  'island', 'jasper', 'kayak', 'lantern', 'marble', 'nebula', 'oracle', 'prism',
+  'quartz', 'rapids', 'summit', 'timber', 'unity', 'vertex', 'willow', 'zenith',
+  'arrow', 'bridge', 'canyon', 'dawn', 'echo', 'forest', 'grove', 'hollow',
+];
+
+// ============================================================================
+// Name Generation
+// ============================================================================
+
+/**
+ * Generate a memorable plan name (adjective-noun)
+ * Example: "agile-beacon", "bold-cipher"
+ */
+function generateMemorableName(): string {
+  const adjective = ADJECTIVES[Math.floor(Math.random() * ADJECTIVES.length)];
+  const noun = NOUNS[Math.floor(Math.random() * NOUNS.length)];
+  return `${adjective}-${noun}`;
+}
+
+/**
+ * Generate a slug from text (for task-specific naming)
+ */
+function generateSlug(text: string): string {
+  return text
+    .toLowerCase()
+    .replace(/[^a-z0-9\s-]/g, '') // Remove special chars
+    .replace(/\s+/g, '-') // Replace spaces with dashes
+    .replace(/-+/g, '-') // Collapse multiple dashes
+    .slice(0, 30) // Limit length
+    .replace(/^-|-$/g, ''); // Trim dashes from ends
+}
+
+/**
+ * Generate plan file name
+ * Format: <memorable-name>.md (like Claude Code)
+ */
+export function generatePlanFileName(taskDescription?: string): string {
+  // Use memorable name like Claude Code (melodic-humming-lampson)
+  const name = generateMemorableName();
+  return `${name}${PLAN_FILE_EXTENSION}`;
+}
+
+// ============================================================================
+// Directory Management
+// ============================================================================
+
+/**
+ * Get the plans directory path for a project
+ */
+export function getPlansDir(cwd: string): string {
+  return path.join(cwd, PLANS_DIR);
+}
+
+/**
+ * Ensure the plans directory exists
+ */
+export async function ensurePlansDir(cwd: string): Promise<string> {
+  const plansDir = getPlansDir(cwd);
+
+  if (!existsSync(plansDir)) {
+    await fs.mkdir(plansDir, { recursive: true });
+  }
+
+  return plansDir;
+}
+
+// ============================================================================
+// Plan File Operations
+// ============================================================================
+
+/**
+ * Create a new plan file
+ */
+export async function createPlanFile(
+  cwd: string,
+  taskDescription?: string
+): Promise<PlanFile> {
+  const plansDir = await ensurePlansDir(cwd);
+  const fileName = generatePlanFileName(taskDescription);
+  const filePath = path.join(plansDir, fileName);
+
+  // Initial plan template
+  const initialContent = `# Implementation Plan
+
+## Task
+${taskDescription || 'Describe the task here...'}
+
+## Analysis
+_Understanding the codebase and requirements..._
+
+## Approach
+_Design decisions and implementation strategy..._
+
+## Files to Change
+- [ ] File 1 (action)
+- [ ] File 2 (action)
+
+## Steps
+1. Step 1
+2. Step 2
+3. Step 3
+
+## Pre-approved Permissions
+_Commands that will be allowed during execution..._
+
+---
+_Generated by GenCode Plan Mode_
+`;
+
+  const now = new Date();
+  await fs.writeFile(filePath, initialContent, 'utf-8');
+
+  return {
+    path: filePath,
+    content: initialContent,
+    createdAt: now,
+    updatedAt: now,
+  };
+}
+
+/**
+ * Read a plan file
+ */
+export async function readPlanFile(filePath: string): Promise<PlanFile | null> {
+  try {
+    const content = await fs.readFile(filePath, 'utf-8');
+    const stats = await fs.stat(filePath);
+
+    return {
+      path: filePath,
+      content,
+      createdAt: stats.birthtime,
+      updatedAt: stats.mtime,
+    };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Write to a plan file
+ */
+export async function writePlanFile(filePath: string, content: string): Promise<void> {
+  // Ensure directory exists
+  const dir = path.dirname(filePath);
+  if (!existsSync(dir)) {
+    await fs.mkdir(dir, { recursive: true });
+  }
+
+  await fs.writeFile(filePath, content, 'utf-8');
+}
+
+/**
+ * List all plan files in the project
+ */
+export async function listPlanFiles(cwd: string): Promise<PlanFile[]> {
+  const plansDir = getPlansDir(cwd);
+
+  if (!existsSync(plansDir)) {
+    return [];
+  }
+
+  try {
+    const files = await fs.readdir(plansDir);
+    const planFiles: PlanFile[] = [];
+
+    for (const file of files) {
+      if (file.endsWith(PLAN_FILE_EXTENSION)) {
+        const filePath = path.join(plansDir, file);
+        const planFile = await readPlanFile(filePath);
+        if (planFile) {
+          planFiles.push(planFile);
+        }
+      }
+    }
+
+    // Sort by updated time, newest first
+    planFiles.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
+
+    return planFiles;
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Delete a plan file
+ */
+export async function deletePlanFile(filePath: string): Promise<boolean> {
+  try {
+    await fs.unlink(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// ============================================================================
+// Plan Content Parsing
+// ============================================================================
+
+/**
+ * Extract files to change from plan content
+ */
+export function parseFilesToChange(
+  content: string
+): Array<{ path: string; action: 'create' | 'modify' | 'delete' }> {
+  const files: Array<{ path: string; action: 'create' | 'modify' | 'delete' }> = [];
+
+  // Look for patterns like:
+  // - [ ] src/file.ts (create)
+  // - [x] src/file.ts (modify)
+  // + src/file.ts (create)
+  // ~ src/file.ts (modify)
+  // - src/file.ts (delete)
+
+  const lines = content.split('\n');
+  for (const line of lines) {
+    // Checkbox format
+    let match = line.match(/^[-*]\s*\[[ x]\]\s+([^\s(]+)\s*\((\w+)\)/);
+    if (match) {
+      const [, filePath, action] = match;
+      if (action === 'create' || action === 'modify' || action === 'delete') {
+        files.push({ path: filePath, action });
+      }
+      continue;
+    }
+
+    // Symbol format (+, ~, -)
+    match = line.match(/^\s*([+~-])\s+([^\s(]+)(?:\s*\((\w+)\))?/);
+    if (match) {
+      const [, symbol, filePath, explicitAction] = match;
+      let action: 'create' | 'modify' | 'delete';
+
+      if (explicitAction === 'create' || explicitAction === 'modify' || explicitAction === 'delete') {
+        action = explicitAction;
+      } else {
+        action = symbol === '+' ? 'create' : symbol === '~' ? 'modify' : 'delete';
+      }
+
+      files.push({ path: filePath, action });
+    }
+  }
+
+  return files;
+}
+
+/**
+ * Extract pre-approved permissions from plan content
+ */
+export function parsePreApprovedPermissions(content: string): Array<{ tool: 'Bash'; prompt: string }> {
+  const permissions: Array<{ tool: 'Bash'; prompt: string }> = [];
+
+  // Look for patterns like:
+  // - Bash: run tests
+  // - npm test
+  // - npm install
+
+  const permissionSection = content.match(/## Pre-approved Permissions[\s\S]*?(?=##|$)/i);
+  if (!permissionSection) {
+    return permissions;
+  }
+
+  const lines = permissionSection[0].split('\n');
+  for (const line of lines) {
+    // Skip header and empty lines
+    if (line.startsWith('##') || line.startsWith('_') || !line.trim()) {
+      continue;
+    }
+
+    // Match "- Bash: description" or "- description"
+    const match = line.match(/^[-*]\s+(?:Bash:\s+)?(.+)/);
+    if (match) {
+      permissions.push({ tool: 'Bash', prompt: match[1].trim() });
+    }
+  }
+
+  return permissions;
+}
+
+/**
+ * Get relative path for display
+ */
+export function getDisplayPath(fullPath: string, cwd: string): string {
+  const relativePath = path.relative(cwd, fullPath);
+  const home = process.env.HOME || '';
+
+  if (relativePath.startsWith('..')) {
+    // Path is outside cwd, try home-relative
+    if (fullPath.startsWith(home)) {
+      return '~' + fullPath.slice(home.length);
+    }
+    return fullPath;
+  }
+
+  return relativePath;
+}