uloop-cli 0.44.1

package/src/skills/skill-definitions/uloop-get-provider-details/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: uloop-get-provider-details
+description: Get Unity Search provider details via uloop CLI. Use when you need to: (1) Discover available search providers, (2) Understand search capabilities and filters, (3) Configure searches with specific provider options.
+---
+
+# uloop get-provider-details
+
+Get detailed information about Unity Search providers.
+
+## Usage
+
+```bash
+uloop get-provider-details [options]
+```
+
+## Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `--provider-id` | string | - | Specific provider ID to query |
+| `--active-only` | boolean | `false` | Only show active providers |
+| `--include-descriptions` | boolean | `true` | Include descriptions |
+| `--sort-by-priority` | boolean | `true` | Sort by priority |
+
+## Examples
+
+```bash
+# List all providers
+uloop get-provider-details
+
+# Get specific provider
+uloop get-provider-details --provider-id asset
+
+# Active providers only
+uloop get-provider-details --active-only
+```
+
+## Output
+
+Returns JSON:
+- `Providers`: array of provider info (ID, name, description, priority)
+
+## Notes
+
+Use provider IDs with `uloop unity-search --providers` option.

package/src/skills/skill-definitions/uloop-get-version/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: uloop-get-version
+description: Get uLoopMCP version information via uloop CLI. Use when you need to: (1) Check uLoopMCP package version, (2) Verify installation is working correctly, (3) Troubleshoot version compatibility issues.
+---
+
+# uloop get-version
+
+Get uLoopMCP version information.
+
+## Usage
+
+```bash
+uloop get-version
+```
+
+## Parameters
+
+None.
+
+## Examples
+
+```bash
+# Get version info
+uloop get-version
+```
+
+## Output
+
+Returns JSON with version information:
+- uLoopMCP package version
+- CLI version

package/src/skills/skill-definitions/uloop-run-tests/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: uloop-run-tests
+description: Execute Unity Test Runner via uloop CLI. Use when you need to: (1) Run unit tests (EditMode tests), (2) Run integration tests (PlayMode tests), (3) Verify code changes don't break existing functionality.
+---
+
+# uloop run-tests
+
+Execute Unity Test Runner.
+
+## Usage
+
+```bash
+uloop run-tests [options]
+```
+
+## Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `--test-mode` | string | `EditMode` | Test mode: `EditMode`, `PlayMode` |
+| `--filter-type` | string | `all` | Filter type: `all`, `exact`, `regex`, `assembly` |
+| `--filter-value` | string | - | Filter value (test name, pattern, or assembly) |
+| `--save-xml` | boolean | `false` | Save test results as XML |
+
+## Examples
+
+```bash
+# Run all EditMode tests
+uloop run-tests
+
+# Run PlayMode tests
+uloop run-tests --test-mode PlayMode
+
+# Run specific test
+uloop run-tests --filter-type exact --filter-value "MyTest.TestMethod"
+
+# Run tests matching pattern
+uloop run-tests --filter-type regex --filter-value ".*Integration.*"
+```
+
+## Output
+
+Returns JSON with test results including pass/fail counts and details.

package/src/skills/skill-definitions/uloop-unity-search/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: uloop-unity-search
+description: Search Unity project via uloop CLI. Use when you need to: (1) Find assets by name or type (scenes, prefabs, scripts, materials), (2) Search for project resources using Unity's search system, (3) Locate files within the Unity project.
+---
+
+# uloop unity-search
+
+Search Unity project using Unity Search.
+
+## Usage
+
+```bash
+uloop unity-search [options]
+```
+
+## Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `--search-query` | string | - | Search query |
+| `--providers` | array | - | Search providers (e.g., `asset`, `scene`, `find`) |
+| `--max-results` | integer | `50` | Maximum number of results |
+| `--save-to-file` | boolean | `false` | Save results to file |
+
+## Examples
+
+```bash
+# Search for assets
+uloop unity-search --search-query "Player"
+
+# Search with specific provider
+uloop unity-search --search-query "t:Prefab" --providers asset
+
+# Limit results
+uloop unity-search --search-query "*.cs" --max-results 20
+```
+
+## Output
+
+Returns JSON array of search results with paths and metadata.
+
+## Notes
+
+Use `uloop get-provider-details` to discover available search providers.

package/src/skills/skills-command.ts

@@ -0,0 +1,118 @@
+/**
+ * CLI command definitions for skills management.
+ */
+
+import { Command } from 'commander';
+import {
+  getAllSkillStatuses,
+  installAllSkills,
+  uninstallAllSkills,
+  getInstallDir,
+  getTotalSkillCount,
+} from './skills-manager.js';
+
+export function registerSkillsCommand(program: Command): void {
+  const skillsCmd = program.command('skills').description('Manage uloop skills for Claude Code');
+
+  skillsCmd
+    .command('list')
+    .description('List all uloop skills and their installation status')
+    .option('-g, --global', 'Check global installation (~/.claude/skills/)')
+    .action((options: { global?: boolean }) => {
+      listSkills(options.global ?? false);
+    });
+
+  skillsCmd
+    .command('install')
+    .description('Install all uloop skills')
+    .option('-g, --global', 'Install to global location (~/.claude/skills/)')
+    .action((options: { global?: boolean }) => {
+      installSkills(options.global ?? false);
+    });
+
+  skillsCmd
+    .command('uninstall')
+    .description('Uninstall all uloop skills')
+    .option('-g, --global', 'Uninstall from global location (~/.claude/skills/)')
+    .action((options: { global?: boolean }) => {
+      uninstallSkills(options.global ?? false);
+    });
+}
+
+function listSkills(global: boolean): void {
+  const location = global ? 'Global' : 'Project';
+  const dir = getInstallDir(global);
+
+  console.log(`\nuloop Skills Status (${location}):`);
+  console.log(`Location: ${dir}`);
+  console.log('='.repeat(50));
+  console.log('');
+
+  const statuses = getAllSkillStatuses(global);
+
+  for (const skill of statuses) {
+    const icon = getStatusIcon(skill.status);
+    const statusText = getStatusText(skill.status);
+    console.log(`  ${icon} ${skill.name} (${statusText})`);
+  }
+
+  console.log('');
+  console.log(`Total: ${getTotalSkillCount()} bundled skills`);
+}
+
+function getStatusIcon(status: string): string {
+  switch (status) {
+    case 'installed':
+      return '\x1b[32m✓\x1b[0m';
+    case 'outdated':
+      return '\x1b[33m↑\x1b[0m';
+    case 'not_installed':
+      return '\x1b[31m✗\x1b[0m';
+    default:
+      return '?';
+  }
+}
+
+function getStatusText(status: string): string {
+  switch (status) {
+    case 'installed':
+      return 'installed';
+    case 'outdated':
+      return 'outdated';
+    case 'not_installed':
+      return 'not installed';
+    default:
+      return 'unknown';
+  }
+}
+
+function installSkills(global: boolean): void {
+  const location = global ? 'global' : 'project';
+  const dir = getInstallDir(global);
+
+  console.log(`\nInstalling uloop skills (${location})...`);
+  console.log('');
+
+  const result = installAllSkills(global);
+
+  console.log(`\x1b[32m✓\x1b[0m Installed: ${result.installed}`);
+  console.log(`\x1b[33m↑\x1b[0m Updated: ${result.updated}`);
+  console.log(`\x1b[90m-\x1b[0m Skipped (up-to-date): ${result.skipped}`);
+  console.log('');
+  console.log(`Skills installed to ${dir}`);
+}
+
+function uninstallSkills(global: boolean): void {
+  const location = global ? 'global' : 'project';
+  const dir = getInstallDir(global);
+
+  console.log(`\nUninstalling uloop skills (${location})...`);
+  console.log('');
+
+  const result = uninstallAllSkills(global);
+
+  console.log(`\x1b[31m✗\x1b[0m Removed: ${result.removed}`);
+  console.log(`\x1b[90m-\x1b[0m Not found: ${result.notFound}`);
+  console.log('');
+  console.log(`Skills removed from ${dir}`);
+}

package/src/skills/skills-manager.ts

@@ -0,0 +1,135 @@
+/**
+ * Skills manager for installing/uninstalling/listing uloop skills.
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { BUNDLED_SKILLS, BundledSkill } from './bundled-skills.js';
+
+export type SkillStatus = 'installed' | 'not_installed' | 'outdated';
+
+export interface SkillInfo {
+  name: string;
+  status: SkillStatus;
+  path?: string;
+}
+
+function getGlobalSkillsDir(): string {
+  return join(homedir(), '.claude', 'skills');
+}
+
+function getProjectSkillsDir(): string {
+  return join(process.cwd(), '.claude', 'skills');
+}
+
+function getSkillPath(skillDirName: string, global: boolean): string {
+  const baseDir = global ? getGlobalSkillsDir() : getProjectSkillsDir();
+  return join(baseDir, skillDirName, 'SKILL.md');
+}
+
+function isSkillInstalled(skill: BundledSkill, global: boolean): boolean {
+  const skillPath = getSkillPath(skill.dirName, global);
+  return existsSync(skillPath);
+}
+
+function isSkillOutdated(skill: BundledSkill, global: boolean): boolean {
+  const skillPath = getSkillPath(skill.dirName, global);
+  if (!existsSync(skillPath)) {
+    return false;
+  }
+  const installedContent = readFileSync(skillPath, 'utf-8');
+  return installedContent !== skill.content;
+}
+
+export function getSkillStatus(skill: BundledSkill, global: boolean): SkillStatus {
+  if (!isSkillInstalled(skill, global)) {
+    return 'not_installed';
+  }
+  if (isSkillOutdated(skill, global)) {
+    return 'outdated';
+  }
+  return 'installed';
+}
+
+export function getAllSkillStatuses(global: boolean): SkillInfo[] {
+  return BUNDLED_SKILLS.map((skill) => ({
+    name: skill.name,
+    status: getSkillStatus(skill, global),
+    path: isSkillInstalled(skill, global) ? getSkillPath(skill.dirName, global) : undefined,
+  }));
+}
+
+export function installSkill(skill: BundledSkill, global: boolean): void {
+  const baseDir = global ? getGlobalSkillsDir() : getProjectSkillsDir();
+  const skillDir = join(baseDir, skill.dirName);
+  const skillPath = join(skillDir, 'SKILL.md');
+
+  mkdirSync(skillDir, { recursive: true });
+  writeFileSync(skillPath, skill.content, 'utf-8');
+}
+
+export function uninstallSkill(skill: BundledSkill, global: boolean): boolean {
+  const baseDir = global ? getGlobalSkillsDir() : getProjectSkillsDir();
+  const skillDir = join(baseDir, skill.dirName);
+
+  if (!existsSync(skillDir)) {
+    return false;
+  }
+
+  rmSync(skillDir, { recursive: true, force: true });
+  return true;
+}
+
+export interface InstallResult {
+  installed: number;
+  updated: number;
+  skipped: number;
+}
+
+export function installAllSkills(global: boolean): InstallResult {
+  const result: InstallResult = { installed: 0, updated: 0, skipped: 0 };
+
+  for (const skill of BUNDLED_SKILLS) {
+    const status = getSkillStatus(skill, global);
+
+    if (status === 'not_installed') {
+      installSkill(skill, global);
+      result.installed++;
+    } else if (status === 'outdated') {
+      installSkill(skill, global);
+      result.updated++;
+    } else {
+      result.skipped++;
+    }
+  }
+
+  return result;
+}
+
+export interface UninstallResult {
+  removed: number;
+  notFound: number;
+}
+
+export function uninstallAllSkills(global: boolean): UninstallResult {
+  const result: UninstallResult = { removed: 0, notFound: 0 };
+
+  for (const skill of BUNDLED_SKILLS) {
+    if (uninstallSkill(skill, global)) {
+      result.removed++;
+    } else {
+      result.notFound++;
+    }
+  }
+
+  return result;
+}
+
+export function getInstallDir(global: boolean): string {
+  return global ? getGlobalSkillsDir() : getProjectSkillsDir();
+}
+
+export function getTotalSkillCount(): number {
+  return BUNDLED_SKILLS.length;
+}

package/src/tool-cache.ts

@@ -0,0 +1,104 @@
+/**
+ * Tool cache management for CLI.
+ * Handles loading/saving tool definitions from .uloop/tools.json cache.
+ */
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import defaultToolsData from './default-tools.json';
+import { findUnityProjectRoot } from './project-root.js';
+
+export interface ToolProperty {
+  type: string;
+  description?: string;
+  default?: unknown;
+  enum?: string[];
+  items?: { type: string };
+}
+
+export interface ToolInputSchema {
+  type: string;
+  properties: Record<string, ToolProperty>;
+  required?: string[];
+}
+
+export interface ToolDefinition {
+  name: string;
+  description: string;
+  inputSchema: ToolInputSchema;
+}
+
+export interface ToolsCache {
+  version: string;
+  updatedAt?: string;
+  tools: ToolDefinition[];
+}
+
+const CACHE_DIR = '.uloop';
+const CACHE_FILE = 'tools.json';
+
+function getCacheDir(): string {
+  const projectRoot = findUnityProjectRoot();
+  if (projectRoot === null) {
+    return join(process.cwd(), CACHE_DIR);
+  }
+  return join(projectRoot, CACHE_DIR);
+}
+
+function getCachePath(): string {
+  return join(getCacheDir(), CACHE_FILE);
+}
+
+/**
+ * Load default tools bundled with npm package.
+ */
+export function getDefaultTools(): ToolsCache {
+  return defaultToolsData as ToolsCache;
+}
+
+/**
+ * Load tools from cache file, falling back to default tools if cache doesn't exist.
+ */
+export function loadToolsCache(): ToolsCache {
+  const cachePath = getCachePath();
+
+  if (existsSync(cachePath)) {
+    try {
+      const content = readFileSync(cachePath, 'utf-8');
+      return JSON.parse(content) as ToolsCache;
+    } catch {
+      return getDefaultTools();
+    }
+  }
+
+  return getDefaultTools();
+}
+
+/**
+ * Save tools to cache file.
+ */
+export function saveToolsCache(cache: ToolsCache): void {
+  const cacheDir = getCacheDir();
+  const cachePath = getCachePath();
+
+  if (!existsSync(cacheDir)) {
+    mkdirSync(cacheDir, { recursive: true });
+  }
+
+  const content = JSON.stringify(cache, null, 2);
+  writeFileSync(cachePath, content, 'utf-8');
+}
+
+/**
+ * Check if cache file exists.
+ */
+export function hasCacheFile(): boolean {
+  return existsSync(getCachePath());
+}
+
+/**
+ * Get the cache file path for display purposes.
+ */
+export function getCacheFilePath(): string {
+  return getCachePath();
+}

package/src/version.ts

@@ -0,0 +1,7 @@
+/**
+ * CLI version
+ *
+ * This file exists to avoid bundling the entire package.json into the CLI bundle.
+ * This version is automatically updated by release-please.
+ */
+export const VERSION = '0.44.1'; // x-release-please-version

package/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "allowSyntheticDefaultImports": true,
+    "types": ["node", "jest"]
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}