@xinhehuimeng/cli 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xinhehuimeng/cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "心河 OA 客户端 CLI（Node 版）：多维表格 / 应用 / 权限的唯一命令行入口",
   "keywords": [
     "xinhe-oa",

package/src/commands/report.js

@@ -11,19 +11,9 @@
 //
 // ## 为什么 `report rule --create` 会顺手开当期（服务端行为，CLI 只如实带出）
 //
-// 开窗原本只有服务端 `report_tick`（cron）能做，而部署面没有任何调度配置 ——
-// 症状是"规则建好了、命令全返回成功，但 `report --due` 永远为空、`--save/--submit`
-// 一律 `report.period_not_open`"，排障的人只会以为"日报功能是坏的"（docs/05 决策 74①）。
-// 服务端从 2026-10-15 起在 `POST /reports/rules` 之后调用 `_open_current_period`，
-// 于是响应多出一段 `period: {period_key, due_at, assignments_created, opened}`：
-//
-// - `period_key` 可以直接喂给 `report --save/--submit`，所以 CLI 把它写进 `next_step`，
-//   省掉"自己猜周期键"这一步；
-// - **只开当期、不补开历史**（`backfill_max=1`：刚建的规则补 30 期等于让全公司补写
-//   一个月前的工作日志），历史补开仍归 tick；
-// - `assignments_created=0` 是**要紧的信号**：说明 `fillers` 没展开出任何人
-//   （这条规则"谁都不该交"），十有八九是 `fillers` 写窄了。CLI **不额外造字段**
-//   去解释它（`--json` 的 `data` 形状必须与 Rust 版逐字一致），只保证原样带出。
+// 2026-10-28 起，当前周期由服务端按规则和日期实时计算，提交直接落
+// `report_instance`；`report_tick` 只负责可选提醒，不再阻断日报提交。
+// `--period` 仍保留给补交/历史查询，但日常 `--save/--submit/--stats` 可以省略。
 //
 // ## 为什么显式旗标要覆盖 `--from` 的同名字段
 //
@@ -240,14 +230,12 @@ async function reportDomain(args, runtime) {
   if (picked === '--save') {
     only(args, 'report --save', ['--rule', '--period', '--content']);
     requireRule(args, 'report --save');
-    requirePeriod(args, 'report --save');
     requireContent(args, 'report --save');
     return save(runtime, args);
   }
   if (picked === '--submit') {
     only(args, 'report --submit', ['--rule', '--period', '--content', '--cc']);
     requireRule(args, 'report --submit');
-    requirePeriod(args, 'report --submit');
     requireContent(args, 'report --submit');
     return submit(runtime, args);
   }
@@ -272,13 +260,11 @@ async function reportDomain(args, runtime) {
   if (picked === '--stats') {
     only(args, 'report --stats', ['--rule', '--period', '--dept', '--include-sub']);
     requireRule(args, 'report --stats');
-    requirePeriod(args, 'report --stats');
     return stats(runtime, args);
   }
   if (picked === '--remind') {
     only(args, 'report --remind', ['--rule', '--period']);
     requireRule(args, 'report --remind');
-    requirePeriod(args, 'report --remind');
     return remind(runtime, args);
   }
   if (picked === '--reopen') {
@@ -464,12 +450,12 @@ async function due(runtime, args) {
   runtime.finishFrom(response, dataOf(response));
 }
 
-/** `report --save --rule <r> --period <p> --content <json>`：存草稿。 */
+/** `report --save --rule <r> [--period <p>] --content <json>`：存草稿。 */
 async function save(runtime, args) {
   const rule = requireRule(args, 'report --save');
-  const period = requirePeriod(args, 'report --save');
+  const period = flagValue(args, '--period');
   const content = parseJsonFlag(requireContent(args, 'report --save'), '--content');
-  const path = `/reports/${rule}/${period}`;
+  const path = isBlank(period) ? `/reports/${rule}` : `/reports/${rule}/${trimmed(period)}`;
   const spec = requestSpec({
     body: sortKeysDeep({ content }),
     idempotencyKey: idempotencyKey('report-save'),
@@ -478,20 +464,24 @@ async function save(runtime, args) {
   const response = await runtime.sendAuthed('PUT', path, spec);
   const data = dataOf(response);
   if (isPlainObject(data)) {
-    data.next_step = `提交：xinhe-oa-cli report --submit --rule ${rule} --period ${period} --content <JSON>`;
+    data.next_step =
+      `提交：xinhe-oa-cli report --submit --rule ${rule} --content <JSON>` +
+      (isBlank(period) ? '' : `（复用历史期时加 --period ${trimmed(period)}）`);
   }
   runtime.finishFrom(response, data);
 }
 
-/** `report --submit --rule <r> --period <p> --content <json> [--cc <uids>]`：提交（幂等）。 */
+/** `report --submit --rule <r> [--period <p>] --content <json> [--cc <uids>]`：提交（幂等）。 */
 async function submit(runtime, args) {
   const rule = requireRule(args, 'report --submit');
-  const period = requirePeriod(args, 'report --submit');
+  const period = flagValue(args, '--period');
   const content = parseJsonFlag(requireContent(args, 'report --submit'), '--content');
   const body = { content };
   const cc = ccUserIds(args);
   if (cc.length > 0) body.cc = cc;
-  const path = `/reports/${rule}/${period}/submit`;
+  const path = isBlank(period)
+    ? `/reports/${rule}/submit`
+    : `/reports/${rule}/${trimmed(period)}/submit`;
   const spec = requestSpec({
     body: sortKeysDeep(body),
     // 幂等键必填：同周期重复提交返回首次结果，不产生第二份。
@@ -574,14 +564,12 @@ async function show(runtime, id, args) {
   runtime.finishFrom(response, data);
 }
 
-/** `report --stats --rule <r> --period <p> [--dept <d>] [--include-sub]`：应交 / 已交 / 未交。 */
+/** `report --stats --rule <r> [--period <p>] [--dept <d>] [--include-sub]`：应交 / 已交 / 未交。 */
 async function stats(runtime, args) {
   const rule = requireRule(args, 'report --stats');
-  const period = requirePeriod(args, 'report --stats');
-  const query = [
-    ['rule_id', rule],
-    ['period_key', period],
-  ];
+  const period = flagValue(args, '--period');
+  const query = [['rule_id', rule]];
+  if (!isBlank(period)) query.push(['period_key', trimmed(period)]);
   pushQuery(query, 'dept_id', flagValue(args, '--dept'));
   if (isGiven(args, '--include-sub')) query.push(['include_sub', 'true']);
   const spec = requestSpec({ query });
@@ -590,12 +578,14 @@ async function stats(runtime, args) {
   runtime.finishFrom(response, dataOf(response));
 }
 
-/** `report --remind --rule <r> --period <p>`：手动催交（**只发事件**）。 */
+/** `report --remind --rule <r> [--period <p>]`：手动催交（**只发事件**）。 */
 async function remind(runtime, args) {
   const rule = requireRule(args, 'report --remind');
-  const period = requirePeriod(args, 'report --remind');
+  const period = flagValue(args, '--period');
+  const body = { rule_id: rule };
+  if (!isBlank(period)) body.period_key = trimmed(period);
   const spec = requestSpec({
-    body: sortKeysDeep({ rule_id: rule, period_key: period }),
+    body: sortKeysDeep(body),
     idempotencyKey: idempotencyKey('report-remind'),
   });
   if (runtime.dryRun) return runtime.dryRunReport('POST', '/reports/remind', spec);