@jackwener/opencli 1.6.3 → 1.6.5

package/dist/clis/xueqiu/danjuan-utils.d.ts

@@ -5,7 +5,7 @@
  * all per-account holdings in parallel (Promise.all), minimising Node↔Browser
  * round-trips to exactly one.
  */
-import type { IPage } from '../../src/types.js';
+import type { IPage } from '@jackwener/opencli/types';
 export declare const DANJUAN_DOMAIN = "danjuanfunds.com";
 export declare const DANJUAN_ASSET_PAGE = "https://danjuanfunds.com/my-money";
 export interface DanjuanAccount {

package/dist/clis/xueqiu/fund-holdings.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../src/registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { fetchDanjuanAll } from './danjuan-utils.js';
 cli({
     site: 'xueqiu',

package/dist/clis/xueqiu/fund-snapshot.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../src/registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { fetchDanjuanAll } from './danjuan-utils.js';
 cli({
     site: 'xueqiu',

package/dist/clis/yahoo-finance/quote.js

@@ -1,7 +1,7 @@
 /**
  * Yahoo Finance stock quote — multi-strategy API fallback.
  */
-import { cli, Strategy } from '../../src/registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'yahoo-finance',
     name: 'quote',

package/dist/clis/yollomi/background.js

@@ -3,8 +3,8 @@
  */
 import * as path from 'node:path';
 import chalk from 'chalk';
-import { cli, Strategy } from '../../src/registry.js';
-import { CliError } from '../../src/errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
 import { YOLLOMI_DOMAIN, yollomiPost, downloadOutput, fmtBytes } from './utils.js';
 cli({
     site: 'yollomi',

package/dist/clis/yollomi/edit.js

@@ -4,8 +4,8 @@
  */
 import * as path from 'node:path';
 import chalk from 'chalk';
-import { cli, Strategy } from '../../src/registry.js';
-import { CliError } from '../../src/errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
 import { YOLLOMI_DOMAIN, yollomiPost, downloadOutput, fmtBytes } from './utils.js';
 cli({
     site: 'yollomi',

package/dist/clis/yollomi/face-swap.js

@@ -4,8 +4,8 @@
  */
 import * as path from 'node:path';
 import chalk from 'chalk';
-import { cli, Strategy } from '../../src/registry.js';
-import { CliError } from '../../src/errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
 import { YOLLOMI_DOMAIN, yollomiPost, downloadOutput, fmtBytes } from './utils.js';
 cli({
     site: 'yollomi',

package/dist/clis/yollomi/generate.js

@@ -8,8 +8,8 @@
  */
 import * as path from 'node:path';
 import chalk from 'chalk';
-import { cli, Strategy } from '../../src/registry.js';
-import { CliError } from '../../src/errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
 import { YOLLOMI_DOMAIN, yollomiPost, downloadOutput, fmtBytes, MODEL_ROUTES } from './utils.js';
 function getDimensions(ratio) {
     const map = {

package/dist/clis/yollomi/models.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../src/registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { IMAGE_MODELS, VIDEO_MODELS, TOOL_MODELS } from './utils.js';
 cli({
     site: 'yollomi',

package/dist/clis/yollomi/object-remover.js

@@ -3,8 +3,8 @@
  */
 import * as path from 'node:path';
 import chalk from 'chalk';
-import { cli, Strategy } from '../../src/registry.js';
-import { CliError } from '../../src/errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
 import { YOLLOMI_DOMAIN, yollomiPost, downloadOutput, fmtBytes } from './utils.js';
 cli({
     site: 'yollomi',

package/dist/clis/yollomi/remove-bg.js

@@ -3,8 +3,8 @@
  */
 import * as path from 'node:path';
 import chalk from 'chalk';
-import { cli, Strategy } from '../../src/registry.js';
-import { CliError } from '../../src/errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
 import { YOLLOMI_DOMAIN, yollomiPost, downloadOutput, fmtBytes } from './utils.js';
 cli({
     site: 'yollomi',

package/dist/clis/yollomi/restore.js

@@ -3,8 +3,8 @@
  */
 import * as path from 'node:path';
 import chalk from 'chalk';
-import { cli, Strategy } from '../../src/registry.js';
-import { CliError } from '../../src/errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
 import { YOLLOMI_DOMAIN, yollomiPost, downloadOutput, fmtBytes } from './utils.js';
 cli({
     site: 'yollomi',

package/dist/clis/yollomi/try-on.js

@@ -3,8 +3,8 @@
  */
 import * as path from 'node:path';
 import chalk from 'chalk';
-import { cli, Strategy } from '../../src/registry.js';
-import { CliError } from '../../src/errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
 import { YOLLOMI_DOMAIN, yollomiPost, downloadOutput, fmtBytes } from './utils.js';
 cli({
     site: 'yollomi',

package/dist/clis/yollomi/upload.js

@@ -7,8 +7,8 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import chalk from 'chalk';
-import { cli, Strategy } from '../../src/registry.js';
-import { CliError } from '../../src/errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
 import { YOLLOMI_DOMAIN, ensureOnYollomi, fmtBytes } from './utils.js';
 const MIME_MAP = {
     '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg',

package/dist/clis/yollomi/upscale.js

@@ -3,8 +3,8 @@
  */
 import * as path from 'node:path';
 import chalk from 'chalk';
-import { cli, Strategy } from '../../src/registry.js';
-import { CliError } from '../../src/errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
 import { YOLLOMI_DOMAIN, yollomiPost, downloadOutput, fmtBytes } from './utils.js';
 cli({
     site: 'yollomi',

package/dist/clis/yollomi/utils.d.ts

@@ -7,7 +7,7 @@
  *
  * Auth: browser session cookies from NextAuth — just log in to yollomi.com in Chrome.
  */
-import type { IPage } from '../../src/types.js';
+import type { IPage } from '@jackwener/opencli/types';
 export declare const YOLLOMI_DOMAIN = "yollomi.com";
 /**
  * Ensure the browser tab is on yollomi.com.

package/dist/clis/yollomi/utils.js

@@ -9,7 +9,7 @@
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { CliError } from '../../src/errors.js';
+import { CliError } from '@jackwener/opencli/errors';
 export const YOLLOMI_DOMAIN = 'yollomi.com';
 /**
  * Ensure the browser tab is on yollomi.com.

package/dist/clis/yollomi/video.js

@@ -4,8 +4,8 @@
  */
 import * as path from 'node:path';
 import chalk from 'chalk';
-import { cli, Strategy } from '../../src/registry.js';
-import { CliError } from '../../src/errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
 import { YOLLOMI_DOMAIN, yollomiPost, downloadOutput, fmtBytes } from './utils.js';
 cli({
     site: 'yollomi',

package/dist/clis/youtube/channel.js

@@ -1,8 +1,8 @@
 /**
  * YouTube channel — get channel info and recent videos via InnerTube API.
  */
-import { cli, Strategy } from '../../src/registry.js';
-import { CommandExecutionError } from '../../src/errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CommandExecutionError } from '@jackwener/opencli/errors';
 cli({
     site: 'youtube',
     name: 'channel',

package/dist/clis/youtube/comments.js

@@ -1,8 +1,8 @@
 /**
  * YouTube comments — get video comments via InnerTube API.
  */
-import { cli, Strategy } from '../../src/registry.js';
-import { CommandExecutionError } from '../../src/errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CommandExecutionError } from '@jackwener/opencli/errors';
 import { parseVideoId } from './utils.js';
 cli({
     site: 'youtube',

package/dist/clis/youtube/search.js

@@ -1,7 +1,7 @@
 /**
  * YouTube search — innertube API via browser session.
  */
-import { cli, Strategy } from '../../src/registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'youtube',
     name: 'search',

package/dist/clis/youtube/transcript.js

@@ -9,10 +9,10 @@
  *   --mode grouped (default): sentences merged, speaker detection, chapters
  *   --mode raw: every caption segment as-is with precise timestamps
  */
-import { cli, Strategy } from '../../src/registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { parseVideoId, prepareYoutubeApiPage } from './utils.js';
 import { groupTranscriptSegments, formatGroupedTranscript, } from './transcript-group.js';
-import { CommandExecutionError, EmptyResultError } from '../../src/errors.js';
+import { CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
 cli({
     site: 'youtube',
     name: 'transcript',

package/dist/clis/youtube/utils.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared YouTube utilities — URL parsing, video ID extraction, etc.
  */
-import type { IPage } from '../../src/types.js';
+import type { IPage } from '@jackwener/opencli/types';
 /**
  * Extract a YouTube video ID from a URL or bare video ID string.
  * Supports: watch?v=, youtu.be/, /shorts/, /embed/, /live/, /v/

package/dist/clis/youtube/video.js

@@ -1,9 +1,9 @@
 /**
  * YouTube video metadata — fetch watch HTML and parse bootstrap data without opening the watch UI.
  */
-import { cli, Strategy } from '../../src/registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { extractJsonAssignmentFromHtml, parseVideoId, prepareYoutubeApiPage } from './utils.js';
-import { CommandExecutionError } from '../../src/errors.js';
+import { CommandExecutionError } from '@jackwener/opencli/errors';
 cli({
     site: 'youtube',
     name: 'video',

package/dist/clis/yuanbao/ask.d.ts

@@ -8,7 +8,7 @@ export declare function updateStableState(previousText: string, stableCount: num
     previousText: string;
     stableCount: number;
 };
-export declare const askCommand: import("../../src/registry.js").CliCommand;
+export declare const askCommand: import("@jackwener/opencli/registry").CliCommand;
 export declare const __test__: {
     collectYuanbaoTranscriptAdditions: typeof collectYuanbaoTranscriptAdditions;
     convertYuanbaoHtmlToMarkdown: typeof convertYuanbaoHtmlToMarkdown;

package/dist/clis/yuanbao/ask.js

@@ -1,6 +1,6 @@
-import { cli, Strategy } from '../../src/registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import TurndownService from 'turndown';
-import { CommandExecutionError, TimeoutError } from '../../src/errors.js';
+import { CommandExecutionError, TimeoutError } from '@jackwener/opencli/errors';
 import { YUANBAO_DOMAIN, IS_VISIBLE_JS, authRequired, isOnYuanbao, ensureYuanbaoPage, hasLoginGate } from './shared.js';
 const YUANBAO_RESPONSE_POLL_INTERVAL_SECONDS = 2;
 const YUANBAO_MIN_WAIT_MS = 8_000;

package/dist/clis/yuanbao/ask.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it, vi } from 'vitest';
-import { AuthRequiredError, CommandExecutionError, TimeoutError } from '../../src/errors.js';
+import { AuthRequiredError, CommandExecutionError, TimeoutError } from '@jackwener/opencli/errors';
 import { __test__ } from './ask.js';
 import { askCommand } from './ask.js';
 describe('yuanbao ask helpers', () => {

package/dist/clis/yuanbao/new.d.ts

@@ -1 +1 @@
-export declare const newCommand: import("../../src/registry.js").CliCommand;
+export declare const newCommand: import("@jackwener/opencli/registry").CliCommand;

package/dist/clis/yuanbao/new.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../src/registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { YUANBAO_DOMAIN, YUANBAO_URL, IS_VISIBLE_JS, authRequired, ensureYuanbaoPage, hasLoginGate } from './shared.js';
 async function getCurrentUrl(page) {
     const result = await page.evaluate('window.location.href').catch(() => '');

package/dist/clis/yuanbao/new.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it, vi } from 'vitest';
-import { AuthRequiredError } from '../../src/errors.js';
+import { AuthRequiredError } from '@jackwener/opencli/errors';
 import { newCommand } from './new.js';
 function createNewPageMock(overrides = {}) {
     const currentUrl = overrides.currentUrl ?? 'https://yuanbao.tencent.com/';

package/dist/clis/yuanbao/shared.d.ts

@@ -1,5 +1,5 @@
-import type { IPage } from '../../src/types.js';
-import { AuthRequiredError } from '../../src/errors.js';
+import type { IPage } from '@jackwener/opencli/types';
+import { AuthRequiredError } from '@jackwener/opencli/errors';
 export declare const YUANBAO_DOMAIN = "yuanbao.tencent.com";
 export declare const YUANBAO_URL = "https://yuanbao.tencent.com/";
 /**

package/dist/clis/yuanbao/shared.js

@@ -1,4 +1,4 @@
-import { AuthRequiredError } from '../../src/errors.js';
+import { AuthRequiredError } from '@jackwener/opencli/errors';
 export const YUANBAO_DOMAIN = 'yuanbao.tencent.com';
 export const YUANBAO_URL = 'https://yuanbao.tencent.com/';
 const SESSION_HINT = 'Likely login/auth/challenge/session issue in the existing yuanbao.tencent.com browser session.';

package/dist/clis/zhihu/download.js

@@ -4,8 +4,8 @@
  * Usage:
  *   opencli zhihu download --url "https://zhuanlan.zhihu.com/p/xxx" --output ./zhihu
  */
-import { cli, Strategy } from '../../src/registry.js';
-import { downloadArticle } from '../../download/article-download.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { downloadArticle } from '@jackwener/opencli/download/article-download';
 cli({
     site: 'zhihu',
     name: 'download',

package/dist/clis/zhihu/question.js

@@ -1,5 +1,5 @@
-import { cli, Strategy } from '../../src/registry.js';
-import { AuthRequiredError, CliError } from '../../src/errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { AuthRequiredError, CliError } from '@jackwener/opencli/errors';
 function stripHtml(html) {
     return html
         .replace(/<[^>]+>/g, '')

package/dist/clis/zhihu/question.test.js

@@ -1,6 +1,6 @@
 import { describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '../../src/registry.js';
-import { AuthRequiredError, CliError } from '../../src/errors.js';
+import { getRegistry } from '@jackwener/opencli/registry';
+import { AuthRequiredError, CliError } from '@jackwener/opencli/errors';
 import './question.js';
 describe('zhihu question', () => {
     it('returns answers from the Zhihu API', async () => {

package/dist/clis/zsxq/dynamics.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../src/registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getTopicText, getTopicAuthor, getTopicUrl, } from './utils.js';
 cli({
     site: 'zsxq',

package/dist/clis/zsxq/groups.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../src/registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getGroupsFromResponse, } from './utils.js';
 cli({
     site: 'zsxq',

package/dist/clis/zsxq/search.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../src/registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { getActiveGroupId, ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getGroupsFromResponse, getTopicsFromResponse, toTopicRow, } from './utils.js';
 cli({
     site: 'zsxq',

package/dist/clis/zsxq/search.test.js

@@ -1,5 +1,5 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '../../src/registry.js';
+import { getRegistry } from '@jackwener/opencli/registry';
 import './search.js';
 describe('zsxq search command', () => {
     beforeEach(() => {

package/dist/clis/zsxq/topic.js

@@ -1,5 +1,5 @@
-import { cli, Strategy } from '../../src/registry.js';
-import { CliError } from '../../src/errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
 import { browserJsonRequest, ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getCommentsFromResponse, getTopicFromResponse, getTopicUrl, summarizeComments, toTopicRow, } from './utils.js';
 cli({
     site: 'zsxq',

package/dist/clis/zsxq/topic.test.js

@@ -1,5 +1,5 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '../../src/registry.js';
+import { getRegistry } from '@jackwener/opencli/registry';
 import './topic.js';
 describe('zsxq topic command', () => {
     beforeEach(() => {

package/dist/clis/zsxq/topics.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../src/registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { getActiveGroupId, ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getTopicsFromResponse, toTopicRow, } from './utils.js';
 cli({
     site: 'zsxq',

package/dist/clis/zsxq/topics.test.js

@@ -1,5 +1,5 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '../../src/registry.js';
+import { getRegistry } from '@jackwener/opencli/registry';
 import './topics.js';
 describe('zsxq topics command', () => {
     beforeEach(() => {

package/dist/clis/zsxq/utils.d.ts

@@ -1,4 +1,4 @@
-import type { IPage } from '../../src/types.js';
+import type { IPage } from '@jackwener/opencli/types';
 export interface ZsxqUser {
     user_id?: number;
     name?: string;

package/dist/clis/zsxq/utils.js

@@ -1,4 +1,4 @@
-import { ArgumentError, AuthRequiredError, CliError } from '../../src/errors.js';
+import { ArgumentError, AuthRequiredError, CliError } from '@jackwener/opencli/errors';
 const SITE_DOMAIN = 'wx.zsxq.com';
 const SITE_URL = 'https://wx.zsxq.com';
 function asRecord(value) {

package/dist/src/discovery.d.ts

@@ -14,12 +14,12 @@ export declare const USER_CLIS_DIR: string;
 /** Plugins directory: ~/.opencli/plugins/ */
 export declare const PLUGINS_DIR: string;
 /**
- * Create runtime shim files under ~/.opencli so user CLIs can keep
- * importing ../../registry(.js), ../../errors(.js), etc.
+ * Ensure ~/.opencli/node_modules/@jackwener/opencli symlink exists so that
+ * user CLIs in ~/.opencli/clis/ can `import { cli } from '@jackwener/opencli/registry'`.
  *
- * Adapters use relative imports like `../../registry.js` which, from
- * ~/.opencli/clis/<site>/<cmd>.js, resolve to ~/.opencli/registry.js.
- * We create shim files that re-export from the installed opencli runtime.
+ * This is the sole resolution mechanism — adapters use package exports
+ * (e.g. `@jackwener/opencli/registry`, `@jackwener/opencli/errors`) and
+ * Node.js resolves them through this symlink.
  */
 export declare function ensureUserCliCompatShims(baseDir?: string): Promise<void>;
 /**

package/dist/src/discovery.js

@@ -43,83 +43,32 @@ function findPackageRoot() {
     }
     return dir;
 }
-function resolveHostRuntimeModulePath(moduleName) {
-    const runtimeDir = path.dirname(fileURLToPath(import.meta.url));
-    for (const ext of ['.js', '.ts']) {
-        const candidate = path.join(runtimeDir, `${moduleName}${ext}`);
-        if (fs.existsSync(candidate))
-            return candidate;
-    }
-    return path.join(runtimeDir, `${moduleName}.js`);
-}
-async function writeCompatShimIfNeeded(filePath, content) {
-    try {
-        const existing = await fs.promises.readFile(filePath, 'utf-8');
-        if (existing === content)
-            return;
-    }
-    catch {
-        // Fall through to write missing shim
-    }
-    await fs.promises.writeFile(filePath, content, 'utf-8');
-}
 /**
- * Create runtime shim files under ~/.opencli so user CLIs can keep
- * importing ../../registry(.js), ../../errors(.js), etc.
+ * Ensure ~/.opencli/node_modules/@jackwener/opencli symlink exists so that
+ * user CLIs in ~/.opencli/clis/ can `import { cli } from '@jackwener/opencli/registry'`.
  *
- * Adapters use relative imports like `../../registry.js` which, from
- * ~/.opencli/clis/<site>/<cmd>.js, resolve to ~/.opencli/registry.js.
- * We create shim files that re-export from the installed opencli runtime.
+ * This is the sole resolution mechanism — adapters use package exports
+ * (e.g. `@jackwener/opencli/registry`, `@jackwener/opencli/errors`) and
+ * Node.js resolves them through this symlink.
  */
 export async function ensureUserCliCompatShims(baseDir = USER_OPENCLI_DIR) {
     await fs.promises.mkdir(baseDir, { recursive: true });
-    // Map of shim name → runtime module name (resolved via resolveHostRuntimeModulePath)
-    const rootShims = [
-        ['registry', 'registry-api'],
-        ['errors', 'errors'],
-        ['types', 'types'],
-        ['utils', 'utils'],
-        ['logger', 'logger'],
-        ['launcher', 'launcher'],
-    ];
-    // Subdirectory shims: [subdir, filename, runtime module path relative to src/]
-    const subdirShims = [
-        ['browser', 'cdp', 'browser/cdp'],
-        ['browser', 'page', 'browser/page'],
-        ['browser', 'utils', 'browser/utils'],
-        ['download', 'index', 'download/index'],
-        ['download', 'article-download', 'download/article-download'],
-        ['download', 'media-download', 'download/media-download'],
-        ['download', 'progress', 'download/progress'],
-        ['pipeline', 'index', 'pipeline/index'],
-    ];
-    const writes = [];
-    // Root-level shims (both with and without .js extension)
-    for (const [shimName, moduleName] of rootShims) {
-        const url = pathToFileURL(resolveHostRuntimeModulePath(moduleName)).href;
-        const content = `export * from '${url}';\n`;
-        writes.push(writeCompatShimIfNeeded(path.join(baseDir, shimName), content));
-        writes.push(writeCompatShimIfNeeded(path.join(baseDir, `${shimName}.js`), content));
+    // package.json for ESM resolution in ~/.opencli/
+    const pkgJsonPath = path.join(baseDir, 'package.json');
+    const pkgJsonContent = `${JSON.stringify({ name: 'opencli-user-runtime', private: true, type: 'module' }, null, 2)}\n`;
+    try {
+        const existing = await fs.promises.readFile(pkgJsonPath, 'utf-8');
+        if (existing !== pkgJsonContent)
+            await fs.promises.writeFile(pkgJsonPath, pkgJsonContent, 'utf-8');
     }
-    // Subdirectory shims
-    for (const [subdir, filename, runtimePath] of subdirShims) {
-        const dir = path.join(baseDir, subdir);
-        await fs.promises.mkdir(dir, { recursive: true });
-        const url = pathToFileURL(resolveHostRuntimeModulePath(runtimePath)).href;
-        const content = `export * from '${url}';\n`;
-        writes.push(writeCompatShimIfNeeded(path.join(dir, `${filename}.js`), content));
+    catch {
+        await fs.promises.writeFile(pkgJsonPath, pkgJsonContent, 'utf-8');
     }
-    // package.json for ESM resolution
-    writes.push(writeCompatShimIfNeeded(path.join(baseDir, 'package.json'), `${JSON.stringify({ name: 'opencli-user-runtime', private: true, type: 'module' }, null, 2)}\n`));
-    await Promise.all(writes);
-    // Create node_modules/@jackwener/opencli symlink so user TS CLIs can import
-    // from '@jackwener/opencli/registry' (the package export).
-    // This is needed because ~/.opencli/clis/ is outside opencli's node_modules tree.
+    // Create node_modules/@jackwener/opencli symlink pointing to the installed package root.
     const opencliRoot = findPackageRoot();
     const symlinkDir = path.join(baseDir, 'node_modules', '@jackwener');
     const symlinkPath = path.join(symlinkDir, 'opencli');
     try {
-        // Only recreate if symlink is missing or points to wrong target
         let needsUpdate = true;
         try {
             const existing = await fs.promises.readlink(symlinkPath);
@@ -129,15 +78,18 @@ export async function ensureUserCliCompatShims(baseDir = USER_OPENCLI_DIR) {
         catch { /* doesn't exist */ }
         if (needsUpdate) {
             await fs.promises.mkdir(symlinkDir, { recursive: true });
+            // Use rm instead of unlink — handles both symlinks and stale directories
             try {
-                await fs.promises.unlink(symlinkPath);
+                await fs.promises.rm(symlinkPath, { recursive: true, force: true });
             }
             catch { /* doesn't exist */ }
-            await fs.promises.symlink(opencliRoot, symlinkPath, 'dir');
+            // Use 'junction' on Windows — doesn't require admin/Developer Mode privileges
+            const symlinkType = process.platform === 'win32' ? 'junction' : 'dir';
+            await fs.promises.symlink(opencliRoot, symlinkPath, symlinkType);
         }
     }
-    catch {
-        // Non-fatal: npm-linked installs or permission issues may prevent this
+    catch (err) {
+        log.warn(`Could not create symlink at ${symlinkPath}: ${getErrorMessage(err)}`);
     }
 }
 const ADAPTER_MANIFEST_PATH = path.join(USER_OPENCLI_DIR, 'adapter-manifest.json');

package/dist/src/engine.test.js

@@ -71,7 +71,7 @@ cli({
             await fs.promises.rm(tempBuildRoot, { recursive: true, force: true });
         }
     });
-    it('loads legacy user TS CLI modules via compatibility shims', async () => {
+    it('loads user CLI modules via package exports symlink', async () => {
         const tempOpencliRoot = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'opencli-user-clis-'));
         const userClisDir = path.join(tempOpencliRoot, 'clis');
         const siteDir = path.join(userClisDir, 'legacy-site');
@@ -80,8 +80,8 @@ cli({
             await ensureUserCliCompatShims(tempOpencliRoot);
             await fs.promises.mkdir(siteDir, { recursive: true });
             await fs.promises.writeFile(commandPath, `
-import { cli, Strategy } from '../../registry';
-import { CommandExecutionError } from '../../errors';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CommandExecutionError } from '@jackwener/opencli/errors';
 
 cli({
   site: 'legacy-site',

package/dist/src/package-exports.test.d.ts

@@ -0,0 +1 @@
+export {};