smithue-cli 0.8.0

package/dist/commands/list.d.ts

@@ -0,0 +1,8 @@
+export interface ListOpts {
+    pid?: number;
+    project?: string;
+    port?: number;
+    cliVersion?: string;
+}
+export declare function listCommand(domain: string | undefined, opts: ListOpts): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAW3F"}

package/dist/commands/list.js

@@ -0,0 +1,18 @@
+import { discoverPort } from '../portfile.js';
+import { SmithUEClient } from '../client.js';
+import { printResult, printError } from '../output.js';
+import { checkVersionCompat } from '../version-check.js';
+export async function listCommand(domain, opts) {
+    try {
+        const discovered = await discoverPort(opts);
+        if (opts.cliVersion)
+            checkVersionCompat(opts.cliVersion, discovered.plugin_version);
+        const { port } = discovered;
+        const client = new SmithUEClient({ host: '127.0.0.1', port });
+        const result = await client.listTools(domain);
+        printResult(result);
+    }
+    catch (err) {
+        printError(err);
+    }
+}

package/dist/commands/purge.d.ts

@@ -0,0 +1,3 @@
+import type { PurgeOptions } from '../types.js';
+export declare function purge(opts: PurgeOptions): Promise<void>;
+//# sourceMappingURL=purge.d.ts.map

package/dist/commands/purge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purge.d.ts","sourceRoot":"","sources":["../../src/commands/purge.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AAE7D,wBAAsB,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgK7D"}

package/dist/commands/purge.js

@@ -0,0 +1,154 @@
+import { readdir, readFile, lstat, unlink, rmdir } from 'fs/promises';
+import { join } from 'path';
+import { createInterface } from 'readline';
+import { getPortfileDir, SmithUEError } from '../portfile.js';
+import { printResult, printError } from '../output.js';
+export async function purge(opts) {
+    if (!process.env['LOCALAPPDATA']) {
+        printError(new SmithUEError('LOCALAPPDATA env not set; smithue-cli purge is Windows-only', 2));
+        return;
+    }
+    const dir = getPortfileDir();
+    let dirStat;
+    try {
+        dirStat = await lstat(dir);
+    }
+    catch (e) {
+        if (e.code === 'ENOENT') {
+            printResult({
+                status: 'nothing_to_purge',
+                path: dir,
+                scanned: 0,
+                deleted: 0,
+                skipped_live: 0,
+                failed: 0,
+                directory_removed: false,
+                errors: [],
+                warnings: [],
+            });
+            return;
+        }
+        throw e;
+    }
+    if (dirStat.isSymbolicLink()) {
+        printError(new SmithUEError('Refusing to purge symlinked .smithue directory', 3));
+        return;
+    }
+    const entries = await readdir(dir);
+    const portEntries = entries.filter((e) => e.endsWith('.port'));
+    const unknownEntries = entries.filter((e) => !e.endsWith('.port'));
+    const scanned = portEntries.length;
+    const portFiles = [];
+    let skipped_live = 0;
+    if (opts.force) {
+        for (const name of portEntries) {
+            portFiles.push({ path: join(dir, name), dead: true });
+        }
+    }
+    else {
+        for (const name of portEntries) {
+            const filePath = join(dir, name);
+            let port;
+            try {
+                const raw = await readFile(filePath, 'utf-8');
+                const data = JSON.parse(raw);
+                port = data.port;
+            }
+            catch {
+                portFiles.push({ path: filePath, dead: true });
+                continue;
+            }
+            let alive = false;
+            try {
+                await fetch(`http://127.0.0.1:${port}/ready`, { signal: AbortSignal.timeout(1000) });
+                alive = true;
+            }
+            catch {
+                alive = false;
+            }
+            portFiles.push({ path: filePath, dead: !alive });
+            if (alive)
+                skipped_live++;
+        }
+    }
+    const toDelete = opts.force
+        ? [...portFiles.map((f) => f.path), ...unknownEntries.map((e) => join(dir, e))]
+        : portFiles.filter((f) => f.dead).map((f) => f.path);
+    const warnings = [];
+    if (!opts.force && unknownEntries.length > 0) {
+        warnings.push(`${unknownEntries.length} unknown file(s) skipped (use --force to remove): ${unknownEntries.join(', ')}`);
+    }
+    if (!opts.yes && !opts.dryRun) {
+        if (!process.stdin.isTTY) {
+            printError(new SmithUEError('Refusing to delete in non-interactive mode without -y/--yes', 1));
+            return;
+        }
+        const promptMsg = [
+            `Path: ${dir}`,
+            `  Files to delete: ${toDelete.length}`,
+            skipped_live > 0 ? `  Live portfiles skipped: ${skipped_live}` : null,
+            `Delete ${toDelete.length} file(s) from ${dir}? [y/N] `,
+        ].filter(Boolean).join('\n');
+        const rl = createInterface({ input: process.stdin, output: process.stderr });
+        const answer = await new Promise((resolve) => {
+            rl.question(promptMsg, (ans) => {
+                rl.close();
+                resolve(ans);
+            });
+        });
+        if (!/^y(es)?$/i.test(answer)) {
+            printResult({
+                status: 'cancelled',
+                path: dir,
+                scanned,
+                deleted: 0,
+                skipped_live,
+                failed: 0,
+                directory_removed: false,
+                errors: [],
+                warnings,
+            });
+            return;
+        }
+    }
+    if (opts.dryRun) {
+        printResult({
+            status: 'dry_run',
+            path: dir,
+            scanned,
+            deleted: toDelete.length,
+            skipped_live,
+            failed: 0,
+            directory_removed: false,
+            errors: [],
+            warnings,
+        });
+        return;
+    }
+    const errors = [];
+    let deleted = 0;
+    let failed = 0;
+    for (const filePath of toDelete) {
+        try {
+            await unlink(filePath);
+            deleted++;
+        }
+        catch (e) {
+            failed++;
+            errors.push(`${filePath}: ${e.message}`);
+        }
+    }
+    let directory_removed = false;
+    const remaining = await readdir(dir);
+    if (remaining.length === 0 && skipped_live === 0) {
+        try {
+            await rmdir(dir);
+            directory_removed = true;
+        }
+        catch (e) {
+            warnings.push(`Failed to remove directory ${dir}: ${e.message}`);
+        }
+    }
+    const status = skipped_live > 0 || failed > 0 ? 'partial' : 'purged';
+    printResult({ status, path: dir, scanned, deleted, skipped_live, failed, directory_removed, errors, warnings });
+}

package/dist/commands/search.d.ts

@@ -0,0 +1,8 @@
+export interface SearchOpts {
+    pid?: number;
+    project?: string;
+    port?: number;
+    cliVersion?: string;
+}
+export declare function searchCommand(keyword: string, opts: SearchOpts): Promise<void>;
+//# sourceMappingURL=search.d.ts.map

package/dist/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BpF"}

package/dist/commands/search.js

@@ -0,0 +1,31 @@
+import { discoverPort } from '../portfile.js';
+import { SmithUEClient } from '../client.js';
+import { printResult, printError } from '../output.js';
+import { checkVersionCompat } from '../version-check.js';
+export async function searchCommand(keyword, opts) {
+    try {
+        const discovered = await discoverPort(opts);
+        if (opts.cliVersion)
+            checkVersionCompat(opts.cliVersion, discovered.plugin_version);
+        const { port } = discovered;
+        const client = new SmithUEClient({ host: '127.0.0.1', port });
+        const domains = await client.listTools();
+        const kw = keyword.toLowerCase();
+        const matches = [];
+        for (const domainTool of domains) {
+            const domainName = domainTool.name;
+            const tools = await client.listTools(domainName);
+            for (const tool of tools) {
+                const name = tool.name ?? '';
+                const description = tool.description ?? '';
+                if (name.toLowerCase().includes(kw) || description.toLowerCase().includes(kw)) {
+                    matches.push({ domain: domainName, name, description });
+                }
+            }
+        }
+        printResult(matches);
+    }
+    catch (err) {
+        printError(err);
+    }
+}

package/dist/commands/status.d.ts

@@ -0,0 +1,9 @@
+export interface StatusOpts {
+    pid?: number;
+    project?: string;
+    port?: number;
+    wait?: number;
+    cliVersion?: string;
+}
+export declare function statusCommand(opts: StatusOpts): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CnE"}

package/dist/commands/status.js

@@ -0,0 +1,51 @@
+import { SmithUEClient } from '../client.js';
+import { discoverPort, SmithUEError } from '../portfile.js';
+import { printResult, printError } from '../output.js';
+import { checkVersionCompat } from '../version-check.js';
+async function sleep(ms) {
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function statusCommand(opts) {
+    try {
+        const discovered = await discoverPort(opts);
+        if (opts.cliVersion)
+            checkVersionCompat(opts.cliVersion, discovered.plugin_version);
+        const client = new SmithUEClient({ host: '127.0.0.1', port: discovered.port });
+        if (opts.wait !== undefined && opts.wait > 0) {
+            const timeoutMs = opts.wait * 1000;
+            const startedAt = Date.now();
+            while (true) {
+                const res = await client.getReady();
+                if (res.ready) {
+                    printResult({
+                        port: discovered.port,
+                        pid: discovered.pid,
+                        project_name: discovered.project_name,
+                        ready: res.ready,
+                        version: res.version,
+                        pie_active: res.pie_active,
+                    });
+                    return;
+                }
+                if (Date.now() - startedAt >= timeoutMs) {
+                    throw new SmithUEError('Timed out waiting for editor to be ready', 6);
+                }
+                await sleep(1000);
+            }
+        }
+        else {
+            const res = await client.getReady();
+            printResult({
+                port: discovered.port,
+                pid: discovered.pid,
+                project_name: discovered.project_name,
+                ready: res.ready,
+                version: res.version,
+                pie_active: res.pie_active,
+            });
+        }
+    }
+    catch (err) {
+        printError(err);
+    }
+}

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,2 @@
+export declare function upgradeCommand(): Promise<void>;
+//# sourceMappingURL=upgrade.d.ts.map

package/dist/commands/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAIA,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBpD"}

package/dist/commands/upgrade.js

@@ -0,0 +1,20 @@
+import { execSync } from 'node:child_process';
+import { SmithUEError } from '../portfile.js';
+import { printResult, printError } from '../output.js';
+export async function upgradeCommand() {
+    try {
+        const output = execSync('npm update -g smithue-cli', { stdio: 'pipe', encoding: 'utf-8' });
+        printResult({ status: 'updated', output: String(output).trim() });
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            printError(new SmithUEError('npm not found in PATH', 1));
+            return;
+        }
+        if (err instanceof Error) {
+            printError(new SmithUEError(err.message, 1));
+            return;
+        }
+        printError(new SmithUEError(String(err), 1));
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { readdir, unlink } from 'fs/promises';
+import { join } from 'path';
+import { execCommand } from './commands/exec.js';
+import { listCommand } from './commands/list.js';
+import { searchCommand } from './commands/search.js';
+import { statusCommand } from './commands/status.js';
+import { printResult, printError } from './output.js';
+const program = new Command();
+program
+    .name('smithue')
+    .description('CLI for SmithUE Unreal Engine plugin')
+    .version('0.7.0')
+    .option('--pid <pid>', 'target SmithUE instance by PID', parseInt)
+    .option('--project <path>', 'target SmithUE instance by project path')
+    .option('--port <port>', 'connect directly to port (skip discovery)', parseInt);
+// ---------------------------------------------------------------------------
+// exec
+// ---------------------------------------------------------------------------
+program
+    .command('exec <command> [params]')
+    .description('Execute a SmithUE command')
+    .action(async (command, params) => {
+    const globals = program.opts();
+    let parsedParams = {};
+    if (params) {
+        try {
+            parsedParams = JSON.parse(params);
+        }
+        catch {
+            printError(new Error(`params must be valid JSON, got: ${params}`));
+            return;
+        }
+    }
+    await execCommand(command, parsedParams, globals);
+});
+// ---------------------------------------------------------------------------
+// list
+// ---------------------------------------------------------------------------
+program
+    .command('list [domain]')
+    .description('List available tools, optionally filtered by domain')
+    .action(async (domain) => {
+    const globals = program.opts();
+    await listCommand(domain, globals);
+});
+// ---------------------------------------------------------------------------
+// search
+// ---------------------------------------------------------------------------
+program
+    .command('search <keyword>')
+    .description('Search tools by keyword')
+    .action(async (keyword) => {
+    const globals = program.opts();
+    await searchCommand(keyword, globals);
+});
+// ---------------------------------------------------------------------------
+// status
+// ---------------------------------------------------------------------------
+program
+    .command('status')
+    .description('Get SmithUE editor status')
+    .option('--wait <seconds>', 'wait up to N seconds for editor to be ready', parseInt)
+    .action(async (cmdOpts) => {
+    const globals = program.opts();
+    await statusCommand({ ...globals, wait: cmdOpts.wait });
+});
+// ---------------------------------------------------------------------------
+// prune
+// ---------------------------------------------------------------------------
+program
+    .command('prune')
+    .description('Remove stale portfiles for SmithUE instances that are no longer running')
+    .action(async () => {
+    const localAppData = process.env['LOCALAPPDATA'];
+    if (!localAppData) {
+        printResult({ scanned: 0, pruned: 0, kept: 0 });
+        return;
+    }
+    const dir = join(localAppData, '.smithue');
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        printResult({ scanned: 0, pruned: 0, kept: 0 });
+        return;
+    }
+    const portFiles = entries.filter((e) => e.endsWith('.port'));
+    let scanned = 0;
+    let pruned = 0;
+    let kept = 0;
+    for (const entry of portFiles) {
+        const filePath = join(dir, entry);
+        // Extract port from filename: <port>.port
+        const portStr = entry.slice(0, -'.port'.length);
+        const port = parseInt(portStr, 10);
+        scanned++;
+        if (isNaN(port) || port <= 0) {
+            // Malformed filename — treat as stale
+            try {
+                await unlink(filePath);
+            }
+            catch {
+                // best effort
+            }
+            pruned++;
+            continue;
+        }
+        let alive = false;
+        try {
+            const res = await fetch(`http://127.0.0.1:${port}/ready`, {
+                signal: AbortSignal.timeout(1000),
+            });
+            alive = res.status === 200;
+        }
+        catch {
+            alive = false;
+        }
+        if (alive) {
+            kept++;
+        }
+        else {
+            try {
+                await unlink(filePath);
+            }
+            catch {
+                // best effort
+            }
+            pruned++;
+        }
+    }
+    printResult({ scanned, pruned, kept });
+});
+// ---------------------------------------------------------------------------
+// Parse
+// ---------------------------------------------------------------------------
+await program.parseAsync(process.argv);

package/dist/output.d.ts

@@ -0,0 +1,8 @@
+export interface OutputOptions {
+    terse?: boolean;
+    outPath?: string;
+}
+export declare function setOutputOptions(opts: OutputOptions): void;
+export declare function printResult(data: unknown): void;
+export declare function printError(err: unknown): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAE1D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CA0B/C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAiB7C"}

package/dist/output.js

@@ -0,0 +1,46 @@
+import fs from 'node:fs';
+import { SmithUEError } from './portfile.js';
+let _opts = {};
+export function setOutputOptions(opts) {
+    _opts = { ..._opts, ...opts };
+}
+export function printResult(data) {
+    const json = _opts.terse
+        ? JSON.stringify(data) + '\n'
+        : JSON.stringify(data, null, 2) + '\n';
+    if (_opts.outPath) {
+        let isDir = false;
+        try {
+            isDir = fs.statSync(_opts.outPath).isDirectory();
+        }
+        catch {
+            // path doesn't exist — fine, writeFileSync will create it
+        }
+        if (isDir) {
+            process.stderr.write(JSON.stringify({ error: `outPath is a directory: ${_opts.outPath}`, exit_code: 1 }) + '\n');
+            process.exit(1);
+            return;
+        }
+        fs.writeFileSync(_opts.outPath, json, 'utf8');
+        return;
+    }
+    process.stdout.write(json);
+}
+export function printError(err) {
+    let message;
+    let exitCode;
+    if (err instanceof SmithUEError) {
+        message = err.message;
+        exitCode = err.exitCode;
+    }
+    else if (err instanceof Error) {
+        message = err.message;
+        exitCode = 4;
+    }
+    else {
+        message = String(err);
+        exitCode = 4;
+    }
+    process.stderr.write(JSON.stringify({ error: message, exit_code: exitCode }) + '\n');
+    process.exit(exitCode);
+}

package/dist/portfile.d.ts

@@ -0,0 +1,31 @@
+export declare class SmithUEError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode: number);
+}
+export interface PortfileData {
+    port: number;
+    pid: number;
+    project: string;
+    project_name: string;
+    started_at: string;
+    plugin_version: string;
+}
+export interface DiscoverResult {
+    port: number;
+    pid: number;
+    project: string;
+    project_name: string;
+    plugin_version?: string;
+}
+export interface DiscoverOpts {
+    pid?: number;
+    project?: string;
+    port?: number;
+}
+export declare function getPortfileDir(): string;
+export declare function readPortfiles(dir: string): Promise<Array<{
+    file: string;
+    data: PortfileData;
+}>>;
+export declare function discoverPort(opts?: DiscoverOpts): Promise<DiscoverResult>;
+//# sourceMappingURL=portfile.d.ts.map

package/dist/portfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portfile.d.ts","sourceRoot":"","sources":["../src/portfile.ts"],"names":[],"mappings":"AAQA,qBAAa,YAAa,SAAQ,KAAK;aAGnB,QAAQ,EAAE,MAAM;gBADhC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM;CAKnC;AAMD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,wBAAgB,cAAc,IAAI,MAAM,CASvC;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAuBrG;AA2BD,wBAAsB,YAAY,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAmFnF"}