@intend-it/cli 1.0.1 → 1.1.1

package/README.md

@@ -0,0 +1,200 @@
+<div align="center">
+  <h1>@intend-it/cli</h1>
+  <p><strong>Command-Line Interface for the Intend Programming Language</strong></p>
+  <p>
+    <a href="https://www.npmjs.com/package/@intend-it/cli"><img src="https://img.shields.io/npm/v/@intend-it/cli.svg" alt="npm version"></a>
+    <a href="https://www.npmjs.com/package/@intend-it/cli"><img src="https://img.shields.io/npm/dm/@intend-it/cli.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/cli.svg" alt="license"></a>
+  </p>
+</div>
+
+---
+
+## Overview
+
+The official CLI for building **Intend** projects. Write your intentions, let AI generate the code.
+
+### ✨ Features
+
+- **🚀 Zero Config** - Works out of the box with sensible defaults
+- **⚡ Instant Builds** - Smart caching means unchanged files build instantly
+- **🔄 Watch Mode** - Auto-rebuild on file changes
+- **🤖 AI Providers** - Supports Gemini and Ollama (local)
+- **🛡️ Self-Healing** - Auto-corrects AI mistakes with validation loop
+
+## Installation
+
+```bash
+# Global install
+npm install -g @intend-it/cli
+
+# Or use with npx/bunx
+npx @intend-it/cli build
+bunx @intend-it/cli build
+```
+
+## Quick Start
+
+```bash
+# 1. Create a new project
+intend init my-app
+cd my-app
+
+# 2. Set your API key
+export GEMINI_API_KEY="your-key-here"
+
+# 3. Build!
+intend build
+```
+
+## Commands
+
+### `intend init [directory]`
+
+Initialize a new Intend project with configuration and example files.
+
+```bash
+intend init my-project
+intend init .  # Current directory
+```
+
+Creates:
+- `intend.config.json` - Project configuration
+- `src/intents/` - Directory for `.intent` files
+- `out/` - Output directory for generated TypeScript
+
+### `intend build`
+
+Build all `.intent` files in your project.
+
+```bash
+intend build                    # Build with default config
+intend build --force            # Ignore cache, rebuild all
+intend build --attempts=10      # Set retry limit
+intend build --provider=ollama  # Use Ollama instead of Gemini
+```
+
+**Options:**
+| Flag | Description |
+|------|-------------|
+| `--config <path>` | Custom config file path |
+| `--output <dir>` | Override output directory |
+| `--provider <name>` | AI provider: `gemini` or `ollama` |
+| `--api-key <key>` | Gemini API key |
+| `--force` | Ignore cache, rebuild everything |
+| `--attempts <n>` | Max auto-correction retries (default: 5) |
+
+### `intend watch`
+
+Watch for changes and auto-rebuild.
+
+```bash
+intend watch
+```
+
+### `intend parse <file>`
+
+Parse a single file and output AST/CST (useful for debugging).
+
+```bash
+intend parse src/intents/user.intent --ast
+intend parse src/intents/user.intent --cst
+```
+
+## Configuration
+
+Create `intend.config.json` in your project root:
+
+```json
+{
+  "sourceDir": "./src/intents",
+  "outDir": "./out",
+  "provider": "gemini",
+  "gemini": {
+    "apiKey": "${GEMINI_API_KEY}",
+    "model": "gemini-2.0-flash",
+    "temperature": 0.2
+  }
+}
+```
+
+### Using Ollama (Local AI)
+
+```json
+{
+  "sourceDir": "./src/intents",
+  "outDir": "./out",
+  "provider": "ollama",
+  "ollama": {
+    "model": "llama3",
+    "baseUrl": "http://localhost:11434",
+    "num_thread": 4
+  }
+}
+```
+
+## Example Workflow
+
+**1. Write an intent file** (`src/intents/math.intent`):
+
+```typescript
+export intent Add(a: number, b: number) -> number {
+    invariant "Both inputs must be numbers"
+    step "Add the two numbers together" => const result
+    ensure result is a number
+}
+
+export intent Multiply(a: number, b: number) -> number {
+    step "Multiply the numbers" => const product
+    ensure product is a number
+}
+```
+
+**2. Build:**
+
+```bash
+$ intend build
+
+✨ Intend Build
+
+  Source   ./src/intents
+  Output   ./out
+  Provider gemini
+
+◐ Scanning for .intent files...
+  ✔ Found 1 intent file
+
+Compiling
+
+  ✔ math.intent 1247ms
+
+Summary
+
+  ✔ 1 compiled
+  → 1.25s
+```
+
+**3. Use the generated code:**
+
+```typescript
+import { Add, Multiply } from "./out/math";
+
+const sum = Add(5, 3);      // 8
+const product = Multiply(4, 7); // 28
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `GEMINI_API_KEY` | Google Gemini API key |
+| `INTEND_PROVIDER` | Default provider (`gemini` or `ollama`) |
+
+## Related Packages
+
+- [`@intend-it/parser`](https://www.npmjs.com/package/@intend-it/parser) - Lexer and parser
+- [`@intend-it/core`](https://www.npmjs.com/package/@intend-it/core) - AI code generator
+
+## License
+
+MIT © [Intend Team](https://github.com/DRFR0ST/intend)

package/dist/index.js

@@ -65,9 +65,12 @@ function createConfigFile(directory = process.cwd()) {
 // src/ui.ts
 import pc from "picocolors";
 import ora from "ora";
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+var pkg = require2("../package.json");
 var BRAND = {
   name: "intend",
-  version: "0.0.1"
+  version: pkg.version
 };
 var heading = (text) => pc.bold(text);
 var success = (text) => pc.green(text);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intend-it/cli",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "CLI for the Intend programming language",
   "type": "module",
   "bin": {
@@ -29,8 +29,8 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@intend-it/parser": "workspace:*",
-    "@intend-it/core": "workspace:*",
+    "@intend-it/parser": "^1.1.1",
+    "@intend-it/core": "^2.0.1",
     "picocolors": "^1.1.1",
     "ora": "^8.1.1"
   },