gencode-ai 0.1.1 → 0.1.2

package/dist/memory/index.js

@@ -1,9 +1,11 @@
 /**
- * Memory System Module
+ * Memory System - Claude Code compatible memory management
  *
- * Provides context management for AI conversations through
- * hierarchical memory files (CLAUDE.md, AGENT.md, etc.)
+ * Provides hierarchical memory loading with AGENT.md (primary) and CLAUDE.md (fallback)
  */
-export { MemoryManager } from './manager.js';
-export { analyzeProject, generateMemoryContent, runInit } from './init.js';
+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';
 //# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzG,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/memory/init-prompt.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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
+ */
+export interface ContextFiles {
+    [path: string]: string;
+}
+/**
+ * Gather context files for project analysis
+ */
+export declare function gatherContextFiles(cwd: string): Promise<ContextFiles>;
+/**
+ * Build the init prompt for generating AGENT.md
+ */
+export declare function buildInitPrompt(contextFiles: ContextFiles, existingAgentMd?: string): string;
+/**
+ * Get a summary of files found for user feedback
+ */
+export declare function getContextSummary(contextFiles: ContextFiles): string;
+//# sourceMappingURL=init-prompt.d.ts.map

package/dist/memory/init-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-prompt.d.ts","sourceRoot":"","sources":["../../src/memory/init-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,YAAY;IAC3B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAyC3E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,YAAY,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAqC5F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAMpE"}

package/dist/memory/init-prompt.js

@@ -0,0 +1,103 @@
+/**
+ * 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';
+/**
+ * Gather context files for project analysis
+ */
+export async function gatherContextFiles(cwd) {
+    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 = {};
+    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, existingAgentMd) {
+    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) {
+    const fileNames = Object.keys(contextFiles);
+    if (fileNames.length === 0) {
+        return 'No context files found';
+    }
+    return `Found ${fileNames.length} context file(s): ${fileNames.join(', ')}`;
+}
+//# sourceMappingURL=init-prompt.js.map

package/dist/memory/init-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-prompt.js","sourceRoot":"","sources":["../../src/memory/init-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAM5B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAW;IAClD,MAAM,QAAQ,GAAG;QACf,cAAc;QACd,WAAW;QACX,iBAAiB;QACjB,uBAAuB;QACvB,cAAc;QACd,iCAAiC;QACjC,YAAY;QACZ,QAAQ;QACR,gBAAgB;QAChB,eAAe;QACf,UAAU;QACV,oBAAoB;QACpB,qBAAqB;KACtB,CAAC;IAEF,MAAM,KAAK,GAAiB,EAAE,CAAC;IAE/B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9D,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACxC,oBAAoB;gBACpB,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;oBACvC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;oBACrD,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;wBAC3B,sBAAsB;wBACtB,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;oBACzB,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,gCAAgC;gBAClC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,YAA0B,EAAE,eAAwB;IAClF,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;SAC9C,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,QAAQ,aAAa,OAAO,UAAU,CAAC;SAC3E,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,MAAM,eAAe,GAAG,eAAe;QACrC,CAAC,CAAC,6CAA6C,eAAe,YAAY;QAC1E,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;;;EAIP,YAAY;EACZ,eAAe;;;;;;;;;;IAUb,eAAe,CAAC,CAAC,CAAC,gDAAgD,CAAC,CAAC,CAAC,wBAAwB;;;;;;;;;;;;0EAYvB,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAA0B;IAC1D,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC5C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,wBAAwB,CAAC;IAClC,CAAC;IACD,OAAO,SAAS,SAAS,CAAC,MAAM,qBAAqB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9E,CAAC"}

package/dist/memory/memory-manager.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Memory Manager - Core memory system implementation
+ *
+ * Implements Claude Code compatible memory loading with merge semantics:
+ * At each level, both .gencode and .claude directories are loaded.
+ * Content from .gencode appears later in the context (higher priority for LLM).
+ *
+ * Loading order within each level:
+ * 1. .claude files first (lower priority - LLM sees earlier)
+ * 2. .gencode files second (higher priority - LLM sees later)
+ *
+ * Level loading order:
+ * 1. Enterprise (system-wide managed, enforced)
+ * 2. User (~/.gencode/ + ~/.claude/)
+ * 3. User Rules
+ * 4. Extra (GENCODE_CONFIG_DIRS)
+ * 5. Project (recursive upward search)
+ * 6. Project Rules
+ * 7. Local (*.local.md files)
+ */
+import type { MemoryConfig, LoadedMemory, MemoryLoadOptions } from './types.js';
+export declare class MemoryManager {
+    private config;
+    private importResolver;
+    private loadedMemory;
+    constructor(config?: Partial<MemoryConfig>);
+    /**
+     * Load all memory files for the given working directory
+     */
+    load(options: MemoryLoadOptions): Promise<LoadedMemory>;
+    /**
+     * Get the current loaded memory
+     */
+    getLoaded(): LoadedMemory | null;
+    /**
+     * Check if any memory is loaded
+     */
+    hasMemory(): boolean;
+    /**
+     * Build combined context string for system prompt injection
+     */
+    private buildContext;
+    private getLevelLabel;
+    /**
+     * Load enterprise-level memory files
+     */
+    private loadEnterpriseMemory;
+    /**
+     * Load user-level memory files (both claude and gencode)
+     */
+    private loadUserMemory;
+    /**
+     * Load user-level rules (both claude and gencode)
+     */
+    private loadUserRules;
+    /**
+     * Load extra config dirs memory
+     */
+    private loadExtraMemory;
+    /**
+     * Parse GENCODE_CONFIG_DIRS environment variable
+     */
+    private parseExtraConfigDirs;
+    /**
+     * Load project-level memory files (both claude and gencode)
+     */
+    private loadProjectMemory;
+    /**
+     * Load project-level rules (both claude and gencode)
+     */
+    private loadProjectRules;
+    /**
+     * Load local memory files (both claude and gencode)
+     */
+    private loadLocalMemory;
+    /**
+     * Load rules from a directory
+     */
+    private loadRulesFromDir;
+    /**
+     * Load a single file with import resolution
+     */
+    private loadFile;
+    /**
+     * Find project root (git root or cwd)
+     */
+    private findProjectRoot;
+    /**
+     * Quick add content to memory file
+     */
+    quickAdd(content: string, level: 'user' | 'project', cwd: string): Promise<string>;
+    /**
+     * Get list of loaded files for /memory command
+     */
+    getLoadedFileList(): Array<{
+        path: string;
+        level: string;
+        namespace: string;
+        size: number;
+        type: 'file' | 'rule';
+    }>;
+    /**
+     * Get the path where /init would create a file
+     */
+    getInitFilePath(cwd: string): string;
+    /**
+     * Check if project memory already exists
+     */
+    hasProjectMemory(cwd: string): Promise<boolean>;
+    /**
+     * Get the path of existing project memory file
+     */
+    getExistingProjectMemoryPath(cwd: string): Promise<string | null>;
+    /**
+     * Get debug summary of loaded memory
+     */
+    getDebugSummary(): string;
+}
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/memory/memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../src/memory/memory-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH,OAAO,KAAK,EACV,YAAY,EAGZ,YAAY,EACZ,iBAAiB,EAIlB,MAAM,YAAY,CAAC;AAIpB,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAA6B;gBAErC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAM1C;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IA8I7D;;OAEG;IACH,SAAS,IAAI,YAAY,GAAG,IAAI;IAIhC;;OAEG;IACH,SAAS,IAAI,OAAO;IAOpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,aAAa;IAcrB;;OAEG;YACW,oBAAoB;IA6BlC;;OAEG;YACW,cAAc;IAuB5B;;OAEG;YACW,aAAa;IAiB3B;;OAEG;YACW,eAAe;IAyB7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;YACW,iBAAiB;IAkC/B;;OAEG;YACW,gBAAgB;IAgB9B;;OAEG;YACW,eAAe;IAkC7B;;OAEG;YACW,gBAAgB;IAuC9B;;OAEG;YACW,QAAQ;IA6BtB;;OAEG;YACW,eAAe;IAiB7B;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BxF;;OAEG;IACH,iBAAiB,IAAI,KAAK,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB,CAAC;IAkCF;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIpC;;OAEG;IACG,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBrD;;OAEG;IACG,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqBvE;;OAEG;IACH,eAAe,IAAI,MAAM;CAoB1B"}