uda-cli 0.2.0 → 0.2.1

package/README.md

@@ -1,66 +1,96 @@
 # UDA (Universal Dev AI)
 
-AI-agnostic context engineering + RAG CLI tool for game development.
+AI-agnostic context engineering + RAG CLI tool for game development. Local, file-based, zero cloud dependency.
 
 ## Features
 
-- **Local RAG**: LanceDB + MiniLM embeddings - no API keys needed
+- **Local RAG**: LanceDB + MiniLM embeddings — no API keys needed
 - **Multi-AI Support**: Claude, Cursor, Windsurf, AGENTS.md, Raw export
 - **Plugin System**: Git-based engine plugins (Unity, Godot, Unreal, etc.)
+- **Guided Setup**: Interactive plugin installation during `uda init`
 - **Workflow Engine**: YAML-defined AI-assisted workflows
-- **Project Context**: Automatic knowledge base management
+- **AI-Native Integration**: Generates CLAUDE.md, skills, and agent files automatically
 
 ## Installation
 
 ```bash
-npm install -g uda
+npm install -g uda-cli
+```
+
+Or run directly:
+
+```bash
+npx uda-cli init
 ```
 
 ## Quick Start
 
 ```bash
-# Initialize UDA in your project
+# Initialize UDA in your game project (auto-detects engine)
 uda init
 
-# Scan and index knowledge
-uda scan
+# The init wizard will:
+# 1. Create .uda/ directory
+# 2. Detect your engine (Unity/Godot/Unreal)
+# 3. Prompt to install the official plugin
+# 4. Scan and index knowledge
+# 5. Generate AI tool files (CLAUDE.md, .cursorrules, etc.)
+```
 
-# Search knowledge base
-uda search "MonoBehaviour lifecycle"
+### Init Options
 
-# Export to your AI tool
-uda export --format claude
+```bash
+uda init                      # Interactive (auto-detect engine)
+uda init --engine unity       # Specify engine explicitly
+uda init --skip-plugin        # Skip plugin prompt (CI/automation)
 ```
 
 ## Commands
 
-- `uda init` - Initialize UDA in current project
-- `uda sync` - Generate AI tool files from knowledge base
-- `uda search <query>` - Search knowledge base
-- `uda learn <source>` - Teach knowledge to RAG
-- `uda scan` - Scan project and index into RAG
-- `uda plugin <action>` - Manage engine plugins
-- `uda export --format <type>` - Export knowledge to specific format
-- `uda status` - Show UDA system status
-- `uda config [key] [value]` - Manage UDA settings
-
-## Supported Formats
-
-- **claude**: Generates CLAUDE.md and .claude/ skills
-- **cursor**: Generates .cursorrules
-- **agents-md**: Generates AGENTS.md
-- **raw**: Generates full-context.md
+| Command | Description |
+|---------|-------------|
+| `uda init` | Initialize UDA in current project |
+| `uda sync` | Generate AI tool files from knowledge base |
+| `uda scan` | Scan project and index into RAG |
+| `uda search <query>` | Search knowledge base |
+| `uda learn <source>` | Teach knowledge to RAG |
+| `uda logs` | View Unity console logs |
+| `uda plugin add <repo>` | Install an engine plugin |
+| `uda plugin update <name>` | Update an installed plugin |
+| `uda plugin update-all` | Update all plugins |
+| `uda export --format <type>` | Export knowledge to specific format |
+| `uda status` | Show UDA system status |
+| `uda config [key] [value]` | Manage UDA settings |
+
+## Supported AI Tools
+
+| Format | Generated Files |
+|--------|----------------|
+| **claude** | `CLAUDE.md`, `.claude/skills/`, `.claude/agents/` |
+| **cursor** | `.cursorrules` |
+| **windsurf** | `.windsurfrules` |
+| **agents-md** | `AGENTS.md` |
+| **raw** | `full-context.md` |
 
 ## Plugin System
 
-Install engine-specific knowledge:
+Plugins provide engine-specific knowledge, workflows, and agents. During `uda init`, you'll be prompted to install the default plugin for your detected engine.
 
 ```bash
-uda plugin add https://github.com/user/uda-plugin-unity.git
+# Manual plugin management
+uda plugin add https://github.com/Orhonbey/uda-unity-plugin.git
 uda plugin update unity
 uda plugin update-all
 ```
 
+### Available Plugins
+
+| Engine | Plugin |
+|--------|--------|
+| Unity | [uda-unity-plugin](https://github.com/Orhonbey/uda-unity-plugin) |
+| Godot | Coming soon |
+| Unreal | Coming soon |
+
 ## Project Structure
 
 ```
@@ -70,8 +100,9 @@ uda plugin update-all
 │   ├── engine/          # Engine plugins (Unity, Godot, etc.)
 │   ├── project/         # Project-specific knowledge
 │   └── community/       # Community contributions
-├── workflows/           # AI-assisted workflows
+├── workflows/           # AI-assisted workflows (YAML)
 ├── agents/              # Specialized AI agents
+├── logs/                # Engine logs (console.jsonl)
 ├── state/
 │   ├── current.md       # Active work state
 │   ├── features/        # Feature specifications

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uda-cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Universal Dev AI — AI-agnostic context engineering + RAG for game development",
   "type": "module",
   "main": "./src/cli.js",
@@ -18,7 +18,9 @@
   "scripts": {
     "test": "node --test src/**/*.test.js",
     "test:coverage": "node --test --experimental-test-coverage src/**/*.test.js",
-    "dev": "node bin/uda.js"
+    "dev": "node bin/uda.js",
+    "preversion": "npm test",
+    "postversion": "git push origin main --follow-tags"
   },
   "keywords": [
     "ai",
@@ -32,6 +34,10 @@
     "vector-database",
     "embeddings"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Orhonbey/uda"
+  },
   "author": "UDA Contributors",
   "license": "MIT",
   "engines": {

package/src/cli.js

@@ -18,6 +18,7 @@ export function createCli() {
     .command('init')
     .description('Initialize UDA in current project')
     .option('-e, --engine <name>', 'Engine plugin to install (e.g. unity)')
+    .option('--skip-plugin', 'Skip plugin installation prompt')
     .action(handleInit);
 
   program

package/src/commands/init.js

@@ -1,7 +1,16 @@
+import { createInterface } from 'readline';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
 import { initProject } from '../core/init.js';
 import { handleScan } from './scan.js';
 import { handleSync } from './sync.js';
+import { handlePluginAdd } from './plugin.js';
 import { validateEngine } from '../core/validators.js';
+import { DEFAULT_PLUGINS } from '../core/constants.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '../../package.json'), 'utf8'));
 
 export async function handleInit(options) {
   const root = process.cwd();
@@ -16,7 +25,7 @@ export async function handleInit(options) {
     }
   }
 
-  console.log('UDA v0.2.0\n');
+  console.log(`UDA v${pkg.version}\n`);
 
   // Step 1: Create directory structure
   console.log('Creating project structure...');
@@ -29,11 +38,17 @@ export async function handleInit(options) {
   }
   console.log('✔ .uda/ directory created\n');
 
-  // Step 2: Engine detection
+  // Step 2: Engine detection + plugin install prompt
   const engine = options.engine || await detectEngine(root);
   if (engine) {
     console.log(`✔ Engine detected: ${engine}`);
-    console.log(`  Run \`uda plugin add <repo>\` to install ${engine} plugin\n`);
+    const defaultUrl = DEFAULT_PLUGINS[engine];
+    if (defaultUrl && !options.skipPlugin) {
+      await promptPluginInstall(engine, defaultUrl);
+    } else if (!defaultUrl) {
+      console.log(`  No default plugin available for ${engine}.`);
+      console.log(`  Run \`uda plugin add <repo>\` to install a ${engine} plugin\n`);
+    }
   }
 
   // Step 3: Initial scan
@@ -50,6 +65,48 @@ export async function handleInit(options) {
   console.log('  uda plugin add <git-repo>');
 }
 
+async function promptPluginInstall(engine, defaultUrl) {
+  const answer = await ask(
+    `\n  Install official ${engine} plugin?\n` +
+    `    [Y] Yes, install default (${defaultUrl})\n` +
+    `    [C] Custom — enter your own plugin URL\n` +
+    `    [N] No, skip\n` +
+    `  Choice (Y/c/n): `
+  );
+
+  const choice = answer.trim().toLowerCase();
+
+  if (choice === 'n') {
+    console.log('  Skipped plugin installation.\n');
+    return;
+  }
+
+  let repoUrl = defaultUrl;
+
+  if (choice === 'c') {
+    repoUrl = await ask('  Plugin git URL: ');
+    repoUrl = repoUrl.trim();
+    if (!repoUrl) {
+      console.log('  No URL provided. Skipped plugin installation.\n');
+      return;
+    }
+  }
+
+  console.log(`\n  Installing ${engine} plugin...`);
+  await handlePluginAdd(repoUrl);
+  console.log('');
+}
+
+function ask(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer);
+    });
+  });
+}
+
 async function detectEngine(root) {
   const { existsSync } = await import('fs');
   const { join } = await import('path');

package/src/core/constants.js

@@ -1,6 +1,12 @@
 // src/core/constants.js
 import { join } from 'path';
 
+export const DEFAULT_PLUGINS = {
+  unity: 'https://github.com/Orhonbey/uda-unity-plugin.git',
+  // godot: 'https://github.com/SunalSpaciel/uda-godot-plugin.git',
+  // unreal: 'https://github.com/SunalSpaciel/uda-unreal-plugin.git',
+};
+
 export const UDA_DIR = '.uda';
 
 export function udaPaths(root) {