eitri-cli 1.51.0 → 1.52.0-beta.1

package/CLAUDE.md

@@ -0,0 +1,71 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Setup
+
+Prerequisites: Node.js >= 16, Rust and Cargo installed.
+
+```bash
+# Root dependencies
+npm i
+
+# Build the Rust native module (required before running)
+cd eitri-cli-v2 && npm i && npm run build && cd ..
+```
+
+## Common Commands
+
+```bash
+# Run tests
+npm test                    # or: npm run test-eitri
+
+# Lint with auto-fix
+npm run linter
+
+# Install and run locally
+./install-dev.sh            # Linux/MacOS
+./install-dev.bat           # Windows
+eitri <command>
+```
+
+Jest test timeout is 100 seconds. Run a single test file with:
+```bash
+NODE_APP_INSTANCE=eitri npx jest --detectOpenHandles path/to/test.js
+```
+
+## Architecture
+
+This is a **hybrid Node.js + Rust CLI** (the `eitri` binary) for developing Eitri-Apps on the Eitri mobile platform.
+
+### Entry Flow
+
+1. `index-eitri.js` (bin entry) — sets `NODE_APP_INSTANCE=eitri`, generates a UUID session ID, calls `index.js`
+2. `index.js` — Commander.js v9 CLI parser; loads config from `config/` via `NODE_CONFIG_DIR`; delegates to Rust or JS handlers
+3. **Rust layer**: `eitri-cli-v2/` — NAPI-RS native bindings compiled to platform-specific `.node` files. Most active commands live here.
+4. **JS layer**: `src/modules/` — legacy commands still in JavaScript
+
+### Command Routing
+
+Commands implemented in Rust (`eitri-cli-v2/src/commands/`), called via NAPI bindings:
+- `login`, `create`, `start`, `push-version`, `clean`, `test`, `publish`, `doctor`, `libs`, `gpt`, `self-update`
+
+Commands still in JavaScript (`src/modules/`):
+- `vegvisir` / `workspace` — workspace management (list, use, create, current, clean)
+- `app` — multi-app orchestration (start, logs, clean, create, checkout, snapshot)
+- `agents` — AI agent environment setup (LLM env vars)
+
+Pre-command middleware (in `index.js`) runs connection checks and update checks before most commands, skipping them for `version`, `-v`, and `self-update`.
+
+### Configuration
+
+Environment configs in `config/` use the `node-config` pattern, selected by `NODE_APP_INSTANCE` (always `eitri`) and `NODE_CONFIG_DIR`. Files: `default-eitri.js`, `dev.js`, `prod-eitri.js`, etc.
+
+### Release Workflow
+
+Uses [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) — required for automated versioning via semantic-release.
+
+- Branch from `beta` → PR to `beta` → merging publishes a `beta` NPM prerelease
+- PR from `beta` → `master` → merging publishes a stable NPM release
+
+Allowed commit types: `build`, `chore`, `ci`, `docs`, `feat`, `fix`, `perf`, `refactor`, `revert`, `style`, `test`

package/eitri-cli-v2/index.d.ts

@@ -96,4 +96,5 @@ export declare namespace workspace {
 }
 export declare namespace agents {
   export function setup(args: SetupVariablesArgs): Promise<void>
+  export function generateRag(): Promise<void>
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eitri-cli",
-  "version": "1.51.0",
+  "version": "1.52.0-beta.1",
   "description": "Command Line Interface to make \"Eitri-App\" with code and fire.",
   "main": "index.js",
   "bin": {

package/src/modules/agents/AgentsCommands.js

@@ -2,23 +2,32 @@ const commander = require("commander");
 const eitriCLIV2 = require("../../../eitri-cli-v2/index.js");
 
 module.exports = function AgentsCommand() {
+  const agentsCommand = commander
+    .command("agents")
+    .description("Gerencia os agentes de IA do Eitri-App");
 
-    const agentsCommand = commander
-        .command("agents")
-        .description(
-            "Gerencia os agentes de IA do Eitri-App"
-        );
+  agentsCommand
+    .command("setup")
+    .description(
+      "Faz o setup das variáveis de ambiente, seja do Workspace ou de Produção",
+    )
+    .option(
+      "-e, --env <env>",
+      "Ambiente de produção ou workspace. Default: workspace. Options: workspace, production",
+    )
+    .option("-l, --llm <llm>", "Nome do LLM")
+    .option("-k, --api-key <api-key>", "Chave de API do LLM")
+    .option("-m, --model <model>", "Modelo do LLM")
+    .action(async (cmdObj) => {
+      await eitriCLIV2.agents.setup(cmdObj);
+    });
 
-    agentsCommand
-        .command("setup")
-        .description("Faz o setup das variáveis de ambiente, seja do Workspace ou de Produção")
-        .option("-e, --env <env>", "Ambiente de produção ou workspace. Default: workspace. Options: workspace, production")
-        .option("-l, --llm <llm>", "Nome do LLM")
-        .option("-k, --api-key <api-key>", "Chave de API do LLM")
-        .option("-m, --model <model>", "Modelo do LLM")
-        .action(async (cmdObj) => {
-            await eitriCLIV2.agents.setup(cmdObj)
-        });
+  agentsCommand
+    .command("generate:rag")
+    .description("Gera os arquivos necessários para o RAG")
+    .action(async () => {
+      await eitriCLIV2.agents.generateRag();
+    });
 
-    return agentsCommand
-}
+  return agentsCommand;
+};