smithue-cli 0.9.1 → 0.10.0

package/README.md

@@ -48,6 +48,8 @@ npx smithue-cli <command>
 | `upgrade` | Update the CLI to the latest version via npm |
 | `prune` | Remove stale port files from crashed instances |
 | `purge` | Remove the entire `.smithue` directory (full uninstall cleanup) |
+| `use` | Pin (or unpin) a default SmithUE instance for multi-editor setups |
+| `skill` | Print or install the bundled SKILL.md for AI agent integration |
 
 ## Output Modes
 
@@ -141,6 +143,25 @@ smithue-cli purge -y       # non-interactive full purge (CI/scripts)
 
 For routine cleanup of stale portfiles without removing the directory, use `smithue-cli prune` instead.
 
+## Exit Codes
+
+| Code | Meaning | Common cause |
+|---|---|---|
+| `0` | Success | Command completed normally |
+| `1` | Bad input or disambiguation required | Invalid arguments; multiple instances running without `--pid`/`--project`; `PAYLOAD_TOO_LARGE` |
+| `2` | Not found or unreachable | No portfiles found; instance unreachable; PID/project not matched |
+| `3` | Command error | `PIE_LOCKED`, `ASSET_NOT_FOUND`, `INVALID_REQUEST`, or unknown plugin error |
+| `4` | Internal / editor not ready | `INTERNAL_ERROR`, `EDITOR_NOT_READY`, unexpected exception |
+| `5` | Stale session NID | `STALE_NID` — node ID is outdated, re-run the command |
+| `6` | Wait timeout | `--wait` exceeded without editor becoming ready |
+
+Scripts can branch on exit codes:
+```powershell
+smithue-cli status
+if ($LASTEXITCODE -eq 2) { Write-Host "Editor not running" }
+if ($LASTEXITCODE -eq 5) { Write-Host "Reconnecting (stale NID)..." }
+```
+
 ## Known Limitations
 - Version 1 is Windows-only due to portfile path conventions.
 - No persistent configuration files. Use environment variables like `SMITHUE_PORT` or `SMITHUE_PID` for overrides.

package/dist/cli.js

@@ -7,9 +7,11 @@ 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 { useCommand } from './commands/use.js';
 import { purge } from './commands/purge.js';
 import { upgradeCommand } from './commands/upgrade.js';
 import { batchCommand } from './commands/batch.js';
+import { skillCommand } from './commands/skill.js';
 import { printResult, printError, setOutputOptions } from './output.js';
 const program = new Command();
 const require = createRequire(import.meta.url);
@@ -22,10 +24,15 @@ program
     .option('--project <path>', 'target SmithUE instance by project path')
     .option('--port <port>', 'connect directly to port (skip discovery)', parseInt)
     .option('--terse', 'emit minified JSON output')
-    .option('--out <file>', 'write result to file instead of stdout');
+    .option('--out <file>', 'write result to file instead of stdout')
+    .option('--strict', 'require explicit instance selection; error on multiple instances (CI mode)');
 program.hook('preAction', () => {
     const opts = program.opts();
     setOutputOptions({ terse: opts.terse, outPath: opts.out });
+    // SMITHUE_STRICT=1 env var acts as global --strict
+    if (!opts.strict && process.env['SMITHUE_STRICT'] === '1') {
+        program.setOptionValue('strict', true);
+    }
 });
 // ---------------------------------------------------------------------------
 // exec
@@ -79,6 +86,18 @@ program
     await statusCommand({ ...globals, wait: cmdOpts.wait, cliVersion });
 });
 // ---------------------------------------------------------------------------
+// use
+// ---------------------------------------------------------------------------
+program
+    .command('use')
+    .description('Pin a default SmithUE instance. Use --clear to unpin.')
+    .option('--pid <pid>', 'pin instance by PID', parseInt)
+    .option('--project <path>', 'pin instance by project path or name')
+    .option('--clear', 'remove the pinned instance')
+    .action(async (cmdOpts) => {
+    await useCommand(cmdOpts);
+});
+// ---------------------------------------------------------------------------
 // prune
 // ---------------------------------------------------------------------------
 program
@@ -175,6 +194,17 @@ program
     await upgradeCommand();
 });
 // ---------------------------------------------------------------------------
+// skill
+// ---------------------------------------------------------------------------
+program
+    .command('skill')
+    .description('Print or install the bundled SKILL.md for AI agent integration')
+    .option('--print', 'print SKILL.md to stdout')
+    .option('--install <dir>', 'install SKILL.md into the specified directory')
+    .action(async (cmdOpts) => {
+    await skillCommand(cmdOpts);
+});
+// ---------------------------------------------------------------------------
 // batch
 // ---------------------------------------------------------------------------
 program

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,mBAAmB;IAMvC,OAAO,KAAK,OAAO,GAElB;IAED,OAAO,CAAC,OAAO;YAID,SAAS;YAwBT,QAAQ;YAQR,OAAO;IAOrB,OAAO,CAAC,qBAAqB;IAwBvB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAa/F,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAItG,IAAI,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAKpC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAUxD,QAAQ,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAI/E,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS/B,mBAAmB,CACvB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,sBAAsB,CAAC;IA6ClC,OAAO,CAAC,0BAA0B;YAmBpB,cAAc;IAe5B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,QAAQ;YAIF,KAAK;CAGpB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,mBAAmB;IAMvC,OAAO,KAAK,OAAO,GAElB;IAED,OAAO,CAAC,OAAO;YAID,SAAS;YAwBT,QAAQ;YAQR,OAAO;IAOrB,OAAO,CAAC,qBAAqB;IAyBvB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAa/F,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAItG,IAAI,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAKpC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAUxD,QAAQ,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAI/E,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS/B,mBAAmB,CACvB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,sBAAsB,CAAC;IA6ClC,OAAO,CAAC,0BAA0B;YAmBpB,cAAc;IAe5B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,QAAQ;YAIF,KAAK;CAGpB"}

package/dist/client.js

@@ -58,7 +58,8 @@ export class SmithUEClient {
             msg.includes('Failed to fetch') ||
             msg.includes('ENOTFOUND') ||
             msg.includes('connect ECONNREFUSED')) {
-            return new Error(`SmithUE plugin unreachable at ${this.host}:${this.port}. Start UE Editor with SmithUE plugin enabled.`);
+            return new Error(`SmithUE plugin unreachable at ${this.host}:${this.port}. Start UE Editor with SmithUE plugin enabled.\n` +
+                `  Fallback: curl -s http://${this.host}:${this.port}/api/v1/execute -d '{"command":"ping","params":{}}'`);
         }
         return err instanceof Error ? err : new Error(String(err));
     }

package/dist/commands/skill.d.ts

@@ -0,0 +1,6 @@
+export interface SkillOpts {
+    print?: boolean;
+    install?: string;
+}
+export declare function skillCommand(opts: SkillOpts): Promise<void>;
+//# sourceMappingURL=skill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCjE"}

package/dist/commands/skill.js

@@ -0,0 +1,38 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { printError, printResult } from '../output.js';
+import { SmithUEError } from '../portfile.js';
+function getSkillPath() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolve(here, '..', '..', 'skill', 'SKILL.md');
+}
+export async function skillCommand(opts) {
+    try {
+        if (!opts.print && !opts.install) {
+            throw new SmithUEError('Specify --print to output SKILL.md, or --install <dir> to install it.', 1);
+        }
+        const skillPath = getSkillPath();
+        let content;
+        try {
+            content = await readFile(skillPath, 'utf-8');
+        }
+        catch {
+            throw new SmithUEError(`SKILL.md not found at ${skillPath}. Reinstall smithue-cli to fix.`, 4);
+        }
+        if (opts.print) {
+            process.stdout.write(content);
+            return;
+        }
+        if (opts.install) {
+            const dir = resolve(opts.install);
+            await mkdir(dir, { recursive: true });
+            const destPath = join(dir, 'SKILL.md');
+            await writeFile(destPath, content, 'utf-8');
+            printResult({ ok: true, installed: destPath });
+        }
+    }
+    catch (err) {
+        printError(err);
+    }
+}

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

@@ -1 +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"}
+{"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,CAgDnE"}

package/dist/commands/status.js

@@ -24,6 +24,8 @@ export async function statusCommand(opts) {
                         ready: res.ready,
                         version: res.version,
                         pie_active: res.pie_active,
+                        ...(discovered.selection_mode ? { selection_mode: discovered.selection_mode } : {}),
+                        ...(discovered.busy ? { busy: true } : {}),
                     });
                     return;
                 }
@@ -42,6 +44,8 @@ export async function statusCommand(opts) {
                 ready: res.ready,
                 version: res.version,
                 pie_active: res.pie_active,
+                ...(discovered.selection_mode ? { selection_mode: discovered.selection_mode } : {}),
+                ...(discovered.busy ? { busy: true } : {}),
             });
         }
     }

package/dist/commands/use.d.ts

@@ -0,0 +1,7 @@
+export interface UseOpts {
+    pid?: number;
+    project?: string;
+    clear?: boolean;
+}
+export declare function useCommand(opts: UseOpts): Promise<void>;
+//# sourceMappingURL=use.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use.d.ts","sourceRoot":"","sources":["../../src/commands/use.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD7D"}

package/dist/commands/use.js

@@ -0,0 +1,45 @@
+import { readPortfiles, getPortfileDir, SmithUEError } from '../portfile.js';
+import { setPinned, clearPinned, getPinned } from '../registry.js';
+import { projectId } from '../identity.js';
+import { printResult, printError } from '../output.js';
+export async function useCommand(opts) {
+    try {
+        if (opts.clear) {
+            await getPinned();
+            await clearPinned();
+            printResult({ ok: true, action: 'cleared', pinned: null });
+            return;
+        }
+        if (opts.pid === undefined && opts.project === undefined) {
+            throw new SmithUEError('Specify --pid <n> or --project <path> to pin an instance, or --clear to unpin.', 1);
+        }
+        const dir = getPortfileDir();
+        const all = await readPortfiles(dir);
+        const candidate = all.find((c) => {
+            if (opts.pid !== undefined)
+                return c.data.pid === opts.pid;
+            if (opts.project !== undefined) {
+                return c.data.project === opts.project || c.data.project_name === opts.project;
+            }
+            return false;
+        });
+        if (!candidate) {
+            throw new SmithUEError(opts.pid !== undefined
+                ? `No running SmithUE instance found with PID ${opts.pid}.`
+                : `No running SmithUE instance found for project "${opts.project}".`, 2);
+        }
+        const entry = {
+            projectId: projectId(candidate.data.project || ''),
+            pid: candidate.data.pid,
+            port: candidate.data.port,
+            project: candidate.data.project,
+            project_name: candidate.data.project_name,
+            lastConnectedAt: new Date().toISOString(),
+        };
+        await setPinned(entry);
+        printResult({ ok: true, action: 'pinned', pinned: entry });
+    }
+    catch (err) {
+        printError(err);
+    }
+}

package/dist/identity.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Derive a stable, short identifier for an absolute project path.
+ * Inspired by Obsidian's path-hash vault identity — survives pid/port changes.
+ *
+ * Algorithm: normalize path (resolve + lowercase on Windows) → SHA-256 → first 16 hex chars.
+ */
+export declare function projectId(absPath: string): string;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGjD"}

package/dist/identity.js

@@ -0,0 +1,17 @@
+import { createHash } from 'node:crypto';
+import { resolve } from 'node:path';
+/**
+ * Derive a stable, short identifier for an absolute project path.
+ * Inspired by Obsidian's path-hash vault identity — survives pid/port changes.
+ *
+ * Algorithm: normalize path (resolve + lowercase on Windows) → SHA-256 → first 16 hex chars.
+ */
+export function projectId(absPath) {
+    const normalized = normalizePath(absPath);
+    return createHash('sha256').update(normalized, 'utf8').digest('hex').slice(0, 16);
+}
+function normalizePath(p) {
+    const resolved = resolve(p);
+    // Windows paths are case-insensitive; normalize to lowercase for stable hashing
+    return process.platform === 'win32' ? resolved.toLowerCase() : resolved;
+}

package/dist/output.d.ts

@@ -2,6 +2,7 @@ export interface OutputOptions {
     terse?: boolean;
     outPath?: string;
 }
+export declare function escapeNonAscii(s: string): string;
 export declare function setOutputOptions(opts: OutputOptions): void;
 export declare function printResult(data: unknown): void;
 export declare function printError(err: unknown): void;

package/dist/output.d.ts.map

@@ -1 +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"}
+{"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,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAWhD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAE1D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CA2B/C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAkC7C"}

package/dist/output.js

@@ -1,6 +1,19 @@
 import fs from 'node:fs';
 import { SmithUEError } from './portfile.js';
 let _opts = {};
+export function escapeNonAscii(s) {
+    let out = '';
+    for (let i = 0; i < s.length; i++) {
+        const code = s.charCodeAt(i);
+        if (code < 0x80) {
+            out += s[i];
+        }
+        else {
+            out += `\\u${code.toString(16).padStart(4, '0')}`;
+        }
+    }
+    return out;
+}
 export function setOutputOptions(opts) {
     _opts = { ..._opts, ...opts };
 }
@@ -17,14 +30,15 @@ export function printResult(data) {
             // 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.stderr.write(escapeNonAscii(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);
+    process.stdout.write(escapeNonAscii(json));
 }
 export function printError(err) {
     let message;
@@ -41,6 +55,21 @@ export function printError(err) {
         message = String(err);
         exitCode = 4;
     }
-    process.stderr.write(JSON.stringify({ error: message, exit_code: exitCode }) + '\n');
+    // Extract curl fallback from message if present (written as "  Fallback: curl ...")
+    const fallbackMatch = message.match(/\n\s+Fallback:\s+(curl\s+.+)/);
+    const fallback_cmd = fallbackMatch ? fallbackMatch[1].trim() : undefined;
+    const cleanMessage = message.split('\n')[0]; // first line for code-parseable summary
+    // Machine-readable error envelope (P3.3)
+    const envelope = {
+        ok: false,
+        error: {
+            message: cleanMessage,
+            full_message: message,
+            code: exitCode,
+            exit: exitCode,
+            ...(fallback_cmd ? { hint: 'Use fallback_cmd to verify connectivity.', fallback_cmd } : {}),
+        },
+    };
+    process.stderr.write(escapeNonAscii(JSON.stringify(envelope)) + '\n');
     process.exit(exitCode);
 }

package/dist/portfile.d.ts

@@ -16,11 +16,15 @@ export interface DiscoverResult {
     project: string;
     project_name: string;
     plugin_version?: string;
+    selection_mode?: 'pinned' | 'most-recent' | 'explicit';
+    busy?: boolean;
 }
 export interface DiscoverOpts {
     pid?: number;
     project?: string;
     port?: number;
+    /** When true, revert to hard-error on multi-instance (CI/script mode). Default: false. */
+    strict?: boolean;
 }
 export declare function getPortfileDir(): string;
 export declare function readPortfiles(dir: string): Promise<Array<{

package/dist/portfile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portfile.d.ts","sourceRoot":"","sources":["../src/portfile.ts"],"names":[],"mappings":"AASA,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;AA8CD,wBAAsB,YAAY,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAmFnF"}
+{"version":3,"file":"portfile.d.ts","sourceRoot":"","sources":["../src/portfile.ts"],"names":[],"mappings":"AAWA,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;IACxB,cAAc,CAAC,EAAE,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC;IACvD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;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;AA+CD,wBAAsB,YAAY,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyKnF"}

package/dist/portfile.js

@@ -1,6 +1,8 @@
 import { readdir, readFile, unlink } from 'fs/promises';
 import { join } from 'path';
 import { isProcessAlive } from './proc.js';
+import * as registry from './registry.js';
+import { projectId } from './identity.js';
 // ---------------------------------------------------------------------------
 // Error class
 // ---------------------------------------------------------------------------
@@ -53,18 +55,19 @@ async function checkLiveness(port, filePath, pid) {
             signal: AbortSignal.timeout(timeoutMs),
         });
         // any HTTP response = server is alive (including 503 during startup)
-        return;
+        return { busy: false };
     }
     catch (err) {
         const error = err;
         // Timeout means the editor may be busy running a long command.
         // Keep the portfile and treat the instance as alive/busy.
         if (error.name === 'AbortError') {
-            return;
+            return { busy: true };
         }
         const processAlive = pid > 0 && isProcessAlive(pid);
         if (processAlive) {
-            throw new SmithUEError(`SmithUE instance on port ${port} is unreachable, but process ${pid} is still running. Try again or restart the editor.`, 2);
+            throw new SmithUEError(`SmithUE instance on port ${port} is unreachable, but process ${pid} is still running. Try again or restart the editor.\n` +
+                `  Fallback: curl -s http://127.0.0.1:${port}/api/v1/execute -d '{"command":"ping","params":{}}'`, 2);
         }
         // Connection-level failure is stale only when the owning process is dead.
         try {
@@ -87,12 +90,13 @@ export async function discoverPort(opts = {}) {
         if (isNaN(port) || port <= 0) {
             throw new SmithUEError(`SMITHUE_PORT is not a valid port number: "${envPort}"`, 1);
         }
-        return { port, pid: 0, project: '', project_name: '' };
+        return { port, pid: 0, project: '', project_name: '', selection_mode: 'explicit', busy: false };
     }
     // 2. --port flag shortcut (already resolved by caller, treated same as env override)
     if (opts.port !== undefined) {
-        return { port: opts.port, pid: 0, project: '', project_name: '' };
+        return { port: opts.port, pid: 0, project: '', project_name: '', selection_mode: 'explicit', busy: false };
     }
+    let selectionMode = 'explicit';
     // 3. Determine effective PID filter (--pid > SMITHUE_PID env)
     let pidFilter = opts.pid;
     if (pidFilter === undefined) {
@@ -108,7 +112,10 @@ export async function discoverPort(opts = {}) {
     const dir = getPortfileDir();
     const all = await readPortfiles(dir);
     if (all.length === 0) {
-        throw new SmithUEError('No SmithUE portfiles found. Is the SmithUE plugin running in Unreal Editor?', 2);
+        throw new SmithUEError(`No SmithUE portfiles found. Is the SmithUE plugin running in Unreal Editor?\n` +
+            `  Check: status bar SmithUE green dot in UE Editor.\n` +
+            `  Port dir: ${dir}\n` +
+            `  Direct connect: set SMITHUE_PORT=<port> or use --port <port>.`, 2);
     }
     // 5. Apply filters
     let candidates = all;
@@ -119,27 +126,86 @@ export async function discoverPort(opts = {}) {
         }
     }
     else if (opts.project !== undefined) {
-        // Exact absolute path comparison (M7)
-        candidates = candidates.filter((c) => c.data.project === opts.project);
-        if (candidates.length === 0) {
-            throw new SmithUEError(`No SmithUE instance found for project "${opts.project}".`, 2);
+        const query = opts.project;
+        // 1. Try exact absolute path comparison (backward-compatible, M7)
+        let matched = candidates.filter((c) => c.data.project === query);
+        // 2. Fuzzy fallback: match by project_name or basename of project path
+        if (matched.length === 0) {
+            const q = query.toLowerCase();
+            matched = candidates.filter((c) => {
+                const name = c.data.project_name?.toLowerCase() ?? '';
+                const base = c.data.project.split(/[\\/]/).pop()?.toLowerCase() ?? '';
+                return name === q || base === q || name.includes(q);
+            });
+        }
+        if (matched.length === 0) {
+            throw new SmithUEError(`No SmithUE instance found for project "${query}". Use --pid to select by process ID.`, 2);
         }
+        // Multiple fuzzy matches → give list so user can disambiguate with --pid
+        if (matched.length > 1) {
+            const list = matched
+                .map((c) => `  PID ${c.data.pid}  ${c.data.project_name}  (port ${c.data.port})`)
+                .join('\n');
+            throw new SmithUEError(`Multiple SmithUE instances match "${query}". Use --pid to select one:\n${list}`, 1);
+        }
+        candidates = matched;
     }
-    // 6. Multi-instance error (no disambiguation possible)
+    // 6. Multi-instance: select most-recent or hard-error in strict mode
     if (candidates.length > 1) {
-        const list = candidates
-            .map((c) => `  PID ${c.data.pid}  ${c.data.project_name}  (port ${c.data.port})`)
-            .join('\n');
-        throw new SmithUEError(`Multiple SmithUE instances are running. Use --pid or --project to select one:\n${list}`, 1);
+        if (opts.strict) {
+            const list = candidates
+                .map((c) => `  PID ${c.data.pid}  ${c.data.project_name}  (port ${c.data.port})`)
+                .join('\n');
+            throw new SmithUEError(`Multiple SmithUE instances are running. Use --pid or --project to select one:\n${list}`, 1);
+        }
+        const pinned = registry.getPinned ? await registry.getPinned() : undefined;
+        if (pinned) {
+            const pinnedCandidate = candidates.find((c) => c.data.pid === pinned.pid && c.data.port === pinned.port);
+            if (pinnedCandidate) {
+                process.stderr.write(`[smithue] selected PID ${pinned.pid} ${pinned.project_name} (pinned)\n`);
+                selectionMode = 'pinned';
+                candidates = [pinnedCandidate];
+            }
+        }
+        const recent = await registry.getMostRecent();
+        if (recent) {
+            const recentCandidate = candidates.find((c) => c.data.pid === recent.pid && c.data.port === recent.port);
+            if (recentCandidate) {
+                process.stderr.write(`[smithue] selected PID ${recent.pid} ${recent.project_name} (most recent)\n`);
+                selectionMode = 'most-recent';
+                candidates = [recentCandidate];
+            }
+        }
+        if (candidates.length > 1) {
+            const list = candidates
+                .map((c) => `  PID ${c.data.pid}  ${c.data.project_name}  (port ${c.data.port})`)
+                .join('\n');
+            throw new SmithUEError(`Multiple SmithUE instances are running. Use --pid or --project to select one:\n${list}`, 1);
+        }
     }
     // 7. Single candidate — liveness check
     const { file, data } = candidates[0];
-    await checkLiveness(data.port, file, data.pid);
+    const liveness = await checkLiveness(data.port, file, data.pid);
+    try {
+        await registry.updateLastUsed({
+            projectId: projectId(data.project || ''),
+            pid: data.pid,
+            port: data.port,
+            project: data.project,
+            project_name: data.project_name,
+            lastConnectedAt: new Date().toISOString(),
+        });
+    }
+    catch {
+        // best effort
+    }
     return {
         port: data.port,
         pid: data.pid,
         project: data.project,
         project_name: data.project_name,
         plugin_version: data.plugin_version,
+        selection_mode: selectionMode,
+        busy: liveness.busy,
     };
 }

package/dist/registry.d.ts

@@ -0,0 +1,19 @@
+export interface RegistryEntry {
+    projectId: string;
+    pid: number;
+    port: number;
+    project: string;
+    project_name: string;
+    lastConnectedAt: string;
+}
+export interface Registry {
+    entries: RegistryEntry[];
+    pinned?: RegistryEntry;
+}
+export declare function readRegistry(): Promise<Registry>;
+export declare function updateLastUsed(entry: RegistryEntry): Promise<void>;
+export declare function getPinned(): Promise<RegistryEntry | undefined>;
+export declare function setPinned(entry: RegistryEntry): Promise<void>;
+export declare function clearPinned(): Promise<void>;
+export declare function getMostRecent(): Promise<RegistryEntry | undefined>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAMD,wBAAsB,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC,CAOtD;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxE;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAGpE;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAInE;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAIjD;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAGxE"}

package/dist/registry.js

@@ -0,0 +1,46 @@
+import { readFile, writeFile, rename } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getPortfileDir } from './portfile.js';
+function getRegistryPath() {
+    return join(getPortfileDir(), 'last-used.json');
+}
+export async function readRegistry() {
+    try {
+        const raw = await readFile(getRegistryPath(), 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return { entries: [] };
+    }
+}
+export async function updateLastUsed(entry) {
+    const reg = await readRegistry();
+    reg.entries = reg.entries.filter((e) => e.projectId !== entry.projectId);
+    reg.entries.unshift(entry);
+    reg.entries = reg.entries.slice(0, 20);
+    await writeRegistryAtomic(reg);
+}
+export async function getPinned() {
+    const reg = await readRegistry();
+    return reg.pinned;
+}
+export async function setPinned(entry) {
+    const reg = await readRegistry();
+    reg.pinned = entry;
+    await writeRegistryAtomic(reg);
+}
+export async function clearPinned() {
+    const reg = await readRegistry();
+    delete reg.pinned;
+    await writeRegistryAtomic(reg);
+}
+export async function getMostRecent() {
+    const reg = await readRegistry();
+    return reg.entries[0];
+}
+async function writeRegistryAtomic(reg) {
+    const path = getRegistryPath();
+    const tmp = path + '.tmp';
+    await writeFile(tmp, JSON.stringify(reg, null, 2), 'utf-8');
+    await rename(tmp, path);
+}

package/dist/types.d.ts

@@ -47,4 +47,26 @@ export interface PurgeResult {
     errors: string[];
     warnings: string[];
 }
+/** Persisted entry in last-used.json registry. */
+export interface RegistryEntry {
+    projectId: string;
+    pid: number;
+    port: number;
+    project: string;
+    project_name: string;
+    lastConnectedAt: string;
+}
+/** Shape of last-used.json on disk. */
+export interface Registry {
+    entries: RegistryEntry[];
+    pinned?: RegistryEntry;
+}
+/** Extends portfile DiscoverOpts with multi-instance selection flags. */
+export interface DiscoverOptsExtended {
+    pid?: number;
+    project?: string;
+    port?: number;
+    /** If true, revert to hard-error on multi-instance (CI/script mode). Default: false. */
+    strict?: boolean;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,IAAI,EAAE;QACJ,gBAAgB,EAAE,MAAM,CAAC;QACzB,KAAK,EAAE,iBAAiB,EAAE,CAAC;KAC5B,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,IAAI,EAAE;QACJ,gBAAgB,EAAE,MAAM,CAAC;QACzB,KAAK,EAAE,iBAAiB,EAAE,CAAC;KAC5B,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,uCAAuC;AACvC,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/package.json

@@ -1,40 +1,40 @@
 {
-    "name":  "smithue-cli",
-    "version":  "0.9.1",
-    "type":  "module",
-    "main":  "dist/cli.js",
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit",
-    "dev": "tsc -p tsconfig.build.json --watch"
-  },
-  "files": [
-    "dist/",
-    "package.json",
-    "README.md"
-  ],
-    "devDependencies":  {
-                            "@types/node":  "^20.0.0",
-                            "typescript":  "^5.3.0",
-                            "vitest":  "^1.0.0"
-                        },
-    "dependencies":  {
-                         "commander":  "^15.0.0"
-                     },
-    "bin":  {
-                "smithue-cli":  "dist/cli.js"
-            },
-    "engines":  {
-                    "node":  "\u003e=18"
-                },
-    "publishConfig":  {
-                          "access":  "public"
-                      },
-    "license":  "MIT",
-    "description":  "CLI tool for controlling Unreal Engine editor via SmithUE plugin",
-    "repository":  {
-                       "type":  "git",
-                       "url":  "https://github.com/123dx-svg/smithue-cli.git"
-                   }
+    "name": "smithue-cli",
+    "version": "0.10.0",
+    "type": "module",
+    "main": "dist/cli.js",
+    "scripts": {
+        "build": "tsc -p tsconfig.build.json",
+        "test": "vitest run",
+        "typecheck": "tsc --noEmit",
+        "dev": "tsc -p tsconfig.build.json --watch"
+    },
+    "files": [
+        "dist/",
+        "package.json",
+        "README.md"
+    ],
+    "devDependencies": {
+        "@types/node": "^20.0.0",
+        "typescript": "^5.3.0",
+        "vitest": "^1.0.0"
+    },
+    "dependencies": {
+        "commander": "^15.0.0"
+    },
+    "bin": {
+        "smithue-cli": "dist/cli.js"
+    },
+    "engines": {
+        "node": ">=18"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "license": "MIT",
+    "description": "CLI tool for controlling Unreal Engine editor via SmithUE plugin",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/123dx-svg/smithue-cli.git"
+    }
 }