@_davideast/jules-env 0.0.2 → 0.1.1

package/README.md

@@ -10,7 +10,7 @@ That's it. The runtime is installed, environment variables are set, and your she
 
 ```
 ✔ brew install dart-sdk
-Wrote .jules/shellenv
+Wrote ~/.jules/shellenv
   export PATH="/opt/homebrew/opt/dart-sdk/bin:$PATH"
   export DART_SDK="/opt/homebrew/opt/dart-sdk/libexec"
 ```
@@ -21,11 +21,15 @@ Wrote .jules/shellenv
 
 1. **Recipe** — A recipe describes how to install a runtime. It probes the system (e.g., `brew --prefix dart-sdk`) but never modifies it.
 2. **Plan** — The recipe produces an execution plan: shell commands to run, environment variables to set, and paths to prepend.
-3. **Execute** — The plan runs. Install steps that are already satisfied (checked via an optional `checkCmd`) are skipped. State is persisted to `.jules/shellenv`.
+3. **Execute** — The plan runs. Install steps that are already satisfied (checked via an optional `checkCmd`) are skipped. State is persisted to `~/.jules/shellenv`.
+
+### Data recipes
+
+Recipes can also be defined as JSON files. A data recipe is a static execution plan — no system probing, no dynamic resolution. This makes them easy to generate programmatically (e.g., by an LLM). Data recipes are validated against a Zod schema at load time. See `src/recipes/ollama.json` for an example.
 
 ## Shell environment
 
-After execution, `.jules/shellenv` contains the environment your runtime needs:
+After execution, `~/.jules/shellenv` contains the environment your runtime needs:
 
 ```bash
 export PATH="/opt/homebrew/opt/dart-sdk/bin:$PATH"
@@ -35,7 +39,7 @@ export DART_SDK="/opt/homebrew/opt/dart-sdk/libexec"
 Source it to activate:
 
 ```bash
-source .jules/shellenv
+source ~/.jules/shellenv
 ```
 
 The file is appended to on subsequent runs, so multiple runtimes compose cleanly.
@@ -69,9 +73,10 @@ jules-env use dart --dry-run
 
 ## Available recipes
 
-| Runtime | Recipe | Install method | Description |
-|---------|--------|---------------|-------------|
-| Dart | `dart` | Homebrew | Installs the Dart SDK via `brew install dart-sdk` |
+| Runtime | Recipe | Type | Description |
+|---------|--------|------|-------------|
+| Dart | `dart` | Code | Installs the Dart SDK (Homebrew on macOS, apt on Linux) |
+| Ollama | `ollama` | Data | Installs Ollama with EmbeddingGemma model |
 
 ## Installation
 
@@ -95,7 +100,7 @@ bun run build
 ### Prerequisites
 
 - [Bun](https://bun.sh/)
-- [Homebrew](https://brew.sh/) (required for the Dart recipe)
+- [Homebrew](https://brew.sh/) (macOS only, used by Dart recipe)
 
 ### Run tests
 

package/dist/cli.mjs

@@ -6011,11 +6011,24 @@ var ExecutionPlanSchema = z.object({
     content: z.string()
   })).default([])
 });
+var DataRecipeSchema = z.object({
+  name: z.string(),
+  description: z.string(),
+  defaultPreset: z.string().optional(),
+  installSteps: z.array(ShellStepSchema),
+  env: z.record(z.string()).default({}),
+  paths: z.array(z.string()).default([]),
+  files: z.array(z.object({
+    path: z.string(),
+    content: z.string()
+  })).default([])
+});
 
 // src/core/executor.ts
 import { spawn } from "node:child_process";
 import { mkdir, writeFile, appendFile } from "node:fs/promises";
 import { resolve, dirname } from "node:path";
+import { homedir } from "node:os";
 async function executePlan(plan, dryRun) {
   if (dryRun) {
     console.log("--- DRY RUN: Execution Plan ---");
@@ -6031,8 +6044,7 @@ async function executePlan(plan, dryRun) {
       console.log(`[${step.id}] ${step.label}...`);
       let skip = false;
       if (step.checkCmd) {
-        const checkParts = step.checkCmd.split(" ");
-        const check = spawn(checkParts[0], checkParts.slice(1), {
+        const check = spawn("sh", ["-c", step.checkCmd], {
           stdio: "ignore"
         });
         const exitCode = await new Promise((res) => check.on("close", (code) => res(code ?? 1)));
@@ -6042,8 +6054,7 @@ async function executePlan(plan, dryRun) {
         }
       }
       if (!skip) {
-        const cmdParts = step.cmd.split(" ");
-        const proc = spawn(cmdParts[0], cmdParts.slice(1), {
+        const proc = spawn("sh", ["-c", step.cmd], {
           stdio: "inherit"
         });
         const exitCode = await new Promise((res) => proc.on("close", (code) => res(code ?? 1)));
@@ -6054,16 +6065,18 @@ async function executePlan(plan, dryRun) {
       }
     }
   }
-  for (const file of plan.files) {
-    if (dryRun) {
+  if (dryRun) {
+    for (const file of plan.files) {
       console.log(`[File] Write to ${file.path}:`);
       console.log(file.content);
-    } else {
+    }
+  } else {
+    await Promise.all(plan.files.map(async (file) => {
       await mkdir(dirname(file.path), { recursive: true });
       await writeFile(file.path, file.content);
-    }
+    }));
   }
-  const julesDir = resolve(process.cwd(), ".jules");
+  const julesDir = resolve(homedir(), ".jules");
   const stateFile = resolve(julesDir, "shellenv");
   let stateContent = "";
   if (plan.paths.length > 0) {
@@ -6075,56 +6088,174 @@ async function executePlan(plan, dryRun) {
 `;
   }
   if (dryRun) {
-    console.log(`[State] Append to .jules/shellenv:`);
+    console.log(`[State] Append to ~/.jules/shellenv:`);
     console.log(stateContent);
   } else {
     if (stateContent) {
       await mkdir(julesDir, { recursive: true });
       await appendFile(stateFile, stateContent);
-      console.log(`Updated .jules/shellenv`);
+      console.log(`Updated ~/.jules/shellenv`);
     }
   }
 }
 
 // src/recipes/dart.ts
 import { spawnSync } from "node:child_process";
+async function resolveDarwin() {
+  const installSteps = [{
+    id: "install-dart",
+    label: "Install Dart SDK",
+    cmd: "brew install dart-sdk",
+    checkCmd: "brew list --versions dart-sdk"
+  }];
+  let dartPrefix = "";
+  try {
+    const result = spawnSync("brew", ["--prefix", "dart-sdk"], { encoding: "utf-8" });
+    if (result.status === 0) {
+      dartPrefix = result.stdout.trim();
+    }
+  } catch (e) {}
+  if (!dartPrefix) {
+    dartPrefix = "/usr/local/opt/dart-sdk";
+  }
+  const env = {
+    DART_SDK: `${dartPrefix}/libexec`
+  };
+  const paths = [
+    `${dartPrefix}/bin`
+  ];
+  return ExecutionPlanSchema.parse({ installSteps, env, paths });
+}
+async function resolveLinux() {
+  const installSteps = [
+    {
+      id: "install-dart-prereqs",
+      label: "Install prerequisites",
+      cmd: "sudo apt-get update && sudo apt-get install -y apt-transport-https wget",
+      checkCmd: "dpkg -s apt-transport-https && dpkg -s wget"
+    },
+    {
+      id: "add-dart-signing-key",
+      label: "Add Dart signing key",
+      cmd: "wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/dart.gpg",
+      checkCmd: "test -f /usr/share/keyrings/dart.gpg"
+    },
+    {
+      id: "add-dart-repo",
+      label: "Add Dart repository",
+      cmd: "echo 'deb [signed-by=/usr/share/keyrings/dart.gpg arch=amd64] https://storage.googleapis.com/dart-archive/channels/stable/release/latest/linux/debian stable main' | sudo tee /etc/apt/sources.list.d/dart_stable.list > /dev/null",
+      checkCmd: "test -f /etc/apt/sources.list.d/dart_stable.list"
+    },
+    {
+      id: "install-dart",
+      label: "Install Dart SDK",
+      cmd: "sudo apt-get update && sudo apt-get install -y dart",
+      checkCmd: "dpkg -s dart"
+    }
+  ];
+  const env = {
+    DART_SDK: "/usr/lib/dart"
+  };
+  const paths = [
+    "/usr/lib/dart/bin"
+  ];
+  return ExecutionPlanSchema.parse({ installSteps, env, paths });
+}
 var DartRecipe = {
   name: "dart",
-  description: "Dart SDK via Homebrew",
+  description: "Dart SDK",
   resolve: async (ctx) => {
-    const installSteps = [{
-      id: "install-dart",
-      label: "Install Dart SDK",
-      cmd: "brew install dart-sdk",
-      checkCmd: "brew list --versions dart-sdk"
-    }];
-    let dartPrefix = "";
-    try {
-      const result = spawnSync("brew", ["--prefix", "dart-sdk"], { encoding: "utf-8" });
-      if (result.status === 0) {
-        dartPrefix = result.stdout.trim();
-      }
-    } catch (e) {}
-    if (!dartPrefix) {
-      dartPrefix = "/usr/local/opt/dart-sdk";
-    }
-    const env = {
-      DART_SDK: `${dartPrefix}/libexec`
-    };
-    const paths = [
-      `${dartPrefix}/bin`
-    ];
-    return ExecutionPlanSchema.parse({
-      installSteps,
-      env,
-      paths
-    });
+    switch (process.platform) {
+      case "darwin":
+        return resolveDarwin();
+      case "linux":
+        return resolveLinux();
+      default:
+        throw new Error(`Unsupported platform: ${process.platform}`);
+    }
   }
 };
+
+// src/core/loader.ts
+function substituteVars(str, vars) {
+  return str.replace(/\{\{(\w+)\}\}/g, (_, key) => {
+    const val = vars[key];
+    if (val === undefined) {
+      throw new Error(`Missing required variable: {{${key}}}. Pass --preset to provide a value.`);
+    }
+    return val;
+  });
+}
+function loadDataRecipe(data) {
+  const parsed = DataRecipeSchema.parse(data);
+  return {
+    name: parsed.name,
+    description: parsed.description,
+    resolve: async (ctx) => {
+      const vars = {};
+      const preset = ctx.preset ?? parsed.defaultPreset;
+      if (preset) {
+        vars["preset"] = preset;
+      }
+      const installSteps = parsed.installSteps.map((step) => ({
+        id: substituteVars(step.id, vars),
+        label: substituteVars(step.label, vars),
+        cmd: substituteVars(step.cmd, vars),
+        ...step.checkCmd ? { checkCmd: substituteVars(step.checkCmd, vars) } : {}
+      }));
+      return {
+        installSteps,
+        env: parsed.env,
+        paths: parsed.paths,
+        files: parsed.files
+      };
+    }
+  };
+}
+// src/recipes/ollama.json
+var ollama_default = {
+  name: "ollama",
+  description: "Ollama with configurable model",
+  installSteps: [
+    {
+      id: "install-zstd",
+      label: "Install zstd",
+      cmd: "sudo apt-get update && sudo apt-get install -y zstd",
+      checkCmd: "dpkg -s zstd"
+    },
+    {
+      id: "install-ollama",
+      label: "Install Ollama",
+      cmd: "curl -fsSL https://ollama.com/install.sh | sh",
+      checkCmd: "which ollama"
+    },
+    {
+      id: "enable-ollama",
+      label: "Enable Ollama service",
+      cmd: "sudo systemctl daemon-reload && sudo systemctl enable --now ollama",
+      checkCmd: "systemctl is-active ollama"
+    },
+    {
+      id: "wait-for-ollama",
+      label: "Wait for Ollama to initialize",
+      cmd: "sleep 5"
+    },
+    {
+      id: "pull-model",
+      label: "Pull {{preset}} model",
+      cmd: "ollama pull {{preset}}",
+      checkCmd: "ollama list | grep {{preset}}"
+    }
+  ],
+  env: {
+    OLLAMA_HOST: "http://localhost:11434"
+  },
+  paths: []
+};
 // package.json
 var package_default = {
   name: "@_davideast/jules-env",
-  version: "0.0.2",
+  version: "0.1.1",
   description: "Configure ephemeral development environments",
   license: "Apache-2.0",
   type: "module",
@@ -6164,7 +6295,8 @@ var package_default = {
 // src/cli.ts
 var program2 = new Command;
 var recipes = {
-  dart: DartRecipe
+  dart: DartRecipe,
+  ollama: loadDataRecipe(ollama_default)
 };
 program2.name("jules-env").description("Configure ephemeral development environments").version(package_default.version);
 program2.command("use <runtime>").description("Setup a runtime environment").option("--version <v>", "Version to install", "latest").option("--dry-run", "Simulate execution", false).option("--preset <p>", "Configuration preset").action(async (runtime, options) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@_davideast/jules-env",
-  "version": "0.0.2",
+  "version": "0.1.1",
   "description": "Configure ephemeral development environments",
   "license": "Apache-2.0",
   "type": "module",