codehere 0.1.0

package/dist/docs.js

@@ -0,0 +1,147 @@
+/**
+ * Documentation Generator
+ * Auto-generate and maintain documentation
+ */
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { chatWithContext } from './chat.js';
+import { getEnhancedContext } from './context.js';
+/**
+ * Generate documentation for a file
+ */
+export async function generateFileDocs(filepath) {
+    const fullPath = join(process.cwd(), filepath);
+    if (!existsSync(fullPath)) {
+        throw new Error(`File not found: ${filepath}`);
+    }
+    const content = readFileSync(fullPath, 'utf-8');
+    const ext = filepath.split('.').pop()?.toLowerCase() || '';
+    // Get context
+    const context = await getEnhancedContext(`Generate documentation for ${filepath}`, {
+        primaryChunks: 10,
+        includeRelationships: true,
+    });
+    // Create documentation prompt
+    const docPrompt = `Generate comprehensive documentation for this code file:
+
+File: ${filepath}
+Code:
+\`\`\`${ext}
+${content}
+\`\`\`
+
+Provide:
+1. File overview and purpose
+2. Main functions/classes and their purposes
+3. Parameters and return values
+4. Usage examples
+5. Important notes or warnings
+
+Format as clear markdown documentation.`;
+    const contextResults = [{
+            filepath,
+            content,
+            score: 1.0,
+        }, ...context.primaryChunks];
+    const docs = await chatWithContext(docPrompt, contextResults);
+    return docs;
+}
+/**
+ * Generate README for a project
+ */
+export async function generateREADME(files) {
+    // Get project context
+    const context = await getEnhancedContext('Generate project README documentation', {
+        primaryChunks: 30,
+        includeRelationships: true,
+    });
+    const fileList = files || context.primaryChunks.map(c => c.filepath);
+    const fileContents = fileList
+        .slice(0, 10)
+        .map(f => {
+        try {
+            const content = readFileSync(join(process.cwd(), f), 'utf-8');
+            return `\n### ${f}\n\`\`\`\n${content.substring(0, 200)}...\n\`\`\``;
+        }
+        catch {
+            return '';
+        }
+    })
+        .join('\n');
+    const readmePrompt = `Generate a comprehensive README.md for this project:
+
+Key files:
+${fileList.slice(0, 20).map(f => `- ${f}`).join('\n')}
+
+${fileContents}
+
+Create a professional README with:
+1. Project title and description
+2. Features
+3. Installation instructions
+4. Usage examples
+5. Project structure
+6. Contributing guidelines
+7. License information
+
+Format as markdown.`;
+    const contextResults = context.primaryChunks;
+    const readme = await chatWithContext(readmePrompt, contextResults);
+    return readme;
+}
+/**
+ * Update existing documentation
+ */
+export async function updateDocs(filepath) {
+    const fullPath = join(process.cwd(), filepath);
+    if (!existsSync(fullPath)) {
+        throw new Error(`File not found: ${filepath}`);
+    }
+    const currentContent = readFileSync(fullPath, 'utf-8');
+    const codePath = filepath.replace(/\.md$/, '').replace(/docs\//, '');
+    // Get current code
+    let codeContent = '';
+    try {
+        const codeFile = join(process.cwd(), codePath);
+        if (existsSync(codeFile)) {
+            codeContent = readFileSync(codeFile, 'utf-8');
+        }
+    }
+    catch {
+        // Code file might not exist
+    }
+    const updatePrompt = `Update this documentation to match the current code:
+
+Documentation file: ${filepath}
+Current docs:
+\`\`\`
+${currentContent}
+\`\`\`
+
+Current code:
+\`\`\`
+${codeContent.substring(0, 1000)}
+\`\`\`
+
+Update the documentation to accurately reflect the current code implementation.`;
+    const contextResults = [{
+            filepath,
+            content: currentContent,
+            score: 1.0,
+        }];
+    const updatedDocs = await chatWithContext(updatePrompt, contextResults);
+    return updatedDocs;
+}
+/**
+ * Save documentation to file
+ */
+export function saveDocs(filepath, content) {
+    const fullPath = join(process.cwd(), filepath);
+    const dir = dirname(fullPath);
+    if (!existsSync(dir)) {
+        const { mkdirSync } = require('fs');
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(fullPath, content, 'utf-8');
+}
+//# sourceMappingURL=docs.js.map

package/dist/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"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"}

package/dist/edit.d.ts

@@ -0,0 +1,38 @@
+import type { DiffStats, PolicyResult } from './types.js';
+export declare function parseDiffStats(diffText: string): DiffStats;
+export declare function applyUnifiedDiff(originalContent: string, diffText: string): string;
+/**
+ * Generate and validate diff without applying (for dry-run)
+ */
+export declare function generateEditDryRun(filepath: string, instruction: string): Promise<{
+    success: boolean;
+    diffText?: string;
+    diffStats?: DiffStats;
+    policyResult?: PolicyResult;
+    error?: string;
+    newContent?: string;
+    syntaxValid?: boolean;
+}>;
+/**
+ * Legacy function - kept for backward compatibility
+ * Use generateAndApplyEditWithVerification() for new code
+ */
+export declare function generateAndApplyEdit(filepath: string, instruction: string): Promise<{
+    success: boolean;
+    diffStats?: DiffStats;
+    policyResult?: PolicyResult;
+    error?: string;
+}>;
+/**
+ * NEW: Generate and apply edit with verification and iterative refinement
+ */
+export declare function generateAndApplyEditWithVerification(filepath: string, instruction: string, requirements?: string[]): Promise<{
+    success: boolean;
+    verified: boolean;
+    iterations: number;
+    diffStats?: DiffStats;
+    policyResult?: PolicyResult;
+    error?: string;
+    verificationErrors?: string[];
+}>;
+//# sourceMappingURL=edit.d.ts.map

package/dist/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../src/edit.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK1D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAkC1D;AAED,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsClF;AAwSD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC,CAyFD;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwFnG;AAED;;GAEG;AACH,wBAAsB,oCAAoC,CACxD,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B,CAAC,CAyFD"}