uda-cli 0.2.0 → 0.4.0

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 | Status |
+|--------|----------------|--------|
+| **claude** | `CLAUDE.md`, `.claude/skills/`, `.claude/agents/` | Available |
+| **cursor** | `.cursorrules` | Coming soon |
+| **windsurf** | `.windsurfrules` | Coming soon |
+| **agents-md** | `AGENTS.md` | Coming soon |
+| **raw** | `full-context.md` | Coming soon |
 
 ## 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.4.0",
   "description": "Universal Dev AI — AI-agnostic context engineering + RAG for game development",
   "type": "module",
   "main": "./src/cli.js",
@@ -16,9 +16,11 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "node --test src/**/*.test.js",
+    "test": "node --test --test-concurrency=1 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

@@ -10,6 +10,7 @@ import { handleConfig } from './commands/config.js';
 import { handlePluginUpdate } from './commands/plugin.js';
 import { handleExport } from './commands/export.js';
 import { handleLogs } from './commands/logs.js';
+import { handleClean } from './commands/clean.js';
 
 export function createCli() {
   const program = new Command();
@@ -18,6 +19,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
@@ -102,5 +104,11 @@ export function createCli() {
     .option('-l, --last <count>', 'Show last N entries')
     .action(handleLogs);
 
+  program
+    .command('clean')
+    .description('Remove UDA from current project')
+    .option('-f, --force', 'Skip confirmation prompt')
+    .action(handleClean);
+
   return program;
 }

package/src/commands/clean.js

@@ -0,0 +1,134 @@
+// src/commands/clean.js — Remove UDA from current project
+import { access, readdir, rm, unlink } from 'fs/promises'
+import { createInterface } from 'readline'
+import { join } from 'path'
+
+const CLEAN_TARGETS = {
+  dirs: ['.uda', '.claude/commands/uda'],
+  files: ['CLAUDE.md', '.cursorrules', 'AGENTS.md'],
+  agentGlob: '.claude/agents',
+  agentPrefix: 'uda-',
+}
+
+async function exists(p) {
+  try {
+    await access(p)
+    return true
+  } catch {
+    return false
+  }
+}
+
+function ask(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout })
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close()
+      resolve(answer)
+    })
+  })
+}
+
+export async function handleClean(options = {}) {
+  const targets = {
+    dirs: [],
+    files: [],
+  }
+
+  // Check if .uda exists
+  const hasUda = await exists('.uda')
+  if (!hasUda) {
+    console.error('Hata: Bu dizinde UDA kurulu degil.')
+    process.exitCode = 1
+    return
+  }
+
+  // Collect directories
+  for (const dir of CLEAN_TARGETS.dirs) {
+    if (await exists(dir)) {
+      targets.dirs.push(dir)
+    }
+  }
+
+  // Collect files
+  for (const file of CLEAN_TARGETS.files) {
+    if (await exists(file)) {
+      targets.files.push(file)
+    }
+  }
+
+  // Collect agent files (only uda-*.md)
+  if (await exists(CLEAN_TARGETS.agentGlob)) {
+    try {
+      const agentFiles = await readdir(CLEAN_TARGETS.agentGlob)
+      for (const f of agentFiles) {
+        if (f.startsWith(CLEAN_TARGETS.agentPrefix) && f.endsWith('.md')) {
+          targets.files.push(join(CLEAN_TARGETS.agentGlob, f))
+        }
+      }
+    } catch {
+      // Ignore errors reading agents dir
+    }
+  }
+
+  // Show what will be deleted
+  console.log('UDA Clean — Silinecek dosyalar:')
+  console.log()
+
+  if (targets.dirs.length > 0) {
+    console.log('  Dizinler:')
+    for (const d of targets.dirs) {
+      console.log(`    ${d}/`)
+    }
+    console.log()
+  }
+
+  if (targets.files.length > 0) {
+    console.log('  Dosyalar:')
+    for (const f of targets.files) {
+      console.log(`    ${f}`)
+    }
+    console.log()
+  }
+
+  if (targets.dirs.length === 0 && targets.files.length === 0) {
+    console.log('  Silinecek dosya bulunamadi.')
+    return
+  }
+
+  // Ask for confirmation unless --force
+  if (!options.force) {
+    const answer = await ask('Bu islem geri alinamaz. Devam? (y/N): ')
+    if (answer.toLowerCase() !== 'y') {
+      console.log('Islem iptal edildi.')
+      return
+    }
+    console.log()
+  }
+
+  // Delete files first
+  let deletedFiles = 0
+  for (const f of targets.files) {
+    try {
+      await unlink(f)
+      deletedFiles++
+    } catch {
+      // Ignore errors
+    }
+  }
+
+  // Delete directories (in reverse order, nested first)
+  let deletedDirs = 0
+  const sortedDirs = [...targets.dirs].sort((a, b) => b.length - a.length)
+  for (const d of sortedDirs) {
+    try {
+      await rm(d, { recursive: true, force: true })
+      deletedDirs++
+    } catch {
+      // Ignore errors
+    }
+  }
+
+  console.log(`${deletedDirs} dizin, ${deletedFiles} dosya silindi.`)
+  console.log('UDA projeden kaldirildi.')
+}

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) {