codeksei 0.1.0 → 0.1.1

package/src/app/reminder-write-cli.js

@@ -1,210 +1,215 @@
-const crypto = require("crypto");
-
-const { resolveSelectedAccount } = require("../adapters/channel/weixin/account-store");
-const { loadPersistedContextTokens } = require("../adapters/channel/weixin/context-token-store");
-const { ReminderQueueStore } = require("../adapters/channel/weixin/reminder-queue-store");
-const { SessionStore } = require("../adapters/runtime/codex/session-store");
-const { resolvePreferredSenderId } = require("../core/default-targets");
-
-const DELAY_UNIT_MS = {
-  s: 1_000,
-  m: 60_000,
-  h: 60 * 60_000,
-  d: 24 * 60 * 60_000,
-};
-const LOCAL_TIMEZONE_OFFSET = "+08:00";
-
-async function runReminderWriteCommand(config) {
-  const args = process.argv.slice(4);
-  const options = parseArgs(args);
-  const body = await resolveBody(options);
-  if (!body) {
-    throw new Error("提醒内容不能为空，传 --text 或通过 stdin 输入");
-  }
-
-  const dueAtMs = resolveDueAtMs(options);
-  if (!Number.isFinite(dueAtMs) || dueAtMs <= Date.now()) {
-    throw new Error("缺少有效时间，使用 --delay 30s|10m|1h30m|2d4h20m 或 --at 2026-04-07T21:30+08:00");
-  }
-
-  const account = resolveSelectedAccount(config);
-  const sessionStore = new SessionStore({ filePath: config.sessionsFile });
-  const senderId = resolvePreferredSenderId({
-    config,
-    accountId: account.accountId,
-    explicitUser: options.user,
-    sessionStore,
-  });
-  if (!senderId) {
-    throw new Error("无法确定 reminder 的微信用户，传 --user 或先让唯一活跃用户和 bot 聊过一次");
-  }
-
-  const contextTokens = loadPersistedContextTokens(config, account.accountId);
-  const contextToken = String(contextTokens[senderId] || "").trim();
-  if (!contextToken) {
-    throw new Error(`找不到 ${senderId} 的 context_token，先让这个用户和 bot 聊过一次`);
-  }
-
-  const queue = new ReminderQueueStore({ filePath: config.reminderQueueFile });
-  const reminder = queue.enqueue({
-    id: crypto.randomUUID(),
-    accountId: account.accountId,
-    senderId,
-    contextToken,
-    text: body,
-    dueAtMs,
-    createdAt: new Date().toISOString(),
-  });
-  console.log(`reminder queued: ${reminder.id}`);
-}
-
-function parseArgs(args) {
-  const options = {
-    delay: "",
-    at: "",
-    text: "",
-    user: "",
-    useStdin: false,
-  };
-  for (let index = 0; index < args.length; index += 1) {
-    const arg = args[index];
-    if (arg === "--delay") {
-      options.delay = String(args[index + 1] || "");
-      index += 1;
-      continue;
-    }
-    if (arg === "--at") {
-      options.at = String(args[index + 1] || "");
-      index += 1;
-      continue;
-    }
-    if (arg === "--text") {
-      options.text = String(args[index + 1] || "");
-      index += 1;
-      continue;
-    }
-    if (arg === "--user") {
-      options.user = String(args[index + 1] || "");
-      index += 1;
-      continue;
-    }
-    if (arg === "--stdin") {
-      options.useStdin = true;
-      continue;
-    }
-    throw new Error(`未知参数: ${arg}`);
-  }
-  return options;
-}
-
-function resolveDueAtMs(options) {
-  const delayMs = parseDelay(options.delay);
-  const scheduledAtMs = parseAbsoluteTime(options.at);
-  if (delayMs && scheduledAtMs) {
-    throw new Error("--delay 和 --at 不能同时传");
-  }
-  if (delayMs) {
-    return Date.now() + delayMs;
-  }
-  if (scheduledAtMs) {
-    return scheduledAtMs;
-  }
-  return 0;
-}
-
-function parseDelay(rawValue) {
-  const normalized = String(rawValue || "").trim().toLowerCase();
-  if (!normalized) {
-    return 0;
-  }
-
-  let totalMs = 0;
-  let index = 0;
-  while (index < normalized.length) {
-    while (index < normalized.length && /\s/.test(normalized[index])) {
-      index += 1;
-    }
-    if (index >= normalized.length) {
-      break;
-    }
-
-    const match = normalized.slice(index).match(/^(\d+)\s*([smhd])/);
-    if (!match) {
-      return 0;
-    }
-
-    const amount = Number.parseInt(match[1], 10);
-    const unitMs = DELAY_UNIT_MS[match[2]] || 0;
-    if (!Number.isFinite(amount) || amount <= 0 || !unitMs) {
-      return 0;
-    }
-
-    totalMs += amount * unitMs;
-    index += match[0].length;
-  }
-
-  return totalMs > 0 ? totalMs : 0;
-}
-
-function parseAbsoluteTime(rawValue) {
-  const normalized = String(rawValue || "").trim();
-  if (!normalized) {
-    return 0;
-  }
-
-  const normalizedIso = normalizeAbsoluteTimeString(normalized);
-  const parsed = Date.parse(normalizedIso);
-  return Number.isFinite(parsed) ? parsed : 0;
-}
-
-function normalizeAbsoluteTimeString(value) {
-  const normalized = String(value || "").trim();
-  if (!normalized) {
-    return "";
-  }
-
-  if (/([zZ]|[+-]\d{2}:\d{2})$/.test(normalized)) {
-    return normalized.replace(" ", "T");
-  }
-
-  const dateTimeMatch = normalized.match(/^(\d{4}-\d{2}-\d{2})[ T](\d{2}:\d{2}(?::\d{2})?)$/);
-  if (dateTimeMatch) {
-    return `${dateTimeMatch[1]}T${dateTimeMatch[2]}${LOCAL_TIMEZONE_OFFSET}`;
-  }
-
-  const dateOnlyMatch = normalized.match(/^(\d{4}-\d{2}-\d{2})$/);
-  if (dateOnlyMatch) {
-    return `${dateOnlyMatch[1]}T09:00:00${LOCAL_TIMEZONE_OFFSET}`;
-  }
-
-  return normalized;
-}
-
-async function resolveBody(options) {
-  const inlineText = normalizeBody(options.text);
-  if (inlineText) {
-    return inlineText;
-  }
-  if (!options.useStdin && process.stdin.isTTY) {
-    return "";
-  }
-  return normalizeBody(await readStdin());
-}
-
-function readStdin() {
-  return new Promise((resolve, reject) => {
-    let buffer = "";
-    process.stdin.setEncoding("utf8");
-    process.stdin.on("data", (chunk) => {
-      buffer += chunk;
-    });
-    process.stdin.on("end", () => resolve(buffer));
-    process.stdin.on("error", reject);
-  });
-}
-
-function normalizeBody(value) {
-  return String(value || "").replace(/\r\n/g, "\n").trim();
-}
-
-module.exports = { runReminderWriteCommand };
+const crypto = require("crypto");
+
+const { resolveSelectedAccount } = require("../adapters/channel/weixin/account-store");
+const { loadPersistedContextTokens } = require("../adapters/channel/weixin/context-token-store");
+const { ReminderQueueStore } = require("../adapters/channel/weixin/reminder-queue-store");
+const { SessionStore } = require("../adapters/runtime/codex/session-store");
+const { resolvePreferredSenderId } = require("../core/default-targets");
+const {
+  LEGACY_TIMELINE_TIMEZONE,
+  coerceLocalDateTimeToIso,
+} = require("../core/timezone");
+
+const DELAY_UNIT_MS = {
+  s: 1_000,
+  m: 60_000,
+  h: 60 * 60_000,
+  d: 24 * 60 * 60_000,
+};
+
+async function runReminderWriteCommand(config) {
+  const args = process.argv.slice(4);
+  const options = parseArgs(args);
+  const body = await resolveBody(options);
+  if (!body) {
+    throw new Error("提醒内容不能为空，传 --text 或通过 stdin 输入");
+  }
+
+  const timezone = config?.timezone || LEGACY_TIMELINE_TIMEZONE;
+  const dueAtMs = resolveDueAtMs(options, timezone);
+  if (!Number.isFinite(dueAtMs) || dueAtMs <= Date.now()) {
+    throw new Error(
+      `缺少有效时间，使用 --delay 30s|10m|1h30m|2d4h20m 或 --at ${buildAbsoluteTimeExample(timezone)}`
+    );
+  }
+
+  const account = resolveSelectedAccount(config);
+  const sessionStore = new SessionStore({ filePath: config.sessionsFile });
+  const senderId = resolvePreferredSenderId({
+    config,
+    accountId: account.accountId,
+    explicitUser: options.user,
+    sessionStore,
+  });
+  if (!senderId) {
+    throw new Error("无法确定 reminder 的微信用户，传 --user 或先让唯一活跃用户和 bot 聊过一次");
+  }
+
+  const contextTokens = loadPersistedContextTokens(config, account.accountId);
+  const contextToken = String(contextTokens[senderId] || "").trim();
+  if (!contextToken) {
+    throw new Error(`找不到 ${senderId} 的 context_token，先让这个用户和 bot 聊过一次`);
+  }
+
+  const queue = new ReminderQueueStore({ filePath: config.reminderQueueFile });
+  const reminder = queue.enqueue({
+    id: crypto.randomUUID(),
+    accountId: account.accountId,
+    senderId,
+    contextToken,
+    text: body,
+    dueAtMs,
+    createdAt: new Date().toISOString(),
+  });
+  console.log(`reminder queued: ${reminder.id}`);
+}
+
+function parseArgs(args) {
+  const options = {
+    delay: "",
+    at: "",
+    text: "",
+    user: "",
+    useStdin: false,
+  };
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--delay") {
+      options.delay = String(args[index + 1] || "");
+      index += 1;
+      continue;
+    }
+    if (arg === "--at") {
+      options.at = String(args[index + 1] || "");
+      index += 1;
+      continue;
+    }
+    if (arg === "--text") {
+      options.text = String(args[index + 1] || "");
+      index += 1;
+      continue;
+    }
+    if (arg === "--user") {
+      options.user = String(args[index + 1] || "");
+      index += 1;
+      continue;
+    }
+    if (arg === "--stdin") {
+      options.useStdin = true;
+      continue;
+    }
+    throw new Error(`未知参数: ${arg}`);
+  }
+  return options;
+}
+
+function resolveDueAtMs(options, timezone = LEGACY_TIMELINE_TIMEZONE) {
+  const delayMs = parseDelay(options.delay);
+  const scheduledAtMs = parseAbsoluteTime(options.at, timezone);
+  if (delayMs && scheduledAtMs) {
+    throw new Error("--delay 和 --at 不能同时传");
+  }
+  if (delayMs) {
+    return Date.now() + delayMs;
+  }
+  if (scheduledAtMs) {
+    return scheduledAtMs;
+  }
+  return 0;
+}
+
+function parseDelay(rawValue) {
+  const normalized = String(rawValue || "").trim().toLowerCase();
+  if (!normalized) {
+    return 0;
+  }
+
+  let totalMs = 0;
+  let index = 0;
+  while (index < normalized.length) {
+    while (index < normalized.length && /\s/.test(normalized[index])) {
+      index += 1;
+    }
+    if (index >= normalized.length) {
+      break;
+    }
+
+    const match = normalized.slice(index).match(/^(\d+)\s*([smhd])/);
+    if (!match) {
+      return 0;
+    }
+
+    const amount = Number.parseInt(match[1], 10);
+    const unitMs = DELAY_UNIT_MS[match[2]] || 0;
+    if (!Number.isFinite(amount) || amount <= 0 || !unitMs) {
+      return 0;
+    }
+
+    totalMs += amount * unitMs;
+    index += match[0].length;
+  }
+
+  return totalMs > 0 ? totalMs : 0;
+}
+
+function parseAbsoluteTime(rawValue, timezone = LEGACY_TIMELINE_TIMEZONE) {
+  const normalized = String(rawValue || "").trim();
+  if (!normalized) {
+    return 0;
+  }
+
+  const normalizedIso = normalizeAbsoluteTimeString(normalized, timezone);
+  const parsed = Date.parse(normalizedIso);
+  return Number.isFinite(parsed) ? parsed : 0;
+}
+
+function normalizeAbsoluteTimeString(value, timezone = LEGACY_TIMELINE_TIMEZONE) {
+  const normalized = String(value || "").trim();
+  if (!normalized) {
+    return "";
+  }
+  return coerceLocalDateTimeToIso(normalized, {
+    timeZone: timezone,
+    defaultTime: "09:00:00",
+  }) || normalized;
+}
+
+async function resolveBody(options) {
+  const inlineText = normalizeBody(options.text);
+  if (inlineText) {
+    return inlineText;
+  }
+  if (!options.useStdin && process.stdin.isTTY) {
+    return "";
+  }
+  return normalizeBody(await readStdin());
+}
+
+function readStdin() {
+  return new Promise((resolve, reject) => {
+    let buffer = "";
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (chunk) => {
+      buffer += chunk;
+    });
+    process.stdin.on("end", () => resolve(buffer));
+    process.stdin.on("error", reject);
+  });
+}
+
+function normalizeBody(value) {
+  return String(value || "").replace(/\r\n/g, "\n").trim();
+}
+
+function buildAbsoluteTimeExample(timezone = LEGACY_TIMELINE_TIMEZONE) {
+  const explicit = normalizeAbsoluteTimeString("2026-04-07 21:30", timezone);
+  return `${explicit || "2026-04-07T21:30+08:00"} 或 2026-04-07 21:30（后者按当前 timezone 解释）`;
+}
+
+module.exports = {
+  buildAbsoluteTimeExample,
+  normalizeAbsoluteTimeString,
+  parseAbsoluteTime,
+  resolveDueAtMs,
+  runReminderWriteCommand,
+};

package/src/app/review-cli.js

@@ -1,9 +1,10 @@
 const { buildReview, writeReview } = require("../core/review");
+const { LEGACY_TIMELINE_TIMEZONE } = require("../core/timezone");
 
 async function runReviewCommand(config, kind, args = process.argv.slice(4)) {
   const options = parseReviewArgs(args, kind);
   if (options.help) {
-    printReviewHelp(kind);
+    printReviewHelp(kind, config?.timezone);
     return;
   }
   if (options.stdout) {
@@ -79,13 +80,14 @@ function parseReviewArgs(args, kind) {
   return options;
 }
 
-function printReviewHelp(kind) {
+function printReviewHelp(kind, timezone = LEGACY_TIMELINE_TIMEZONE) {
+  const resolvedTimezone = String(timezone || "").trim() || LEGACY_TIMELINE_TIMEZONE;
   const nightly = [
     "用法: npm run review:nightly -- [--date YYYY-MM-DD] [--stdout] [--deterministic] [--model <id>]",
     "",
     "说明：",
     "  从当前 diary 真相源生成一份 Codeksei 睡前收口。",
-    "  默认按 Asia/Shanghai 的当前日期推断今天，并给周/月复盘提供更轻的日级原料。",
+    `  默认按 ${resolvedTimezone} 的当前日期推断今天，并给周/月复盘提供更轻的日级原料。`,
     "  默认走 hybrid：脚本保骨架，Codex 负责结构化语义提炼；失败时自动回退。",
     "",
     "示例：",
@@ -98,7 +100,7 @@ function printReviewHelp(kind) {
     "",
     "说明：",
     "  从当前 diary 真相源生成一份 Codeksei 生活助理周复盘。",
-    "  默认按 Asia/Shanghai 的当前日期推断本周（周一到周日）。",
+    `  默认按 ${resolvedTimezone} 的当前日期推断本周（周一到周日）。`,
     "  默认走 hybrid：脚本保骨架，Codex 负责结构化语义提炼；失败时自动回退。",
     "",
     "示例：",
@@ -112,7 +114,7 @@ function printReviewHelp(kind) {
     "",
     "说明：",
     "  从当前 diary 真相源生成一份 Codeksei 生活助理月复盘。",
-    "  默认按 Asia/Shanghai 的当前日期推断本月。",
+    `  默认按 ${resolvedTimezone} 的当前日期推断本月。`,
     "  默认走 hybrid：脚本保骨架，Codex 负责结构化语义提炼；失败时自动回退。",
     "",
     "示例：",

package/src/app/system-checkin-poller.js

@@ -1,19 +1,19 @@
-const crypto = require("crypto");
-
+const crypto = require("crypto");
+
 const { resolveSelectedAccount } = require("../adapters/channel/weixin/account-store");
 const { SessionStore } = require("../adapters/runtime/codex/session-store");
 const { PACKAGE_NAME, readPrefixedEnv } = require("../core/branding");
 const { resolvePreferredSenderId, resolvePreferredWorkspaceRoot } = require("../core/default-targets");
 const { SystemMessageQueueStore } = require("../core/system-message-queue-store");
-
-const DEFAULT_MIN_INTERVAL_MS = 3 * 60_000;
-const DEFAULT_MAX_INTERVAL_MS = 60 * 60_000;
-const INTERNAL_CHECKIN_TRIGGER_TEMPLATE = "Decide whether to reach out to %USER% now. You may stay silent, send one short WeChat message, update diary/timeline, or take another useful action. If no user-visible message should be sent, output exactly SILENT. If you do send a message, output only the message text.";
-
-async function runSystemCheckinPoller(config) {
-  const account = resolveSelectedAccount(config);
-  const queue = new SystemMessageQueueStore({ filePath: config.systemMessageQueueFile });
-  const sessionStore = new SessionStore({ filePath: config.sessionsFile });
+
+const DEFAULT_MIN_INTERVAL_MS = 3 * 60_000;
+const DEFAULT_MAX_INTERVAL_MS = 60 * 60_000;
+const INTERNAL_CHECKIN_TRIGGER_TEMPLATE = "Decide whether to reach out to %USER% now. You may stay silent, send one short WeChat message, update diary/timeline, or take another useful action. If no user-visible message should be sent, output exactly SILENT. If you do send a message, output only the message text.";
+
+async function runSystemCheckinPoller(config) {
+  const account = resolveSelectedAccount(config);
+  const queue = new SystemMessageQueueStore({ filePath: config.systemMessageQueueFile });
+  const sessionStore = new SessionStore({ filePath: config.sessionsFile });
   const target = resolvePollerTarget({ config, account, sessionStore });
   const minIntervalMs = readIntervalMs(readPrefixedEnv(process.env, "CHECKIN_MIN_INTERVAL_MS"), DEFAULT_MIN_INTERVAL_MS);
   const maxIntervalMs = Math.max(
@@ -23,32 +23,32 @@ async function runSystemCheckinPoller(config) {
 
   console.log(`[${PACKAGE_NAME}] checkin poller ready user=${target.senderId} workspace=${target.workspaceRoot}`);
   console.log(`[${PACKAGE_NAME}] checkin interval range ${Math.round(minIntervalMs / 60000)}m-${Math.round(maxIntervalMs / 60000)}m`);
-
-  while (true) {
-    const delayMs = pickRandomDelayMs(minIntervalMs, maxIntervalMs);
-    const wakeAt = new Date(Date.now() + delayMs).toISOString();
+
+  while (true) {
+    const delayMs = pickRandomDelayMs(minIntervalMs, maxIntervalMs);
+    const wakeAt = new Date(Date.now() + delayMs).toISOString();
     console.log(`[${PACKAGE_NAME}] next checkin in ${Math.round(delayMs / 60000)}m at ${wakeAt}`);
-    await sleep(delayMs);
-
-    if (queue.hasPendingForAccount(account.accountId)) {
+    await sleep(delayMs);
+
+    if (queue.hasPendingForAccount(account.accountId)) {
       console.log(`[${PACKAGE_NAME}] checkin skipped: pending system message still in queue`);
-      continue;
-    }
-
-    const queued = queue.enqueue({
-      id: crypto.randomUUID(),
-      accountId: account.accountId,
-      senderId: target.senderId,
-      workspaceRoot: target.workspaceRoot,
-      text: buildCheckinTrigger(config),
-      createdAt: new Date().toISOString(),
-    });
+      continue;
+    }
+
+    const queued = queue.enqueue({
+      id: crypto.randomUUID(),
+      accountId: account.accountId,
+      senderId: target.senderId,
+      workspaceRoot: target.workspaceRoot,
+      text: buildCheckinTrigger(config),
+      createdAt: new Date().toISOString(),
+    });
     console.log(`[${PACKAGE_NAME}] checkin queued id=${queued.id}`);
-  }
-}
-
-function resolvePollerTarget({ config, account, sessionStore }) {
-  const senderId = resolvePreferredSenderId({
+  }
+}
+
+function resolvePollerTarget({ config, account, sessionStore }) {
+  const senderId = resolvePreferredSenderId({
     config,
     accountId: account.accountId,
     explicitUser: readPrefixedEnv(process.env, "CHECKIN_USER_ID") || "",
@@ -68,33 +68,33 @@ function resolvePollerTarget({ config, account, sessionStore }) {
   if (!workspaceRoot) {
     throw new Error("无法确定 checkin poller 的 workspace，先设置 CODEKSEI_WORKSPACE_ROOT（或旧的 CYBERBOSS_WORKSPACE_ROOT）");
   }
-
-  return { senderId, workspaceRoot };
-}
-
-function readIntervalMs(rawValue, fallback) {
-  const parsed = Number.parseInt(String(rawValue || ""), 10);
-  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
-}
-
-function pickRandomDelayMs(minIntervalMs, maxIntervalMs) {
-  if (maxIntervalMs <= minIntervalMs) {
-    return minIntervalMs;
-  }
-  return minIntervalMs + Math.floor(Math.random() * (maxIntervalMs - minIntervalMs + 1));
-}
-
-function normalizeText(value) {
-  return typeof value === "string" ? value.trim() : "";
-}
-
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-function buildCheckinTrigger(config) {
-  const userName = normalizeText(config?.userName) || "用户";
-  return INTERNAL_CHECKIN_TRIGGER_TEMPLATE.replace("%USER%", userName);
-}
-
-module.exports = { runSystemCheckinPoller };
+
+  return { senderId, workspaceRoot };
+}
+
+function readIntervalMs(rawValue, fallback) {
+  const parsed = Number.parseInt(String(rawValue || ""), 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+
+function pickRandomDelayMs(minIntervalMs, maxIntervalMs) {
+  if (maxIntervalMs <= minIntervalMs) {
+    return minIntervalMs;
+  }
+  return minIntervalMs + Math.floor(Math.random() * (maxIntervalMs - minIntervalMs + 1));
+}
+
+function normalizeText(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function buildCheckinTrigger(config) {
+  const userName = normalizeText(config?.userName) || "用户";
+  return INTERNAL_CHECKIN_TRIGGER_TEMPLATE.replace("%USER%", userName);
+}
+
+module.exports = { runSystemCheckinPoller };