@intend-it/core 1.0.1 → 2.0.0

package/README.md

@@ -0,0 +1,161 @@
+<div align="center">
+  <h1>@intend-it/core</h1>
+  <p><strong>AI-Powered Code Generator for the Intend Language</strong></p>
+  <p>
+    <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>
+  </p>
+</div>
+
+---
+
+## Overview
+
+`@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).
+
+### ✨ Key Features
+
+- **🧠 AI Code Generation** - Transforms natural language steps into actual code
+- **🔄 Self-Correction Loop** - Validates output and auto-fixes errors
+- **⚡ Smart Caching (CAS)** - Content-addressable storage for instant rebuilds
+- **🔌 Multi-Provider** - Supports Gemini and Ollama (local)
+- **🛡️ Type-Safe Output** - Generates valid, compilable TypeScript
+
+## Installation
+
+```bash
+npm install @intend-it/core @intend-it/parser
+# or
+bun add @intend-it/core @intend-it/parser
+```
+
+## Usage
+
+### Basic Code Generation
+
+```typescript
+import { AICodeGenerator } from "@intend-it/core";
+import { parseToAST } from "@intend-it/parser";
+
+const source = `
+export intent Add(a: number, b: number) -> number {
+    step "Add the two numbers together" => const result
+    ensure result is a number
+}
+`;
+
+const { ast } = parseToAST(source);
+
+const generator = new AICodeGenerator({
+  provider: "gemini",
+  geminiConfig: {
+    apiKey: process.env.GEMINI_API_KEY!,
+    model: "gemini-2.0-flash"
+  }
+});
+
+const result = await generator.generate(ast);
+console.log(result.code);
+// export function Add(a: number, b: number): number {
+//   const result = a + b;
+//   if (typeof result !== 'number') throw new Error(...);
+//   return result;
+// }
+```
+
+### Using Ollama (Local AI)
+
+```typescript
+const generator = new AICodeGenerator({
+  provider: "ollama",
+  ollamaConfig: {
+    model: "llama3",
+    baseUrl: "http://localhost:11434",
+    num_thread: 4 // Optional: limit CPU usage
+  }
+});
+```
+
+### Template Generation (No AI)
+
+```typescript
+import { generateTypeScript } from "@intend-it/core";
+
+const result = generateTypeScript(ast);
+// Generates template with // TODO comments
+```
+
+## Configuration Options
+
+```typescript
+interface AIGeneratorOptions {
+  provider: "gemini" | "ollama";
+  
+  geminiConfig?: {
+    apiKey: string;
+    model?: string;        // Default: "gemini-2.0-flash"
+    temperature?: number;  // Default: 0.2
+  };
+  
+  ollamaConfig?: {
+    model?: string;        // Default: "llama3"
+    baseUrl?: string;      // Default: "http://localhost:11434"
+    temperature?: number;
+    num_thread?: number;   // CPU thread limit
+  };
+  
+  maxAttempts?: number;    // Auto-correction retries (default: 5)
+}
+```
+
+## Caching with CAS
+
+The compiler includes a Content-Addressable Storage system for caching:
+
+```typescript
+import { FileSystemCAS, computeHash } from "@intend-it/core";
+
+const cas = new FileSystemCAS("./.intend/store");
+
+// Check cache
+const hash = computeHash(sourceCode, config);
+const cached = await cas.get(hash);
+
+if (cached) {
+  console.log("Cache hit!");
+  return cached.code;
+}
+
+// Generate and cache
+const result = await generator.generate(ast);
+await cas.put(hash, result.code);
+```
+
+## Architecture
+
+```
+┌─────────────────┐     ┌──────────────┐     ┌─────────────────┐
+│  .intent file   │ ──▶ │    Parser    │ ──▶ │       AST       │
+└─────────────────┘     └──────────────┘     └────────┬────────┘
+                                                      │
+                        ┌──────────────┐              ▼
+                        │   AI Provider │ ◀── ┌─────────────────┐
+                        │ (Gemini/Ollama)│    │  Prompt Builder │
+                        └───────┬───────┘    └─────────────────┘
+                                │
+                                ▼
+                        ┌──────────────┐     ┌─────────────────┐
+                        │  Validator   │ ──▶ │  TypeScript.ts  │
+                        │ (auto-retry) │     └─────────────────┘
+                        └──────────────┘
+```
+
+## Related Packages
+
+- [`@intend-it/parser`](https://www.npmjs.com/package/@intend-it/parser) - Lexer and parser
+- [`@intend-it/cli`](https://www.npmjs.com/package/@intend-it/cli) - Command-line interface
+
+## License
+
+MIT © [Intend Team](https://github.com/DRFR0ST/intend)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intend-it/core",
-  "version": "1.0.1",
+  "version": "2.0.0",
   "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": "workspace:*",
+    "@intend-it/parser": "^1.1.0",
     "@google/generative-ai": "^0.21.0"
   },
   "devDependencies": {
@@ -43,6 +43,6 @@
     "typescript": "^5.0.0"
   },
   "peerDependencies": {
-    "@intend-it/parser": ">=1.0.1"
+    "@intend-it/parser": ">=1.1.0"
   }
 }