@ttkit/daily-hot-api 0.0.0-stage → 0.1.0

package/dist/cli/commands/logs.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logsCommand = logsCommand;
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const errors_1 = require("../errors");
+const log_file_1 = require("../log-file");
+const output_1 = require("../output");
+const paths_1 = require("../paths");
+const FOLLOW_INTERVAL_MS = 500;
+async function logsCommand(options, context = {}) {
+    const cwd = context.cwd ?? process.cwd();
+    const env = context.env ?? process.env;
+    const homeDir = (0, paths_1.resolveHomeDir)({ home: options.home, cwd, env });
+    const paths = (0, paths_1.buildCliPaths)(homeDir);
+    if (!(0, fs_1.existsSync)(paths.logFile)) {
+        (0, output_1.fail)(`日志文件不存在: ${paths.logFile}`);
+        (0, output_1.fail)('前台模式的标准输出直接打印在启动终端，不会写入日志文件；请使用 daily-hot-api start -d 后台启动');
+        return errors_1.EXIT_CODES.error;
+    }
+    const content = (0, log_file_1.tailFile)(paths.logFile, options.lines);
+    if (content) {
+        process.stdout.write(content.endsWith('\n') ? content : `${content}\n`);
+    }
+    if (!options.follow) {
+        return errors_1.EXIT_CODES.ok;
+    }
+    (0, output_1.progress)(`正在跟踪日志: ${paths.logFile}（按 Ctrl+C 退出）`);
+    let position = (await (0, promises_1.stat)(paths.logFile)).size;
+    const timer = setInterval(() => {
+        try {
+            const chunk = (0, log_file_1.readLogChunk)(paths.logFile, position);
+            position = chunk.nextPosition;
+            if (chunk.text) {
+                process.stdout.write(chunk.text);
+            }
+        }
+        catch {
+        }
+    }, FOLLOW_INTERVAL_MS);
+    const stopFollowing = () => {
+        clearInterval(timer);
+    };
+    process.once('SIGINT', () => {
+        stopFollowing();
+        process.stdout.write('\n');
+        process.exit(0);
+    });
+    process.once('SIGTERM', () => {
+        stopFollowing();
+        process.exit(0);
+    });
+    return errors_1.EXIT_CODES.ok;
+}
+//# sourceMappingURL=logs.js.map

package/dist/cli/commands/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../src/cli/commands/logs.ts"],"names":[],"mappings":";;AAWA,kCAuDC;AAlED,2BAAgC;AAChC,0CAAmC;AAGnC,sCAAuC;AACvC,0CAAqD;AACrD,sCAA2C;AAC3C,oCAAyD;AAEzD,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAExB,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,UAAmC,EAAE;IAErC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,OAAO,GAAG,IAAA,sBAAc,EAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,IAAA,qBAAa,EAAC,OAAO,CAAC,CAAC;IAErC,IAAI,CAAC,IAAA,eAAU,EAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,IAAA,aAAI,EAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAClC,IAAA,aAAI,EACF,6DAA6D,CAC9D,CAAC;QACF,OAAO,mBAAU,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,mBAAQ,EAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,mBAAU,CAAC,EAAE,CAAC;IACvB,CAAC;IAED,IAAA,iBAAQ,EAAC,WAAW,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;IAClD,IAAI,QAAQ,GAAG,CAAC,MAAM,IAAA,eAAI,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAEhD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAA,uBAAY,EAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACpD,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC;YAC9B,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;QAET,CAAC;IACH,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAEvB,MAAM,aAAa,GAAG,GAAS,EAAE;QAC/B,aAAa,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;QAC1B,aAAa,EAAE,CAAC;QAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;QAC3B,aAAa,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,mBAAU,CAAC,EAAE,CAAC;AACvB,CAAC"}

package/dist/cli/commands/restart.d.ts

@@ -0,0 +1,3 @@
+import { type CliOptions } from '../args';
+import type { CommandContext } from '../context';
+export declare function restartCommand(options: CliOptions, context?: Partial<CommandContext>): Promise<number>;

package/dist/cli/commands/restart.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.restartCommand = restartCommand;
+const args_1 = require("../args");
+const errors_1 = require("../errors");
+const output_1 = require("../output");
+const paths_1 = require("../paths");
+const run_state_1 = require("../run-state");
+const start_1 = require("./start");
+const stop_1 = require("./stop");
+async function restartCommand(options, context = {}) {
+    const cwd = context.cwd ?? process.cwd();
+    const env = context.env ?? process.env;
+    const homeDir = (0, paths_1.resolveHomeDir)({ home: options.home, cwd, env });
+    const paths = (0, paths_1.buildCliPaths)(homeDir);
+    const existing = (0, run_state_1.readRunState)(paths.stateFile);
+    if (existing.state &&
+        (0, run_state_1.isProcessAlive)(existing.state.pid) &&
+        !(0, run_state_1.processLooksLikeService)(existing.state.pid, (0, paths_1.getPackageRoot)())) {
+        throw new errors_1.CliError(`运行状态文件记录的 PID ${existing.state.pid} 仍存活，但无法确认是 ${paths_1.APP_NAME} 进程。` +
+            `请先执行 ${paths_1.APP_NAME} stop --force 终止并清理状态文件，或手动删除 ${paths.stateFile}`);
+    }
+    const runningState = existing.state &&
+        (0, run_state_1.isProcessAlive)(existing.state.pid) &&
+        (0, run_state_1.processLooksLikeService)(existing.state.pid, (0, paths_1.getPackageRoot)())
+        ? existing.state
+        : null;
+    const mode = options.daemon
+        ? 'daemon'
+        : options.foreground
+            ? 'foreground'
+            : (runningState?.mode ?? 'foreground');
+    const port = options.port ?? runningState?.port;
+    const envFile = options.envFile ?? runningState?.envFile ?? undefined;
+    if (runningState) {
+        (0, output_1.info)(`正在重启热点服务（当前 PID ${runningState.pid}，端口 ${runningState.port}）...`);
+        await (0, stop_1.stopCommand)({ ...options, command: 'stop', json: false }, context);
+    }
+    else {
+        if (existing.state || existing.corrupt) {
+            (0, output_1.warn)('清理了过期运行状态');
+        }
+        (0, output_1.info)('热点服务未在运行，将直接启动');
+    }
+    const startOptions = {
+        ...options,
+        command: 'start',
+        commandExplicit: true,
+        help: false,
+        version: false,
+        json: false,
+        follow: false,
+        lines: args_1.DEFAULT_LOG_LINES,
+        daemon: mode === 'daemon',
+        foreground: false,
+        port,
+        envFile,
+        helpTarget: undefined,
+    };
+    return (0, start_1.startCommand)(startOptions, context);
+}
+//# sourceMappingURL=restart.js.map

package/dist/cli/commands/restart.js.map

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

package/dist/cli/commands/start.d.ts

@@ -0,0 +1,3 @@
+import type { CliOptions } from '../args';
+import type { CommandContext } from '../context';
+export declare function startCommand(options: CliOptions, context?: Partial<CommandContext>): Promise<number>;

package/dist/cli/commands/start.js

@@ -0,0 +1,280 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startCommand = startCommand;
+const config_1 = require("@nestjs/config");
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const env_1 = require("../env");
+const errors_1 = require("../errors");
+const health_1 = require("../health");
+const log_file_1 = require("../log-file");
+const output_1 = require("../output");
+const paths_1 = require("../paths");
+const run_state_1 = require("../run-state");
+async function startCommand(options, context = {}) {
+    const cwd = context.cwd ?? process.cwd();
+    const env = context.env ?? process.env;
+    const homeDir = (0, paths_1.resolveHomeDir)({ home: options.home, cwd, env });
+    const paths = (0, paths_1.buildCliPaths)(homeDir);
+    const envResolution = (0, paths_1.resolveEnvFile)({
+        cwd,
+        homeDir,
+        envFile: options.envFile,
+        env,
+    });
+    if (envResolution) {
+        (0, env_1.applyEnvFile)(envResolution.path, env);
+    }
+    const port = (0, env_1.resolvePort)(options.port, env);
+    env.PORT = String(port);
+    assertNoRunningInstance(paths);
+    if (await (0, run_state_1.isPortInUse)(port)) {
+        throw new errors_1.CliError(`端口 ${port} 已被其他进程占用，请使用 --port 指定其他端口，或先停止占用进程`);
+    }
+    const target = {
+        cwd,
+        env,
+        paths,
+        port,
+        envFile: envResolution?.path ?? null,
+    };
+    if (options.daemon) {
+        return startDaemon(target);
+    }
+    const daemonChild = env[paths_1.DAEMON_CHILD_ENV] === '1';
+    delete env[paths_1.DAEMON_CHILD_ENV];
+    return startForeground(target, daemonChild ? 'daemon' : 'foreground');
+}
+function ensureStateDir(homeDir) {
+    try {
+        (0, fs_1.mkdirSync)((0, path_1.join)(homeDir, 'logs'), { recursive: true });
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new errors_1.CliError(`无法创建状态目录 ${homeDir}: ${reason}。请检查 --home / DAILY_HOT_API_HOME 是否指向可写的目录`);
+    }
+}
+function assertNoRunningInstance(paths) {
+    const existing = (0, run_state_1.readRunState)(paths.stateFile);
+    if (existing.corrupt) {
+        (0, output_1.warn)(`运行状态文件损坏，已清理: ${paths.stateFile}`);
+        (0, run_state_1.clearRunState)(paths.stateFile);
+        return;
+    }
+    const state = existing.state;
+    if (!state) {
+        return;
+    }
+    if ((0, run_state_1.isProcessAlive)(state.pid)) {
+        if ((0, run_state_1.processLooksLikeService)(state.pid)) {
+            throw new errors_1.CliError(`热点服务已在运行（PID ${state.pid}，端口 ${state.port}）。如需重启请运行: ${paths_1.APP_NAME} restart`);
+        }
+        throw new errors_1.CliError(`运行状态文件记录的 PID ${state.pid} 仍存活，但无法确认是 ${paths_1.APP_NAME} 进程。` +
+            `请先执行 ${paths_1.APP_NAME} stop --force 终止并清理状态文件，或手动删除 ${paths.stateFile}`);
+    }
+    (0, output_1.warn)(`清理过期运行状态（PID ${state.pid} 已退出）`);
+    (0, run_state_1.clearRunState)(paths.stateFile, state.pid);
+}
+async function startForeground(target, mode) {
+    (0, output_1.info)(`正在启动 ${paths_1.APP_NAME}（${mode === 'daemon' ? '后台' : '前台'}模式）...`);
+    (0, output_1.info)(`端口: ${target.port}`);
+    if (target.envFile) {
+        (0, output_1.info)(`配置文件: ${target.envFile}`);
+    }
+    (0, output_1.info)(`状态目录: ${target.paths.homeDir}`);
+    const state = {
+        pid: process.pid,
+        port: target.port,
+        mode,
+        startedAt: new Date().toISOString(),
+        cwd: target.cwd,
+        envFile: target.envFile,
+        logFile: mode === 'daemon' ? target.paths.logFile : null,
+        version: (0, paths_1.getPackageVersion)(),
+        entry: (0, paths_1.getBinPath)(),
+    };
+    try {
+        (0, run_state_1.writeRunState)(target.paths.stateFile, state);
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new errors_1.CliError(`无法写入运行状态文件（状态目录不可用）: ${reason}。请检查 --home / DAILY_HOT_API_HOME 是否指向可写的目录`);
+    }
+    const clearStateFile = () => {
+        try {
+            (0, run_state_1.clearRunState)(target.paths.stateFile, process.pid);
+        }
+        catch {
+        }
+    };
+    process.once('exit', clearStateFile);
+    process.once('SIGINT', clearStateFile);
+    process.once('SIGTERM', clearStateFile);
+    process.once('SIGHUP', clearStateFile);
+    const { bootstrap } = await Promise.resolve().then(() => __importStar(require('../../main')));
+    let app;
+    try {
+        app = await bootstrap();
+    }
+    catch (error) {
+        clearStateFile();
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new errors_1.CliError(`服务启动失败: ${reason}`);
+    }
+    const config = app.get(config_1.ConfigService);
+    const actualPort = config.getOrThrow('PORT');
+    if (actualPort !== state.port) {
+        state.port = actualPort;
+        try {
+            (0, run_state_1.writeRunState)(target.paths.stateFile, state);
+        }
+        catch {
+        }
+    }
+    (0, output_1.info)(`热点服务已启动: http://localhost:${actualPort}`);
+    if (mode === 'daemon') {
+        (0, output_1.info)(`PID: ${process.pid}`);
+        (0, output_1.info)(`日志: ${target.paths.logFile}`);
+    }
+    else {
+        (0, output_1.info)(`PID: ${process.pid}，按 Ctrl+C 停止服务`);
+    }
+    return errors_1.EXIT_CODES.ok;
+}
+async function startDaemon(target) {
+    ensureStateDir(target.paths.homeDir);
+    let logFd;
+    try {
+        logFd = (0, fs_1.openSync)(target.paths.logFile, 'a');
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new errors_1.CliError(`无法写入日志文件 ${target.paths.logFile}: ${reason}。请检查状态目录是否可写`);
+    }
+    const startedAt = new Date().toISOString();
+    (0, fs_1.writeSync)(logFd, `\n[${startedAt}] ${paths_1.APP_NAME} background start (port=${target.port}${target.envFile ? `, env_file=${target.envFile}` : ''})\n`);
+    const childArgs = [(0, paths_1.getBinPath)(), 'start', '--home', target.paths.homeDir];
+    if (target.envFile) {
+        childArgs.push('--config', target.envFile);
+    }
+    const childEnv = {
+        ...target.env,
+        PORT: String(target.port),
+        [paths_1.DAEMON_CHILD_ENV]: '1',
+    };
+    let child;
+    try {
+        child = (0, child_process_1.spawn)(process.execPath, childArgs, {
+            cwd: target.cwd,
+            detached: true,
+            stdio: ['ignore', logFd, logFd],
+            env: childEnv,
+            windowsHide: true,
+        });
+    }
+    catch (error) {
+        (0, fs_1.closeSync)(logFd);
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new errors_1.CliError(`后台进程创建失败: ${reason}`);
+    }
+    (0, fs_1.closeSync)(logFd);
+    child.unref();
+    const childPid = child.pid;
+    if (!childPid) {
+        throw new errors_1.CliError('后台进程创建失败: 未返回进程 PID');
+    }
+    (0, output_1.info)(`正在后台启动 ${paths_1.APP_NAME}（PID ${childPid}）...`);
+    const ready = await waitForDaemonReady(childPid, child, target.port, target.paths.stateFile);
+    if (!ready.ok) {
+        await terminateFailedChild(childPid, target.paths.stateFile);
+        const reason = ready.reason === 'timeout'
+            ? `等待服务就绪超时（${Math.round(paths_1.START_TIMEOUT_MS / 1000)} 秒）`
+            : `后台进程提前退出（退出码 ${ready.exitCode ?? 'unknown'}）`;
+        const logTail = safeTailLog(target.paths.logFile, 30);
+        throw new errors_1.CliError([
+            `后台启动失败: ${reason}`,
+            `日志: ${target.paths.logFile}`,
+            logTail ? `最近日志:\n${logTail}` : '',
+        ]
+            .filter(Boolean)
+            .join('\n'));
+    }
+    (0, output_1.info)(`热点服务已在后台启动: http://localhost:${target.port}`);
+    (0, output_1.field)('PID', childPid);
+    (0, output_1.field)('日志', target.paths.logFile);
+    (0, output_1.info)(`停止: ${paths_1.APP_NAME} stop    状态: ${paths_1.APP_NAME} status    日志: ${paths_1.APP_NAME} logs -f`);
+    return errors_1.EXIT_CODES.ok;
+}
+async function waitForDaemonReady(pid, child, port, stateFile) {
+    const deadline = Date.now() + paths_1.START_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+        if (!(0, run_state_1.isProcessAlive)(pid) || child.exitCode !== null) {
+            return { ok: false, reason: 'exited', exitCode: child.exitCode };
+        }
+        const { state } = (0, run_state_1.readRunState)(stateFile);
+        if (state?.pid === pid && (await (0, health_1.checkHealth)(port))) {
+            return { ok: true };
+        }
+        await (0, run_state_1.sleep)(paths_1.START_POLL_INTERVAL_MS);
+    }
+    return { ok: false, reason: 'timeout' };
+}
+async function terminateFailedChild(pid, stateFile) {
+    try {
+        process.kill(pid, 'SIGTERM');
+    }
+    catch {
+    }
+    if (!(await (0, run_state_1.waitForProcessExit)(pid, 3000))) {
+        try {
+            process.kill(pid, 'SIGKILL');
+        }
+        catch {
+        }
+        await (0, run_state_1.waitForProcessExit)(pid, 2000);
+    }
+    (0, run_state_1.clearRunState)(stateFile, pid);
+}
+function safeTailLog(logFile, lines) {
+    try {
+        return (0, log_file_1.tailFile)(logFile, lines);
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=start.js.map

package/dist/cli/commands/start.js.map

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

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

@@ -0,0 +1,3 @@
+import type { CliOptions } from '../args';
+import type { CommandContext } from '../context';
+export declare function statusCommand(options: CliOptions, context?: Partial<CommandContext>): Promise<number>;

package/dist/cli/commands/status.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statusCommand = statusCommand;
+const errors_1 = require("../errors");
+const health_1 = require("../health");
+const output_1 = require("../output");
+const paths_1 = require("../paths");
+const run_state_1 = require("../run-state");
+async function statusCommand(options, context = {}) {
+    const cwd = context.cwd ?? process.cwd();
+    const env = context.env ?? process.env;
+    const homeDir = (0, paths_1.resolveHomeDir)({ home: options.home, cwd, env });
+    const paths = (0, paths_1.buildCliPaths)(homeDir);
+    const existing = (0, run_state_1.readRunState)(paths.stateFile);
+    if (existing.corrupt) {
+        (0, run_state_1.clearRunState)(paths.stateFile);
+        return reportNotRunning(options.json, '运行状态文件损坏，已清理', paths);
+    }
+    const state = existing.state;
+    if (!state) {
+        return reportNotRunning(options.json, '未找到运行状态', paths);
+    }
+    if (!(0, run_state_1.isProcessAlive)(state.pid)) {
+        (0, run_state_1.clearRunState)(paths.stateFile, state.pid);
+        return reportNotRunning(options.json, `PID ${state.pid} 已退出，已清理过期状态文件`, paths);
+    }
+    if (!(0, run_state_1.processLooksLikeService)(state.pid, (0, paths_1.getPackageRoot)())) {
+        return reportNotRunning(options.json, `PID ${state.pid} 仍存活但无法确认是 daily-hot-api 进程，状态文件可能已过期；可执行 daily-hot-api stop --force 清理`, paths);
+    }
+    const health = await (0, health_1.checkHealth)(state.port);
+    const startedAtMs = Date.parse(state.startedAt);
+    const uptimeSeconds = Number.isFinite(startedAtMs)
+        ? Math.max(0, Math.floor((Date.now() - startedAtMs) / 1000))
+        : 0;
+    const url = `http://localhost:${state.port}`;
+    if (options.json) {
+        console.log(JSON.stringify({
+            running: true,
+            pid: state.pid,
+            port: state.port,
+            url,
+            mode: state.mode,
+            startedAt: state.startedAt,
+            uptimeSeconds,
+            health,
+            cwd: state.cwd,
+            envFile: state.envFile,
+            logFile: state.logFile,
+            version: state.version,
+        }, null, 2));
+        return errors_1.EXIT_CODES.ok;
+    }
+    (0, output_1.info)('热点服务运行中');
+    (0, output_1.field)('PID', state.pid);
+    (0, output_1.field)('端口', state.port);
+    (0, output_1.field)('地址', url);
+    (0, output_1.field)('模式', state.mode === 'daemon' ? '后台 (daemon)' : '前台 (foreground)');
+    (0, output_1.field)('启动时间', `${state.startedAt}（已运行 ${(0, output_1.formatDuration)(uptimeSeconds)}）`);
+    (0, output_1.field)('健康检查', health ? 'ok' : '无响应（进程存在但 /health 不可达）');
+    if (state.envFile) {
+        (0, output_1.field)('配置文件', state.envFile);
+    }
+    (0, output_1.field)('运行目录', state.cwd || 'unknown');
+    if (state.logFile) {
+        (0, output_1.field)('日志文件', state.logFile);
+    }
+    return errors_1.EXIT_CODES.ok;
+}
+function reportNotRunning(json, reason, paths) {
+    if (json) {
+        console.log(JSON.stringify({ running: false, reason, stateFile: paths.stateFile }));
+    }
+    else {
+        (0, output_1.info)(`热点服务未在运行（${reason}）`);
+    }
+    return errors_1.EXIT_CODES.notRunning;
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

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

package/dist/cli/commands/stop.d.ts

@@ -0,0 +1,12 @@
+import type { CliOptions } from '../args';
+import type { CommandContext } from '../context';
+export interface StopOutcome {
+    stopped: boolean;
+    stale: boolean;
+    forced: boolean;
+    pid?: number;
+    port?: number;
+    message: string;
+}
+export declare function stopCommand(options: CliOptions, context?: Partial<CommandContext>): Promise<number>;
+export declare function stopService(options: CliOptions, context?: Partial<CommandContext>): Promise<StopOutcome>;