@intend-it/cli 1.3.1 → 1.3.3

package/README.md

@@ -65,6 +65,17 @@ Creates:
 - `intend.config.json` - Project configuration
 - `src/intents/` - Directory for `.intent` files
 - `out/` - Output directory for generated TypeScript
+- `intend.lock` - Deterministic build lockfile (commit this!)
+
+### 🔒 Build Lockfile (`intend.lock`)
+
+To ensure that your builds are deterministic and fast, Intend uses a lockfile system. 
+
+When you run `intend build`, the CLI calculates a hash of your `.intent` source code and your configuration. If a match is found in `intend.lock`, the compiler uses the cached implementation instead of calling the AI provider.
+
+- **Fast Rebuilds**: Near-instant builds for unchanged files.
+- **Stable Production**: Your code won't change in CI/CD unless you explicitly change the intention.
+- **Version Control**: You should always commit `intend.lock` to your repository.
 
 ### `intend build`
 

package/dist/index.js

@@ -254,14 +254,30 @@ async function initCommand(args) {
   if (!existsSync2(examplePath)) {
     const exampleContent = `import { User } from "../types";
 
+export intent GenerateRandomId() -> string {
+    step "Generate a random numeric ID" => const id: number
+    return id
+}
+
 export intent CreateUser(name: string) -> User {
-    step "Generate a random ID" => const id
-    step "Create a User object with name, id, and current date" => const user
+    GenerateRandomId() => const id
+    step "Create a User object with name, id, and current date" => const user: User
+    
     return user
 }
 
+// Entry point 
 export entry intent Main() -> void {
-    step "Call CreateUser with name 'Intender'" => const user
+    step "Using console, ask the user for their name" => const name
+
+    CreateUser(name) => const user
+
+    invariant "Throw an error if the user.name is 'sudo' or 'root'"
+    
+    ensure user.name is not empty
+    ensure user.id is not empty
+    ensure user.dateCreated is not undefined
+
     step "Log 'Created user:' and the user object to console"
 }
 `;
@@ -289,7 +305,7 @@ out/
 import { existsSync as existsSync3, mkdirSync as mkdirSync2, writeFileSync as writeFileSync3, readFileSync as readFileSync2, copyFileSync } from "fs";
 import { execSync } from "child_process";
 import { join as join3, resolve as resolve3, dirname, basename } from "path";
-import { AICodeGenerator, FileSystemCAS, computeHash, OllamaProvider } from "@intend-it/core";
+import { AICodeGenerator, FileSystemCAS, computeHash, OllamaProvider, LockfileManager } from "@intend-it/core";
 import { parseToAST } from "@intend-it/parser";
 import { readdirSync as readdirSync2, statSync } from "fs";
 
@@ -307,7 +323,15 @@ var heading = (text2) => pc2.bold(text2);
 var error = (text2) => pc2.red(text2);
 var dim = (text2) => pc2.dim(text2);
 var path = (p2) => dim(p2);
-var duration = (ms) => dim(`${(ms / 1000).toFixed(2)}s`);
+var duration = (ms) => {
+  if (ms < 1000)
+    return dim(`${Math.round(ms)}ms`);
+  if (ms < 60000)
+    return dim(`${(ms / 1000).toFixed(2)}s`);
+  const minutes = Math.floor(ms / 60000);
+  const seconds = (ms % 60000 / 1000).toFixed(0);
+  return dim(`${minutes}m ${seconds}s`);
+};
 var cmd = (name) => pc2.cyan(name);
 var label = (name, value) => `${dim(name + ":")} ${value}`;
 var icons = {
@@ -461,6 +485,23 @@ async function buildCommand(options) {
   const projectContext = new Map;
   const fileData = new Map;
   let parseErrors = 0;
+  let entryPointFile = null;
+  let entryPointName = null;
+  for (const [file, ast] of projectContext.entries()) {
+    for (const intent of ast.intents) {
+      if (intent.entryPoint) {
+        if (entryPointFile) {
+          p2.log.error(`Multiple entry points found:
+1. ${pc3.cyan(entryPointName)} in ${pc3.dim(basename(entryPointFile))}
+2. ${pc3.cyan(intent.name)} in ${pc3.dim(basename(file))}`);
+          p2.cancel("Only one 'entry' intent is allowed per project.");
+          process.exit(1);
+        }
+        entryPointFile = file;
+        entryPointName = intent.name;
+      }
+    }
+  }
   for (const file of files) {
     try {
       const content = readFileSync2(file, "utf-8");
@@ -537,9 +578,13 @@ ${pc3.red(err.message)}`);
   }
   const casDir = resolve3(process.cwd(), ".intend", "store");
   const cas = new FileSystemCAS(casDir);
+  const lockfilePath = resolve3(process.cwd(), "intend.lock");
+  const lockfile = new LockfileManager(lockfilePath);
+  let lockfileUpdated = false;
   let successCount = 0;
   let failCount = parseErrors;
   let cachedCount = 0;
+  let lockedCount = 0;
   const generatedFiles = [];
   if (!existsSync3(outDir)) {
     mkdirSync2(outDir, { recursive: true });
@@ -562,19 +607,39 @@ ${pc3.red(err.message)}`);
     sFile.start(`${pc3.dim(relativePath)}`);
     const fileStart = Date.now();
     try {
-      const { hash, ast } = fileData.get(file);
-      const cached = await cas.get(hash);
+      const { content: sourceContent, hash, ast } = fileData.get(file);
+      const configHash = computeHash("", config);
+      const sourceOnlyHash = computeHash(sourceContent, {});
+      const lockedCode = lockfile.getEntry(relativePath, sourceOnlyHash, configHash);
       let finalCode;
-      if (!options.force && cached) {
-        sFile.stop(`${pc3.dim(relativePath)} ${pc3.blue("(cached)")}`);
-        finalCode = cached.code;
+      if (!options.force && lockedCode) {
+        sFile.stop(`${pc3.dim(relativePath)} ${pc3.green("(locked)")}`);
+        finalCode = lockedCode;
+        lockedCount++;
         cachedCount++;
       } else {
-        const generated = await generator.generate(ast, file);
-        finalCode = generated.code;
-        await cas.put(hash, finalCode);
-        const fileDuration = Date.now() - fileStart;
-        sFile.stop(`${relativePath} ${pc3.dim(`${fileDuration}ms`)}`);
+        const cached = await cas.get(hash);
+        if (!options.force && cached) {
+          sFile.stop(`${pc3.dim(relativePath)} ${pc3.blue("(cached)")}`);
+          finalCode = cached.code;
+          cachedCount++;
+          lockfile.setEntry(relativePath, sourceOnlyHash, configHash, finalCode, {
+            model: modelName,
+            provider: providerName
+          });
+          lockfileUpdated = true;
+        } else {
+          const generated = await generator.generate(ast, file);
+          finalCode = generated.code;
+          await cas.put(hash, finalCode);
+          lockfile.setEntry(relativePath, sourceOnlyHash, configHash, finalCode, {
+            model: modelName,
+            provider: providerName
+          });
+          lockfileUpdated = true;
+          const fileDuration = Date.now() - fileStart;
+          sFile.stop(`${relativePath} ${duration(fileDuration)}`);
+        }
       }
       writeFileSync3(outFile, finalCode, "utf-8");
       generatedFiles.push(outFile);
@@ -584,9 +649,12 @@ ${pc3.red(err.message)}`);
       failCount++;
     }
   }
+  if (lockfileUpdated) {
+    lockfile.save();
+  }
   const totalDuration = Date.now() - startTime;
   if (!isWatch) {
-    p2.note(`${pc3.green(icons.success)} ${pc3.bold(successCount)} compiled ${cachedCount > 0 ? pc3.dim(`(${cachedCount} cached)`) : ""}
+    p2.note(`${pc3.green(icons.success)} ${pc3.bold(successCount)} compiled ${cachedCount > 0 ? pc3.dim(`(${lockedCount} locked, ${cachedCount - lockedCount} cached)`) : ""}
 ` + (failCount > 0 ? `${pc3.red(icons.error)} ${pc3.bold(failCount)} failed
 ` : "") + `${pc3.white(icons.arrow)} ${pc3.white(duration(totalDuration))}`, "Summary");
     const entryFiles = files.filter((f) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intend-it/cli",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "CLI for the Intend programming language",
   "type": "module",
   "bin": {
@@ -30,8 +30,8 @@
   "license": "MIT",
   "dependencies": {
     "@clack/prompts": "^0.11.0",
-    "@intend-it/core": "^4.0.1",
-    "@intend-it/parser": "^1.3.1",
+    "@intend-it/core": "^4.0.3",
+    "@intend-it/parser": "^1.3.3",
     "ora": "^8.1.1",
     "picocolors": "^1.1.1"
   },