@dsh-enhanced/dsh-rsi-cli 0.1.48

package/lib/services.js

@@ -0,0 +1,339 @@
+import { readFile, rm, stat } from 'node:fs/promises';
+import { open } from 'node:fs/promises';
+import { join } from 'node:path';
+import { defaultRunner } from "./run.js";
+import { launchAgentTargets, listProfiles, profileLogPaths, systemdUnitName, systemdUserDirectory, SYSTEMD_UNIT_PATTERN, } from "./paths.js";
+/** 受管 unit / plist 的内容指纹（lifecycle-profile.mjs rendererUnitPattern 与 launchd.ts createLaunchAgent）。 */
+const MANAGED_UNIT_MARKER = 'DeepSeek Harness profile';
+/** 判定一个 systemd unit 文件确为 dsh-enhanced 安装器渲染的受管 unit（lifecycle-profile.mjs rendererUnitPattern）。 */
+async function isManagedUnitFile(path, profile) {
+    let source;
+    try {
+        source = await readFile(path, 'utf8');
+    }
+    catch {
+        return false;
+    }
+    return source.includes(MANAGED_UNIT_MARKER)
+        && source.includes(`--profile ${profile} `)
+        && source.includes('--no-open');
+}
+/**
+ * 判定 macOS plist 确为受管 LaunchAgent。
+ *
+ * launchd.ts 的 createLaunchAgent 不写入任何注释标记，所以判定依据是它实际渲染
+ * 的结构：Label 必须是受管前缀加该 profile，且 ProgramArguments 含
+ * `--profile <profile>` 与 `--no-open` 两项。这与 stopManagedService 对 systemd
+ * unit 的判定同样严格，避免把同名的用户自建 LaunchAgent 当成受管服务操作。
+ */
+async function isManagedPlistFile(path, profile) {
+    let source;
+    try {
+        source = await readFile(path, 'utf8');
+    }
+    catch {
+        return false;
+    }
+    const { label } = launchAgentTargets('', profile);
+    return source.includes(`<string>${label}</string>`)
+        && source.includes('<string>--profile</string>')
+        && source.includes(`<string>${profile}</string>`)
+        && source.includes('<string>--no-open</string>');
+}
+/**
+ * 停用并注销一个 profile 的受管常驻服务。
+ * macOS：launchctl bootout + 删 ~/Library/LaunchAgents/<label>.plist。
+ * Linux：systemctl --user disable --now + reset-failed + 删受管 unit（及同名 .d）+ daemon-reload。
+ * 服务未注册/已停止不报错；任何非预期文件归属问题 fail-closed 只报告不删除。
+ */
+export async function stopManagedService(platform, home, profile, runner, dryRun) {
+    const outcome = { profile, actions: [], skipped: [], errors: [] };
+    if (platform === 'darwin') {
+        const { label, plistPath } = launchAgentTargets(home, profile);
+        const target = `gui/${process.getuid?.() ?? process.env.UID}/${label}`;
+        outcome.actions.push(`launchctl bootout ${target}（未注册时忽略错误）`);
+        outcome.actions.push(`删除 ${plistPath}`);
+        if (dryRun)
+            return outcome;
+        // bootout 对未加载 label 返回非零（No such process），属预期。
+        runner('launchctl', ['bootout', target]);
+        await rm(plistPath, { force: true });
+        return outcome;
+    }
+    const unit = systemdUnitName(profile);
+    if (!SYSTEMD_UNIT_PATTERN.test(unit)) {
+        outcome.errors.push(`非法 profile 名，跳过服务注销：${profile}`);
+        return outcome;
+    }
+    const unitDirectory = systemdUserDirectory(home);
+    const fragmentPath = join(unitDirectory, unit);
+    const dropInPath = join(unitDirectory, `${unit}.d`);
+    let managed = false;
+    try {
+        await readFile(fragmentPath, 'utf8').then(source => {
+            managed = source.includes(MANAGED_UNIT_MARKER)
+                && source.includes(`--profile ${profile} `)
+                && source.includes('--no-open');
+        }, () => { managed = false; });
+    }
+    catch {
+        managed = false;
+    }
+    outcome.actions.push(`systemctl --user disable --now ${unit}（未注册时忽略错误）`);
+    outcome.actions.push(`systemctl --user reset-failed ${unit}`);
+    if (!managed) {
+        // 文件名虽匹配，但内容不是受管 unit（可能不存在或被人手工改写）：不删文件。
+        const checked = await isManagedUnitFile(fragmentPath, profile);
+        if (!checked)
+            outcome.skipped.push(`${fragmentPath}（内容非受管 unit 或不存在，保留）`);
+    }
+    else {
+        outcome.actions.push(`删除受管 unit 文件 ${fragmentPath}`);
+    }
+    if (!dryRun) {
+        runner('systemctl', ['--user', 'disable', '--now', unit]);
+        runner('systemctl', ['--user', 'reset-failed', unit]);
+        if (managed) {
+            await rm(fragmentPath, { force: true });
+            await rm(dropInPath, { recursive: true, force: true });
+        }
+        runner('systemctl', ['--user', 'daemon-reload']);
+    }
+    outcome.actions.push('systemctl --user daemon-reload');
+    return outcome;
+}
+const ACTION_LABEL = {
+    start: '启动',
+    stop: '停止',
+    restart: '重启',
+};
+/**
+ * 结论措辞：dry-run 只是计划，必须说「将…」，只有真正执行过才说「已…」。
+ * 全部结论行都经由此函数，避免某个分支把计划报告成既成事实。
+ */
+function actionResult(profile, action, dryRun, suffix = '') {
+    return `${profile}：${dryRun ? '将' : '已'}${ACTION_LABEL[action]}${suffix}`;
+}
+/**
+ * Return only the exact MainPID owned by an installer-managed Linux user unit.
+ * Other processes with the same --profile remain external and must block lifecycle work.
+ */
+export async function managedServiceProcessIds(platform, home, profiles, runner = defaultRunner) {
+    const pids = [];
+    const errors = [];
+    if (platform !== 'linux')
+        return { pids, errors };
+    for (const profile of profiles) {
+        const presence = await inspectManagedService(platform, home, profile);
+        if (!presence.managed)
+            continue;
+        const unit = systemdUnitName(profile);
+        const result = runner('systemctl', ['--user', 'show', unit, '--property', 'MainPID', '--value']);
+        if (result.status !== 0) {
+            errors.push(`${profile}：无法读取受管服务 MainPID：${result.stderr.trim() || `systemctl 退出码 ${result.status}`}`);
+            continue;
+        }
+        const pid = Number(result.stdout.trim());
+        if (Number.isSafeInteger(pid) && pid > 0)
+            pids.push(pid);
+    }
+    return { pids: [...new Set(pids)], errors };
+}
+/**
+ * 检查一个 profile 的受管服务定义是否就绪。
+ * 只读文件系统，不执行 systemctl / launchctl。
+ */
+export async function inspectManagedService(platform, home, profile) {
+    if (platform === 'darwin') {
+        const { plistPath } = launchAgentTargets(home, profile);
+        const managed = await isManagedPlistFile(plistPath, profile);
+        let exists = true;
+        try {
+            await stat(plistPath);
+        }
+        catch {
+            exists = false;
+        }
+        return { managed, definitionPath: plistPath, foreign: exists && !managed };
+    }
+    const unit = systemdUnitName(profile);
+    const definitionPath = join(systemdUserDirectory(home), unit);
+    const managed = await isManagedUnitFile(definitionPath, profile);
+    let exists = true;
+    try {
+        await stat(definitionPath);
+    }
+    catch {
+        exists = false;
+    }
+    return { managed, definitionPath, foreign: exists && !managed };
+}
+/**
+ * 对一个已注册的受管服务执行 start / stop / restart。
+ *
+ * 前置条件是服务定义文件已存在且确属受管：这个命令只切换运行状态，不承担安装
+ * 职责，未注册时返回可复制的 dsh-rsi install 指引而不是隐式注册一个
+ * 服务——隐式注册会绕过安装器的归属、路径与凭据校验。
+ *
+ * macOS 用 `launchctl kickstart -k`（重启）/ `kickstart`（启动）/ `bootout`（停止）；
+ * 停止后 plist 仍在，所以随后可以再 start，这与 purge 的 bootout+删文件不同。
+ * Linux 直接用 `systemctl --user start|stop|restart`。
+ */
+export async function controlManagedService(platform, home, profile, action, runner = defaultRunner, dryRun = false) {
+    const outcome = { profile, actions: [], messages: [], errors: [] };
+    const label = ACTION_LABEL[action];
+    if (platform !== 'darwin' && platform !== 'linux') {
+        outcome.errors.push(`${profile}：当前平台 ${platform} 没有受管常驻服务（仅 macOS launchd 与 Linux systemd --user）`);
+        return outcome;
+    }
+    const presence = await inspectManagedService(platform, home, profile);
+    if (!presence.managed) {
+        outcome.errors.push(presence.foreign
+            ? `${profile}：${presence.definitionPath} 存在但不是 dsh-enhanced 受管服务，已拒绝操作（请人工确认该文件归属）`
+            : `${profile}：尚未安装常驻服务（${presence.definitionPath} 不存在）。core/web 场景默认只提供按需启动的 Web/direct 能力，这是正常状态；如需 start/restart，请安装常驻场景：\n`
+                + `  dsh-rsi install --profile ${profile} --scenario lark\n`
+                + `或安装分级自治成长：\n`
+                + `  dsh-rsi install --profile ${profile} --scenario supervised\n`
+                + '安装完成前无需反复执行 start/restart。');
+        return outcome;
+    }
+    if (platform === 'darwin') {
+        const { label: agentLabel, plistPath } = launchAgentTargets(home, profile);
+        const domain = `gui/${process.getuid?.() ?? process.env.UID}`;
+        const target = `${domain}/${agentLabel}`;
+        if (action === 'stop') {
+            outcome.actions.push(`launchctl bootout ${target}`);
+            if (!dryRun) {
+                const result = runner('launchctl', ['bootout', target]);
+                // 未加载时 bootout 返回非零（No such process），对 stop 语义等价于已停止。
+                if (result.status !== 0 && !/No such process|not find/iu.test(`${result.stderr}${result.stdout}`)) {
+                    outcome.errors.push(`${profile}：${label}失败：${result.stderr.trim() || `launchctl 退出码 ${result.status}`}`);
+                    return outcome;
+                }
+            }
+            outcome.messages.push(actionResult(profile, action, dryRun, `（plist 保留在 ${plistPath}，可再次 start）`));
+            return outcome;
+        }
+        // start / restart：plist 可能尚未 bootstrap（曾被 stop），先确保已载入再 kickstart。
+        outcome.actions.push(`launchctl bootstrap ${domain} ${plistPath}（已载入时忽略错误）`);
+        outcome.actions.push(`launchctl kickstart ${action === 'restart' ? '-k ' : ''}${target}`);
+        if (!dryRun) {
+            runner('launchctl', ['bootstrap', domain, plistPath]);
+            const kickstartArgs = action === 'restart' ? ['kickstart', '-k', target] : ['kickstart', target];
+            const result = runner('launchctl', kickstartArgs);
+            if (result.status !== 0) {
+                outcome.errors.push(`${profile}：${label}失败：${result.stderr.trim() || `launchctl 退出码 ${result.status}`}`);
+                return outcome;
+            }
+        }
+        outcome.messages.push(actionResult(profile, action, dryRun));
+        return outcome;
+    }
+    const unit = systemdUnitName(profile);
+    if (!SYSTEMD_UNIT_PATTERN.test(unit)) {
+        outcome.errors.push(`非法 profile 名，拒绝操作：${profile}`);
+        return outcome;
+    }
+    outcome.actions.push(`systemctl --user ${action} ${unit}`);
+    if (!dryRun) {
+        const result = runner('systemctl', ['--user', action, unit]);
+        if (result.status !== 0) {
+            outcome.errors.push(`${profile}：${label}失败：${result.stderr.trim() || `systemctl 退出码 ${result.status}`}`);
+            return outcome;
+        }
+    }
+    outcome.messages.push(actionResult(profile, action, dryRun));
+    return outcome;
+}
+/**
+ * 解析运维命令的目标 profile 集合。
+ * 显式 --profile 优先；否则取 DSH home 下全部 profile。
+ */
+export async function resolveTargetProfiles(dshHome, profile) {
+    if (profile !== undefined)
+        return [profile];
+    return await listProfiles(dshHome);
+}
+/** 读取单个日志文件的末尾 N 行，只读末尾有界字节，避免把大日志整体载入内存。 */
+export async function tailLogFile(path, lines, maxBytes = 1024 * 1024) {
+    let metadata;
+    try {
+        metadata = await stat(path);
+    }
+    catch {
+        return { path, empty: true, lines: [], bytes: 0 };
+    }
+    if (!metadata.isFile() || metadata.size === 0) {
+        return { path, empty: true, lines: [], bytes: metadata.size };
+    }
+    const length = Math.min(metadata.size, maxBytes);
+    const buffer = Buffer.alloc(length);
+    const file = await open(path, 'r');
+    try {
+        await file.read(buffer, 0, length, metadata.size - length);
+    }
+    finally {
+        await file.close();
+    }
+    const text = buffer.toString('utf8');
+    // 从中间截断时首行可能是残行，丢弃它以免呈现半行内容。
+    const all = text.split('\n');
+    if (length < metadata.size && all.length > 1)
+        all.shift();
+    const trimmed = all[all.length - 1] === '' ? all.slice(0, -1) : all;
+    return {
+        path,
+        empty: trimmed.length === 0,
+        lines: trimmed.slice(-lines),
+        bytes: metadata.size,
+    };
+}
+/**
+ * 读取若干 profile 的受管 stdout/stderr 日志尾部。
+ * `errorOnly` 只取 *-host.error.log。
+ */
+export async function collectLogs(dshHome, profiles, lines, errorOnly) {
+    const collected = [];
+    for (const profile of profiles) {
+        const paths = profileLogPaths(dshHome, profile);
+        const selected = errorOnly ? paths.filter(path => path.endsWith('.error.log')) : paths;
+        const tails = [];
+        for (const path of selected)
+            tails.push(await tailLogFile(path, lines));
+        collected.push({ profile, tails });
+    }
+    return collected;
+}
+export function formatLogs(collected, lines) {
+    if (collected.length === 0)
+        return '日志：未找到任何 profile。';
+    const out = [];
+    for (const entry of collected) {
+        for (const tail of entry.tails) {
+            out.push(`==> ${tail.path}${tail.empty ? '（无内容）' : `（末 ${tail.lines.length} 行 / 共 ${tail.bytes} 字节）`}`);
+            for (const line of tail.lines)
+                out.push(line);
+            out.push('');
+        }
+    }
+    const body = out.join('\n').trimEnd();
+    return body.length > 0 ? body : `日志：无内容（已按末 ${lines} 行读取）。`;
+}
+export function formatServiceOutcomes(outcomes, action, dryRun) {
+    const lines = [];
+    if (dryRun)
+        lines.push(`【dry-run】以下是 ${ACTION_LABEL[action]} 将执行的动作，未做任何修改：`);
+    for (const outcome of outcomes) {
+        if (dryRun)
+            for (const item of outcome.actions)
+                lines.push(`  ${outcome.profile}: ${item}`);
+        for (const message of outcome.messages)
+            lines.push(message);
+        for (const error of outcome.errors)
+            lines.push(`! ${error}`);
+    }
+    if (lines.length === 0)
+        lines.push(`${ACTION_LABEL[action]}：没有匹配的 profile。`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=services.js.map

package/lib/services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.js","sourceRoot":"","sources":["../src/services.ts"],"names":[],"mappings":"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"}

package/lib/update.d.ts

@@ -0,0 +1,59 @@
+import { type CommandRunner } from './run.ts';
+/** 全局 dsh-rsi 自身的 npm 包名（新名）。 */
+export declare const RSI_CLI_PACKAGE = "@dsh-enhanced/dsh-rsi-cli";
+/**
+ * 历史包名。0.1.47 及更早版本以 `@dsh-enhanced/rsi-cli` 发布；该包已发布版本不可删除，
+ * 自升级时负责把旧全局安装迁移到新名，避免两个包同时提供 `dsh-rsi` bin 造成冲突。
+ */
+export declare const LEGACY_RSI_CLI_PACKAGE = "@dsh-enhanced/rsi-cli";
+/** 从真实 npm 全局包路径反推 prefix；两种包名后缀都识别，源码 checkout/测试环境回退 npm prefix -g。 */
+export declare function prefixFromPackageRoot(packageRoot: string): string | undefined;
+/**
+ * 判断当前进程实际由哪一个全局包加载。
+ * - `new`：新包 `@dsh-enhanced/dsh-rsi-cli`
+ * - `legacy`：旧包 `@dsh-enhanced/rsi-cli`（需要在本次 update 中迁移）
+ * - `unknown`：checkout / 临时目录运行（非全局安装），不做包名迁移。
+ */
+export declare function runtimePackageKind(packageRoot: string): 'new' | 'legacy' | 'unknown';
+export interface SelfUpdateReport {
+    /** 升级前当前进程所属的 dsh-rsi 版本。 */
+    fromVersion: string;
+    /** 请求的 selector（精确版本或 dist-tag），默认 latest。 */
+    selector: string;
+    /** npm 全局前缀，便于用户确认装到了哪里。 */
+    globalPrefix?: string;
+    /** registry 上 selector 解析出的精确版本；无法解析时为 undefined。 */
+    resolvedVersion?: string;
+    /** 实际安装成功的精确版本；供 update --all 选择同版本安装器 tag。 */
+    installedVersion?: string;
+    /** 已是目标版本、未执行安装。 */
+    alreadyCurrent: boolean;
+    /**
+     * 本次是否发生了「旧包名 → 新包名」的全局迁移。
+     * 旧包 `@dsh-enhanced/rsi-cli` 提供 `dsh-rsi` bin；新包安装成功后才卸载旧包。
+     */
+    migratedFrom: boolean;
+    /** 计划执行/已执行的命令描述。 */
+    actions: string[];
+}
+/**
+ * 升级全局 dsh-rsi 自身。
+ *
+ * 只做一件事：把 `@dsh-enhanced/dsh-rsi-cli@<selector>` 安装到全局；
+ * 若当前进程仍由旧包 `@dsh-enhanced/rsi-cli` 加载，则在新包安装成功后卸载旧包，
+ * 避免两个包同时提供 `dsh-rsi` bin。刻意不在同一次调用里「装完新版再用新代码继续干活」
+ * ——当前进程已把旧版代码载入内存，替换包不会改变它，混用两个版本的行为只会带来难以复现的问题。
+ * 因此本函数执行完就返回，由用户在下一次调用中使用新版本。
+ *
+ * 升级插件集合（cohort）不走这里：那属于安装器的 `--operation upgrade`，
+ * 由 `update --all` 薄委托过去，本模块不复制任何 cohort 升级逻辑。
+ */
+export declare function runSelfUpdate(options: {
+    selector?: string;
+    dryRun?: boolean;
+    runner?: CommandRunner;
+    /** 测试注入；生产默认使用当前已加载 npm 包根目录。 */
+    packageRoot?: string;
+}): Promise<SelfUpdateReport>;
+export declare function formatSelfUpdateReport(report: SelfUpdateReport, dryRun: boolean): string;
+//# sourceMappingURL=update.d.ts.map

package/lib/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,UAAU,CAAA;AAG5D,iCAAiC;AACjC,eAAO,MAAM,eAAe,8BAA8B,CAAA;AAC1D;;;GAGG;AACH,eAAO,MAAM,sBAAsB,0BAA0B,CAAA;AAe7D,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM7E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAKpF;AAED,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,oBAAoB;IACpB,cAAc,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAA;IACrB,qBAAqB;IACrB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoF5B;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAqBxF"}

package/lib/update.js

@@ -0,0 +1,160 @@
+import { dirname, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { PurgeError } from "./purge.js";
+import { defaultRunner } from "./run.js";
+import { version as VERSION } from "./version.js";
+/** 全局 dsh-rsi 自身的 npm 包名（新名）。 */
+export const RSI_CLI_PACKAGE = '@dsh-enhanced/dsh-rsi-cli';
+/**
+ * 历史包名。0.1.47 及更早版本以 `@dsh-enhanced/rsi-cli` 发布；该包已发布版本不可删除，
+ * 自升级时负责把旧全局安装迁移到新名，避免两个包同时提供 `dsh-rsi` bin 造成冲突。
+ */
+export const LEGACY_RSI_CLI_PACKAGE = '@dsh-enhanced/rsi-cli';
+/** 精确版本或 dist-tag：只接受 x.y.z、带预发布后缀的 x.y.z-tag.n，或纯字母 dist-tag。 */
+const SELECTOR_PATTERN = /^(?:\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?|[A-Za-z][A-Za-z0-9-]{0,63})$/u;
+const runtimePackageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+/**
+ * 全局包在两种历史/现行布局下的路径后缀：
+ *   <prefix>/lib/node_modules/@dsh-enhanced/dsh-rsi-cli   （新）
+ *   <prefix>/lib/node_modules/@dsh-enhanced/rsi-cli       （旧，迁移期识别）
+ */
+const GLOBAL_PACKAGE_SUFFIXES = [
+    `${sep}lib${sep}node_modules${sep}@dsh-enhanced${sep}dsh-rsi-cli`,
+    `${sep}lib${sep}node_modules${sep}@dsh-enhanced${sep}rsi-cli`,
+];
+/** 从真实 npm 全局包路径反推 prefix；两种包名后缀都识别，源码 checkout/测试环境回退 npm prefix -g。 */
+export function prefixFromPackageRoot(packageRoot) {
+    const normalized = resolve(packageRoot);
+    for (const suffix of GLOBAL_PACKAGE_SUFFIXES) {
+        if (normalized.endsWith(suffix))
+            return normalized.slice(0, -suffix.length);
+    }
+    return undefined;
+}
+/**
+ * 判断当前进程实际由哪一个全局包加载。
+ * - `new`：新包 `@dsh-enhanced/dsh-rsi-cli`
+ * - `legacy`：旧包 `@dsh-enhanced/rsi-cli`（需要在本次 update 中迁移）
+ * - `unknown`：checkout / 临时目录运行（非全局安装），不做包名迁移。
+ */
+export function runtimePackageKind(packageRoot) {
+    const normalized = resolve(packageRoot);
+    if (normalized.endsWith(GLOBAL_PACKAGE_SUFFIXES[0]))
+        return 'new';
+    if (normalized.endsWith(GLOBAL_PACKAGE_SUFFIXES[1]))
+        return 'legacy';
+    return 'unknown';
+}
+/**
+ * 升级全局 dsh-rsi 自身。
+ *
+ * 只做一件事：把 `@dsh-enhanced/dsh-rsi-cli@<selector>` 安装到全局；
+ * 若当前进程仍由旧包 `@dsh-enhanced/rsi-cli` 加载，则在新包安装成功后卸载旧包，
+ * 避免两个包同时提供 `dsh-rsi` bin。刻意不在同一次调用里「装完新版再用新代码继续干活」
+ * ——当前进程已把旧版代码载入内存，替换包不会改变它，混用两个版本的行为只会带来难以复现的问题。
+ * 因此本函数执行完就返回，由用户在下一次调用中使用新版本。
+ *
+ * 升级插件集合（cohort）不走这里：那属于安装器的 `--operation upgrade`，
+ * 由 `update --all` 薄委托过去，本模块不复制任何 cohort 升级逻辑。
+ */
+export async function runSelfUpdate(options) {
+    const runner = options.runner ?? defaultRunner;
+    const selector = options.selector ?? 'latest';
+    if (!SELECTOR_PATTERN.test(selector)) {
+        throw new PurgeError(`非法的版本 selector：${selector}（应为精确版本 x.y.z 或 dist-tag）`);
+    }
+    const packageRoot = options.packageRoot ?? runtimePackageRoot;
+    const report = {
+        fromVersion: VERSION,
+        selector,
+        alreadyCurrent: false,
+        migratedFrom: false,
+        actions: [],
+    };
+    const ownedPrefix = prefixFromPackageRoot(packageRoot);
+    if (ownedPrefix !== undefined) {
+        report.globalPrefix = ownedPrefix;
+    }
+    else {
+        const prefix = runner('npm', ['prefix', '-g']);
+        const prefixValue = prefix.stdout.trim();
+        if (prefixValue.length > 0)
+            report.globalPrefix = prefixValue;
+    }
+    // 先把 selector 解析成精确版本，这样「已是最新」可以直接跳过安装，
+    // 而且用户能在 dry-run 下看到将要装的确切版本而不只是一个 tag。
+    // 永远查询新包名：旧包 registry 上已停更，迁移必须落到新包。
+    const view = runner('npm', ['view', `${RSI_CLI_PACKAGE}@${selector}`, 'version', '--location=global']);
+    if (view.status === 0) {
+        // npm view 对 dist-tag 返回单行版本；对范围可能返回多行，取最后一行（最高版本）。
+        const lines = view.stdout.trim().split('\n').map(line => line.trim()).filter(line => line.length > 0);
+        const last = lines.at(-1);
+        if (last !== undefined) {
+            // 多版本行形如 `@dsh-enhanced/dsh-rsi-cli@0.1.47 '0.1.47'`，取末尾引号内的值。
+            const matched = /(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)'?$/u.exec(last);
+            const captured = matched?.[1];
+            if (captured !== undefined)
+                report.resolvedVersion = captured;
+        }
+    }
+    const kind = runtimePackageKind(packageRoot);
+    report.migratedFrom = kind === 'legacy';
+    // 「已是最新」只在当前已是新包时成立；旧包即使版本号相同也必须迁移一次。
+    if (report.resolvedVersion !== undefined && report.resolvedVersion === VERSION && kind === 'new') {
+        report.alreadyCurrent = true;
+        report.installedVersion = report.resolvedVersion;
+        return report;
+    }
+    const target = `${RSI_CLI_PACKAGE}@${selector}`;
+    const prefixArgs = report.globalPrefix === undefined ? [] : ['--prefix', report.globalPrefix];
+    report.actions.push(`npm install --global${report.globalPrefix === undefined ? '' : ` --prefix ${report.globalPrefix}`} ${target}`);
+    if (report.migratedFrom) {
+        report.actions.push(`npm uninstall --global${report.globalPrefix === undefined ? '' : ` --prefix ${report.globalPrefix}`} ${LEGACY_RSI_CLI_PACKAGE}`);
+    }
+    if (options.dryRun === true)
+        return report;
+    const install = runner('npm', ['install', '--global', ...prefixArgs, target, '--location=global']);
+    if (install.status !== 0) {
+        const detail = install.stderr.trim() || install.stdout.trim() || `npm 退出码 ${install.status}`;
+        throw new PurgeError(`升级 dsh-rsi 失败（前缀 ${report.globalPrefix ?? '未知'}）：${detail}\n`
+            + `可手工执行：npm install --global ${target}`);
+    }
+    if (report.resolvedVersion !== undefined)
+        report.installedVersion = report.resolvedVersion;
+    // 新包安装成功后才卸载旧包；新包失败时上面已经抛出，旧包保持原样，bin 不冲突。
+    if (report.migratedFrom) {
+        const uninstall = runner('npm', ['uninstall', '--global', ...prefixArgs, LEGACY_RSI_CLI_PACKAGE, '--location=global']);
+        if (uninstall.status !== 0) {
+            const detail = uninstall.stderr.trim() || uninstall.stdout.trim() || `npm 退出码 ${uninstall.status}`;
+            throw new PurgeError(`dsh-rsi 已升级到新包名 ${RSI_CLI_PACKAGE}，但卸载旧包 ${LEGACY_RSI_CLI_PACKAGE} 失败：${detail}\n`
+                + `新包已可用；可手工执行：npm uninstall --global ${LEGACY_RSI_CLI_PACKAGE}`);
+        }
+    }
+    return report;
+}
+export function formatSelfUpdateReport(report, dryRun) {
+    const lines = [];
+    const resolved = report.resolvedVersion ?? '（无法从 registry 解析，仍按 selector 安装）';
+    if (report.alreadyCurrent) {
+        lines.push(`dsh-rsi 已是 ${report.fromVersion}，与 ${report.selector} 解析结果一致，无需升级。`);
+        if (report.globalPrefix !== undefined)
+            lines.push(`全局前缀：${report.globalPrefix}`);
+        return lines.join('\n');
+    }
+    lines.push(dryRun
+        ? `【dry-run】将升级 dsh-rsi：${report.fromVersion} → ${resolved}（selector ${report.selector}）`
+        : `dsh-rsi 已升级：${report.fromVersion} → ${resolved}（selector ${report.selector}）`);
+    if (report.globalPrefix !== undefined)
+        lines.push(`全局前缀：${report.globalPrefix}`);
+    if (report.migratedFrom) {
+        lines.push(`包名迁移：${LEGACY_RSI_CLI_PACKAGE} → ${RSI_CLI_PACKAGE}（bin 仍为 dsh-rsi；新包安装成功后才卸载旧包）`);
+    }
+    for (const action of report.actions)
+        lines.push(`  ${dryRun ? '将执行' : '已执行'}：${action}`);
+    if (!dryRun) {
+        // 当前进程仍在运行旧版代码，必须明确告知，避免用户以为本次输出已来自新版。
+        lines.push('新版本在下一次执行 dsh-rsi 时生效（当前进程仍运行升级前的代码）。');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=update.js.map

package/lib/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"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"}

package/lib/version.d.ts

@@ -0,0 +1,2 @@
+export declare const version = "0.1.48";
+//# sourceMappingURL=version.d.ts.map

package/lib/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAA"}

package/lib/version.js

@@ -0,0 +1,2 @@
+export const version = '0.1.48';
+//# sourceMappingURL=version.js.map

package/lib/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAA"}

package/lib/weburl.d.ts

@@ -0,0 +1,36 @@
+import type { CommandRunner } from './run.ts';
+/**
+ * Web URL：从运行中受管服务的 journal / host 日志中解析最新一次 `dsh web:` 行，
+ * 返回带 token 的完整授权 URL。绝不关闭或绕过 Web 认证——这里只是把 DSH 已经打印
+ * 在日志里的同一行 URL 取出来，免去用户翻 journal / 猜 token。
+ */
+/**
+ * 从一段文本中提取最新一次 `dsh web: http://host:PORT/?token=...` 完整 URL。
+ * DSH 每次启动都会打印这一行；取最后一个匹配是为了拿到最近一次重启后的 token
+ * （token 随重启变化）。没有匹配时返回 undefined。
+ *
+ * 纯函数、不读文件、不执行命令，便于单元测试覆盖正常 / 缺 token / 多行场景。
+ */
+export declare function extractWebUrlFromText(text: string): string | undefined;
+export interface ProfileWebUrl {
+    profile: string;
+    /** 解析到的最新完整授权 URL（含 token）；未找到时 undefined。 */
+    url?: string;
+    /** 来源描述：journal / host log 路径。 */
+    source?: string;
+    /** 服务未注册 / 未运行 / 日志中尚无 URL 等面向用户的提示（非错误）。 */
+    notice?: string;
+    errors: string[];
+}
+/**
+ * 解析一个 profile 受管服务当前有效的 Web 授权 URL。
+ *
+ * - Linux systemd --user：`journalctl --user -u dsh-profile-<profile>.service --output=cat -n N`
+ * - macOS launchd：读 `$DSH_HOME/logs/<profile>-host.log` 尾部
+ *
+ * 服务未注册时给出与 start/stop 一致的指引；服务未运行时明确提示先 start。
+ * 即使服务当前未运行，只要日志里还有历史 URL，也会返回并标注其可能已随重启失效。
+ */
+export declare function resolveManagedWebUrl(platform: NodeJS.Platform, home: string, dshHome: string, profile: string, runner?: CommandRunner): Promise<ProfileWebUrl>;
+export declare function formatWebUrlResult(entries: readonly ProfileWebUrl[]): string;
+//# sourceMappingURL=weburl.d.ts.map