/* cmd.c / cmd_exec.c / cmd_report.c 之间的内部接口。别处不许 include。 */
#ifndef CMD_PRIV_H
#define CMD_PRIV_H

#include "cmd.h"
#include "cmd_json.h"

/* 一条命令的上下文。 */
typedef struct {
    const cj_obj_t *o;
    cmd_link_t      link;
    cj_writer_t    *w;    /* 成功时的附加字段写这里（以逗号开头） */
    int             rail; /* 已校验过的路号；0 = 还没有 / 整板命令 */
    int64_t         bad;  /* 被拒时「越界的那个值」，进事件的 bus_mv */
} ctx_t;

/* 两份快照的位置（cmd_init 给的）。 */
const cmd_env_t *cmd_env(void);

/* cmd_exec.c：六条会动东西的命令 + 风扇下限。返回 CMD_OK 时可能往 c->w 写了附加字段；
   被拒时把越界的那个值留在 c->bad（进事件的 bus_mv）。 */
cmd_err_t do_set_voltage(ctx_t *c);
cmd_err_t do_power_cycle(ctx_t *c);
cmd_err_t do_key(ctx_t *c);
cmd_err_t do_edl(ctx_t *c);
cmd_err_t do_vbus(ctx_t *c);
cmd_err_t do_power(ctx_t *c);
cmd_err_t do_fan(ctx_t *c);

/* cmd_net.c：网络配置（只收 USB）与网络状态。 */
cmd_err_t do_wifi(ctx_t *c);
cmd_err_t do_mqtt(ctx_t *c);
cmd_err_t do_net(ctx_t *c);

/* cmd_net.c：OTA（C2，两条链路都收）。 */
cmd_err_t do_ota(ctx_t *c);

/* status 的正文（不含外层的 `{"seq":..,"ok":true` 与结尾 `}`，以逗号开头）。 */
void cmd_report_status(cj_writer_t *w, const cmd_env_t *env);

/* events 的正文。先把 RAM 里的事件落盘（`evlog_read()` 只服务已落盘的部分）。 */
void cmd_report_events(cj_writer_t *w, uint32_t from_seq);

#endif /* CMD_PRIV_H */