@intend-it/core 4.0.0 → 4.0.2

package/README.md

@@ -2,6 +2,7 @@
   <h1>@intend-it/core</h1>
   <p><strong>AI-Powered Code Generator for the Intend Language</strong></p>
   <p>
+    <a href="https://intend.fly.dev">Documentation</a> •
     <a href="https://www.npmjs.com/package/@intend-it/core"><img src="https://img.shields.io/npm/v/@intend-it/core.svg" alt="npm version"></a>
     <a href="https://www.npmjs.com/package/@intend-it/core"><img src="https://img.shields.io/npm/dm/@intend-it/core.svg" alt="npm downloads"></a>
     <a href="https://github.com/DRFR0ST/intend/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@intend-it/core.svg" alt="license"></a>
@@ -14,9 +15,12 @@
 
 `@intend-it/core` is the heart of the Intend compiler. It takes parsed AST from `@intend-it/parser` and generates production-ready TypeScript code using AI (Google Gemini or Ollama).
 
+**[Read the full documentation 📖](https://intend.fly.dev)**
+
 ### ✨ Key Features
 
 - **🧠 AI Code Generation** - Transforms natural language steps into actual code
+- **🌐 Global Context** - Define file-level rules using the `context` keyword
 - **🔀 Hybrid Orchestration** - Mix AI steps with deterministic function calls
 - **🔄 Self-Correction Loop** - Validates output and auto-fixes errors
 - **⚡ Smart Caching (CAS)** - Content-addressable storage for instant rebuilds

package/dist/index.js

@@ -168803,8 +168803,15 @@ class TypeScriptGenerator {
 `;
         code += `if (import.meta.main) {
 `;
-        code += `  Promise.resolve(${intent.name}()).catch((err: any) => console.error(err));
+        if (intent.parameters.length === 0) {
+          code += `  Promise.resolve(${intent.name}()).catch((err: any) => console.error(err));
 `;
+        } else {
+          code += `  // CLI Auto-Run disabled: function requires arguments
+`;
+          code += `  // Promise.resolve(${intent.name}(/* ...args */)).catch((err: any) => console.error(err));
+`;
+        }
         code += `}
 `;
       }
@@ -168817,7 +168824,8 @@ class TypeScriptGenerator {
   }
   generateImport(imp) {
     const specifiers = imp.specifiers.join(", ");
-    return `import { ${specifiers} } from "${imp.source}";`;
+    const source = imp.source.replace(/\.intent$/, "");
+    return `import { ${specifiers} } from "${source}";`;
   }
   generateJsDoc(intent) {
     const lines = ["/**"];
@@ -169165,9 +169173,10 @@ ${request.prompt}`;
 }
 // src/ai/prompt-builder.ts
 class PromptBuilder {
-  buildContext(intent, fileImports, importedIntents = []) {
+  buildContext(intent, fileImports, importedIntents = [], fileContext) {
     const returnType = this.formatReturnType(intent.returnType);
     return {
+      fileContext,
       functionName: intent.name,
       parameters: intent.parameters,
       returnType,
@@ -169179,27 +169188,33 @@ class PromptBuilder {
     };
   }
   buildSystemPrompt() {
-    return `You are an expert TypeScript developer specializing in clean, production-ready code.
-
-Your task is to implement function bodies based on natural language specifications.
-
-Rules:
-1. Generate ONLY the implementation code (function body content)
-2. Do NOT include the function signature or braces
-3. Use modern TypeScript syntax and best practices
-4. Handle errors appropriately (throw Error with descriptive messages)
-5. Return values must match the specified return type
-6. Follow the exact steps provided in order
-7. Respect all invariants (add runtime checks if needed)
-8. Ensure all postconditions are satisfied
-9. Use descriptive variable names
-10. Keep code clean and readable`;
+    return `You are an expert Senior TypeScript Developer specializing in robust, production-grade code.
+ 
+ Your task is to implement function bodies based on structured natural language specifications (Intend).
+ 
+ Rules:
+ 1. Generate ONLY the implementation code (function body content).
+ 2. Do NOT include the function signature, exports, or braces surfacing the function.
+ 3. Use strict TypeScript (no 'any' unless absolutely necessary).
+ 4. Handle edge cases and errors defensively (throw descriptive Errors).
+ 5. Return values must strictly match the specified return type.
+ 6. Follow the provided steps EXACTLY in order.
+ 7. Respect all invariants (implement usage checks at the start if needed).
+ 8. Ensure all postconditions (ensures) are satisfiable by your logic.
+ 9. Use clear, semantic variable names.
+ 10. Do not hallucinate imports; use only what is provided.
+ 11. If a variable name in the requirements seems to have a typo (e.g. 'totals' instead of 'total'), fix it to match the defined variable.`;
   }
   buildStepPrompt(context, stepIndex) {
     const step = context.steps[stepIndex];
     const lines = [];
     lines.push(`Implement this TypeScript function step:
 `);
+    if (context.fileContext) {
+      lines.push(`GLOBAL CONTEXT / RULES:`);
+      lines.push(context.fileContext);
+      lines.push("");
+    }
     lines.push(`Function: ${context.functionName}`);
     lines.push(`Parameters: ${this.formatParameters(context.parameters)}`);
     lines.push(`Return Type: ${context.returnType}
@@ -169261,6 +169276,11 @@ Generate ONLY the TypeScript code for this step (no explanations, no markdown).`
     const lines = [];
     lines.push(`Implement this complete TypeScript function:
 `);
+    if (context.fileContext) {
+      lines.push(`GLOBAL CONTEXT / RULES:`);
+      lines.push(context.fileContext);
+      lines.push("");
+    }
     lines.push(`Function: ${context.functionName}`);
     lines.push(`Parameters: ${this.formatParameters(context.parameters)}`);
     lines.push(`Return Type: ${context.returnType}
@@ -169314,6 +169334,9 @@ Generate ONLY the TypeScript code for this step (no explanations, no markdown).`
     lines.push(`The code should:`);
     lines.push(`- Follow all steps in order`);
     lines.push(`- Store results in the specified variable names`);
+    lines.push(`- Make sure that imported functions are called with the correct arguments from the context.`);
+    lines.push(`- Make sure the return value matches the expected return type strictly.`);
+    lines.push(`- If a Step requires a return, ensure it is returned.`);
     lines.push(`- Satisfy all postconditions`);
     lines.push(`- Be production-ready TypeScript`);
     lines.push(`
@@ -169395,6 +169418,7 @@ Verify:`);
     lines.push(`3. All declared variables are used`);
     lines.push(`4. Return value matches required type`);
     lines.push(`5. No infinite loops or unintended recursion`);
+    lines.push(`6. Imports are correct (no .intent extension, only using provided imports)`);
     lines.push(`
 Respond with APPROVED or ISSUES + FIX as specified.`);
     return lines.join(`
@@ -169791,7 +169815,10 @@ class TypeScriptValidator {
       esModuleInterop: true,
       skipLibCheck: true,
       checkJs: false,
-      allowJs: false
+      allowJs: false,
+      noImplicitReturns: true,
+      strictNullChecks: true,
+      noImplicitAny: true
     };
     const host = ts.createCompilerHost(compilerOptions);
     const originalReadFile = host.readFile;
@@ -169810,6 +169837,12 @@ class TypeScriptValidator {
 `);
       if (msg.includes("Cannot find global type"))
         return false;
+      if (msg.includes("Cannot find name 'process'"))
+        return false;
+      if (msg.includes("Cannot find name 'console'"))
+        return false;
+      if (msg.includes("Cannot find name 'Buffer'"))
+        return false;
       return true;
     }).map((d) => {
       const line = d.file ? d.file.getLineAndCharacterOfPosition(d.start).line + 1 : 0;
@@ -169839,7 +169872,7 @@ class AICodeGenerator {
   constructor(options) {
     this.promptBuilder = new PromptBuilder;
     this.validator = new TypeScriptValidator;
-    this.mode = options.mode || "full";
+    this.mode = "full";
     this.maxAttempts = options.maxAttempts ?? 3;
     this.projectContext = options.projectContext;
     this.debug = options.debug ?? false;
@@ -169886,10 +169919,9 @@ class AICodeGenerator {
           }
         }
       }
-      const context = this.promptBuilder.buildContext(intent, file.imports, importedIntents);
+      const context = this.promptBuilder.buildContext(intent, file.imports, importedIntents, file.context);
       totalSteps += context.steps.length;
       if (this.mode === "step-by-step") {
-        console.warn("Step-by-step mode not fully supported for multi-intent files. Falling back to full generation.");
         currentCode = await this.generateFull(currentCode, context, intent.name);
       } else {
         currentCode = await this.generateFull(currentCode, context, intent.name);
@@ -169917,18 +169949,22 @@ class AICodeGenerator {
         throw new Error(`AI generation failed: ${response.error}`);
       }
       const cleanCode = this.sanitizeAIResponse(response.code);
-      const updatedCode = this.injectImplementation(fileContent, cleanCode, functionName);
-      const syntaxErrors = this.validator.validate(updatedCode);
+      const { code: updatedCode, startLine, endLine } = this.injectImplementation(fileContent, functionName, cleanCode);
+      let syntaxErrors = this.validator.validate(updatedCode);
+      syntaxErrors = syntaxErrors.filter((e) => e.line >= startLine + 1 && e.line <= endLine + 1);
       if (syntaxErrors.length > 0) {
         attempts++;
         if (attempts < limit) {
           const errorMsg = syntaxErrors.slice(0, 5).map((e) => `Line ${e.line}: ${e.message}`).join(`
 `);
-          console.log(`   ⚠️  Validation failed for ${functionName} (Attempt ${attempts}/${limit}):`);
+          console.log(`
+      ⚠️  Validation failed for ${functionName} (Attempt ${attempts}/${limit}):`);
           console.log(errorMsg.split(`
 `).map((l) => `      ${l}`).join(`
 `));
-          console.log(`      Retrying with AI auto-correction...`);
+          console.log(`
+      Retrying with AI auto-correction...
+`);
           prompt += `
 
 Validation Failed (Attempt ${attempts}/${limit}).
@@ -169940,14 +169976,17 @@ ${cleanCode}
 ` + `Errors encountered:
 ${errorMsg}
 
-` + `CRITICAL INSTRUCTION: Don't just patch the code. 
-` + `1. First, analyze WHY this error occurred (e.g., mismatching types, undefined variable).
-` + `2. Then, generate the completely fixed function body wrapped in a \`\`\`typescript block.
+` + `CRITICAL: You are fixing a critical syntax/compilation error.
+` + `1. ANALYZE: Briefly explain why the error happened.
+` + `2. FIX: Generate the COMPLETE, FIXED function body wrapped in \`\`\`typescript.
+` + `Do not return partial snippets. Return the full function body.
 `;
         } else {
-          console.warn(`   ❌ Validation failed for ${functionName} after ${limit} attempts.`);
-          await this.explainFailure(functionName, updatedCode, syntaxErrors);
-          return updatedCode;
+          const errorMsg = syntaxErrors.slice(0, 5).map((e) => `Line ${e.line}: ${e.message}`).join(`
+`);
+          throw new Error(`Validation failed for ${functionName} after ${limit} attempts.
+Errors:
+${errorMsg}`);
         }
         continue;
       }
@@ -169957,10 +169996,12 @@ ${errorMsg}
       }
       attempts++;
       if (attempts < limit) {
-        console.log(`   \uD83D\uDD0D Logic review found issues for ${functionName} (Attempt ${attempts}/${limit}):`);
+        console.log(`
+      \uD83D\uDD0D Logic review found issues for ${functionName} (Attempt ${attempts}/${limit}):`);
         console.log(`      ${logicIssues.issues.slice(0, 3).join(`
       `)}`);
-        console.log(`      Retrying with AI auto-correction...`);
+        console.log(`      Retrying with AI auto-correction...
+`);
         prompt += `
 
 Logic Review Failed (Attempt ${attempts}/${limit}).
@@ -169975,17 +170016,23 @@ ${logicIssues.issues.join(`
 
 ` + `Suggested fix: ${logicIssues.fix}
 
-` + `CRITICAL INSTRUCTION: Fix all logical issues and generate the corrected function body.
+` + `CRITICAL: You are fixing a LOGICAL issue.
+` + `1. ANALYZE: Briefly explain the logic flaw.
+` + `2. FIX: Generate the COMPLETE, FIXED function body wrapped in \`\`\`typescript.
+` + `Ensure every step from the requirements is fully implemented.
 `;
       } else {
-        console.warn(`   ❌ Logic verification failed for ${functionName} after ${limit} attempts.`);
-        return updatedCode;
+        throw new Error(`Logic verification failed for ${functionName} after ${limit} attempts.
+Issues:
+${logicIssues.issues.join(`
+`)}`);
       }
     }
     return fileContent;
   }
   sanitizeAIResponse(code) {
     let sanitized = code.replace(/```typescript\s*/g, "").replace(/```\s*/g, "");
+    sanitized = sanitized.replace(/^(Here is|Sure|I have|Certainly).+$/gim, "");
     sanitized = sanitized.replace(/^\s*import\s+.*;?\s*$/gm, "");
     return sanitized.trim();
   }
@@ -170029,40 +170076,9 @@ ${logicIssues.issues.join(`
     }
   }
   async explainFailure(functionName, code, errors) {
-    const errorMsg = errors.map((e) => `Line ${e.line}: ${e.message}`).join(`
-`);
-    const prompt = `
-The following TypeScript implementation for '${functionName}' failed validation after multiple self-correction attempts.
-
-Code:
-${code}
-
-Errors:
-${errorMsg}
-
-Please explain to the user why this code is failing and what they might need to fix in their .intend file or configuration.
-Focus on the root cause. Keep it concise.
-`;
-    try {
-      console.log(`   \uD83E\uDD16 Analyzing failure...`);
-      const response = await this.provider.generateCode({
-        systemPrompt: "You are a helpful coding assistant explaining compile errors.",
-        prompt,
-        debug: this.debug
-      });
-      if (response.success) {
-        console.log(`
-==================================================`);
-        console.log("\uD83E\uDD16 AI DIAGNOSTICS:");
-        console.log(response.code);
-        console.log(`==================================================
-`);
-      }
-    } catch (err) {
-      console.warn("Failed to generate diagnostics.");
-    }
+    return;
   }
-  injectImplementation(fileContent, implementation, functionName) {
+  injectImplementation(fileContent, functionName, implementation) {
     const lines = fileContent.split(`
 `);
     let startLine = -1;
@@ -170090,8 +170106,12 @@ Focus on the root cause. Keep it concise.
       }
     }
     if (!foundStart || endLine === -1) {
-      console.error(`Could not find function body for ${functionName}. Regex: ${regex}`);
-      return fileContent;
+      throw new Error(`Fatal: Could not filter function body for injection.
+Function: ${functionName}
+Regex: ${regex}
+Start found: ${foundStart}, End found: ${endLine !== -1}
+
+Possible cause: Formatting mismatch between template and injector.`);
     }
     const pre = lines.slice(0, startLine + 1).join(`
 `);
@@ -170104,9 +170124,13 @@ Focus on the root cause. Keep it concise.
       return "";
     }).join(`
 `);
-    return pre + `
-` + indentedImpl + `
-` + post;
+    return {
+      code: `${pre}
+${indentedImpl}
+${post}`,
+      startLine: startLine + 1,
+      endLine: endLine + 1
+    };
   }
   async testConnection() {
     return await this.provider.testConnection();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intend-it/core",
-  "version": "4.0.0",
+  "version": "4.0.2",
   "description": "Core compiler and AI integration for the Intend programming language",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -35,7 +35,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@intend-it/parser": "^1.3.0",
+    "@intend-it/parser": "^1.3.2",
     "@google/generative-ai": "^0.21.0"
   },
   "devDependencies": {
@@ -43,6 +43,6 @@
     "typescript": "^5.0.0"
   },
   "peerDependencies": {
-    "@intend-it/parser": ">=1.3.0"
+    "@intend-it/parser": ">=1.3.2"
   }
 }