codeksei 0.1.0 → 0.1.1

package/src/app/channel-send-file-cli.js

@@ -1,57 +1,57 @@
-async function runChannelSendFileCommand(app) {
-  const args = process.argv.slice(4);
-  if (args.includes("--help") || args.includes("-h")) {
-    printHelp();
-    return;
-  }
-
-  const options = parseArgs(args);
-  if (!options.path) {
-    throw new Error("缺少 --path，指定要发回微信的本地文件路径");
-  }
-
-  const result = await app.sendLocalFileToCurrentChat({
-    senderId: options.user,
-    filePath: options.path,
-  });
-  console.log(`file sent: ${result.filePath}`);
-}
-
-function parseArgs(args) {
-  const options = {
-    path: "",
-    user: "",
-  };
-
-  for (let index = 0; index < args.length; index += 1) {
-    const arg = String(args[index] || "");
-    if (arg === "--path") {
-      options.path = String(args[index + 1] || "");
-      index += 1;
-      continue;
-    }
-    if (arg === "--user") {
-      options.user = String(args[index + 1] || "");
-      index += 1;
-      continue;
-    }
-    throw new Error(`未知参数: ${arg}`);
-  }
-
-  return options;
-}
-
-function printHelp() {
-  console.log([
-    "用法: npm run channel:send-file -- --path /绝对路径 [--user <wechatUserId>]",
-    "",
-    "参数：",
-    "  --path /绝对路径         要发回当前微信聊天的本地文件",
-    "  --user <wechatUserId>   可选，覆盖默认接收用户",
-    "",
-    "示例：",
-    "  npm run channel:send-file -- --path /Users/name/project/README.md",
-  ].join("\n"));
-}
-
-module.exports = { runChannelSendFileCommand };
+async function runChannelSendFileCommand(app) {
+  const args = process.argv.slice(4);
+  if (args.includes("--help") || args.includes("-h")) {
+    printHelp();
+    return;
+  }
+
+  const options = parseArgs(args);
+  if (!options.path) {
+    throw new Error("缺少 --path，指定要发回微信的本地文件路径");
+  }
+
+  const result = await app.sendLocalFileToCurrentChat({
+    senderId: options.user,
+    filePath: options.path,
+  });
+  console.log(`file sent: ${result.filePath}`);
+}
+
+function parseArgs(args) {
+  const options = {
+    path: "",
+    user: "",
+  };
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = String(args[index] || "");
+    if (arg === "--path") {
+      options.path = String(args[index + 1] || "");
+      index += 1;
+      continue;
+    }
+    if (arg === "--user") {
+      options.user = String(args[index + 1] || "");
+      index += 1;
+      continue;
+    }
+    throw new Error(`未知参数: ${arg}`);
+  }
+
+  return options;
+}
+
+function printHelp() {
+  console.log([
+    "用法: npm run channel:send-file -- --path /绝对路径 [--user <wechatUserId>]",
+    "",
+    "参数：",
+    "  --path /绝对路径         要发回当前微信聊天的本地文件",
+    "  --user <wechatUserId>   可选，覆盖默认接收用户",
+    "",
+    "示例：",
+    "  npm run channel:send-file -- --path /Users/name/project/README.md",
+  ].join("\n"));
+}
+
+module.exports = { runChannelSendFileCommand };

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

@@ -1,6 +1,12 @@
 const fs = require("fs");
 const path = require("path");
 const { PACKAGE_NAME } = require("../core/branding");
+const {
+  LEGACY_TIMELINE_TIMEZONE,
+  formatDateInTimezone,
+  formatDateTimeInTimezone,
+  formatTimeInTimezone,
+} = require("../core/timezone");
 
 const DEFAULT_SECTION = "supplement";
 const SECTION_HEADINGS = Object.freeze({
@@ -14,6 +20,8 @@ const TODO_STATE_MARKERS = Object.freeze({
   open: " ",
   done: "x",
 });
+const TODO_LINE_RE = /^- \[( |x|X)\] (.*)$/u;
+const TODO_START_MARKER_RE = /\s*<!--\s*codeksei-todo:start=(\d{2}:\d{2})\s*-->\s*$/u;
 
 async function runDiaryWriteCommand(config) {
   const args = process.argv.slice(4);
@@ -22,36 +30,47 @@ async function runDiaryWriteCommand(config) {
   if (!body) {
     throw new Error("日记内容不能为空，传 --text 或通过 stdin 输入");
   }
-
+
   const now = new Date();
-  const dateString = options.date || formatDate(now);
-  const timeString = options.time || formatTime(now);
+  const timezone = config?.timezone || LEGACY_TIMELINE_TIMEZONE;
+  const dateString = options.date || formatDate(now, timezone);
+  const timeString = options.time || formatTime(now, timezone);
   const section = normalizeSection(options.section);
-  const todoState = normalizeTodoState(options.state, section);
-  const usesLegacyTodoDoneFallback = shouldSynthesizeTodoDoneTimelineText({
-    section,
-    todoState,
-    timelineText: options.timelineText,
-  });
   const filePath = path.join(config.diaryDir, `${dateString}.md`);
-  const entryPayloads = buildDiaryWriteEntryPayloads({
+  fs.mkdirSync(config.diaryDir, { recursive: true });
+  ensureDiaryFile(filePath, now, timezone);
+  const current = fs.readFileSync(filePath, "utf8");
+  const timelineResolution = resolveTodoDoneTimelineText({
+    existingContent: current,
     section,
     timeString,
     title: options.title,
     body,
-    todoState,
+    // Keep the raw CLI flag here too. Otherwise non-todo writes inherit the
+    // synthesized internal "open" default and trip the same guard that is
+    // meant only for explicit --state misuse.
+    todoState: options.state,
     timelineText: options.timelineText,
   });
-  if (usesLegacyTodoDoneFallback) {
+  if (timelineResolution.mode === "point_in_time") {
     console.warn(
-      `[${PACKAGE_NAME}] diary:write legacy todo-done call omitted --timeline-text; `
-      + "synthesized a minimal point-in-time diary fact to keep the cutover atomic."
+      `[${PACKAGE_NAME}] diary:write todo-done call omitted --timeline-text and no captured Todo start time was found; `
+      + "synthesized only a point-in-time diary fact. Prefer opening the live Todo earlier, or pass exact cutover wording via --timeline-text."
     );
   }
-
-  fs.mkdirSync(config.diaryDir, { recursive: true });
-  ensureDiaryFile(filePath, now);
-  const current = fs.readFileSync(filePath, "utf8");
+  const entryPayloads = buildDiaryWriteEntryPayloads({
+    existingContent: current,
+    section,
+    timeString,
+    title: options.title,
+    body,
+    // Keep the raw CLI flag here. Non-todo writes internally normalize the
+    // missing state to "open" for cutover bookkeeping, but treating that
+    // synthesized default as an explicit --state would wrongly reject
+    // fragment/timeline writes.
+    todoState: options.state,
+    timelineText: options.timelineText,
+  });
   const next = entryPayloads.reduce(
     (draft, payload) => insertDiaryEntry(draft, payload, dateString),
     current
@@ -61,7 +80,7 @@ async function runDiaryWriteCommand(config) {
 }
 
 function parseArgs(args) {
-  const options = {
+  const options = {
     text: "",
     title: "",
     date: "",
@@ -124,30 +143,30 @@ function readOptionValue(args, index, optionName) {
   }
   return String(next);
 }
-
-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);
-  });
-}
-
+
+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 buildDiaryEntry({ timeString, title, body }) {
   const heading = title ? `### ${timeString} ${title.trim()}` : `### ${timeString}`;
   return `${heading}\n\n${body}`;
@@ -181,11 +200,17 @@ function buildDiaryEntryPayload({ section = DEFAULT_SECTION, timeString, title,
 
   if (normalizedSection === "todo") {
     const normalizedState = normalizeTodoState(todoState, normalizedSection);
+    const todoStartedAt = normalizedState === "open" ? normalizeTodoClock(timeString) : "";
     return {
       section: normalizedSection,
-      entry: `- [${TODO_STATE_MARKERS[normalizedState]}] ${lineText}`,
+      entry: buildTodoLine({
+        text: lineText,
+        todoState: normalizedState,
+        todoStartedAt,
+      }),
       text: lineText,
       todoState: normalizedState,
+      todoStartedAt,
     };
   }
 
@@ -197,17 +222,25 @@ function buildDiaryEntryPayload({ section = DEFAULT_SECTION, timeString, title,
 }
 
 function buildDiaryWriteEntryPayloads({
+  existingContent = "",
   section = DEFAULT_SECTION,
   timeString,
   title,
   body,
-  todoState = "open",
+  todoState = "",
   timelineText = "",
 }) {
   const normalizedSection = normalizeSection(section);
   const normalizedTodoState = normalizeTodoState(todoState, normalizedSection);
-  const normalizedTimelineText = normalizeLineItem(timelineText)
-    || synthesizeTodoDoneTimelineText({ section, timeString, title, body, todoState });
+  const normalizedTimelineText = resolveTodoDoneTimelineText({
+    existingContent,
+    section,
+    timeString,
+    title,
+    body,
+    todoState,
+    timelineText,
+  }).text;
 
   if (normalizedTimelineText && (normalizedSection !== "todo" || normalizedTodoState !== "done")) {
     throw new Error("--timeline-text 只支持和 --section todo --state done 一起使用");
@@ -242,12 +275,55 @@ function shouldSynthesizeTodoDoneTimelineText({ section = DEFAULT_SECTION, todoS
     && !normalizeLineItem(timelineText);
 }
 
+function resolveTodoDoneTimelineText({
+  existingContent = "",
+  section = DEFAULT_SECTION,
+  timeString = "",
+  title = "",
+  body = "",
+  todoState = "open",
+  timelineText = "",
+}) {
+  const explicitTimelineText = normalizeLineItem(timelineText);
+  if (explicitTimelineText) {
+    return {
+      text: explicitTimelineText,
+      mode: "explicit",
+    };
+  }
+
+  if (!shouldSynthesizeTodoDoneTimelineText({ section, todoState })) {
+    return {
+      text: "",
+      mode: "none",
+    };
+  }
+
+  const existingTodoStartTime = findTodoStartTimeInDiaryContent(existingContent, {
+    title,
+    body,
+  });
+  const synthesized = synthesizeTodoDoneTimelineText({
+    section,
+    timeString,
+    title,
+    body,
+    todoState,
+    existingTodoStartTime,
+  });
+  return {
+    text: synthesized,
+    mode: existingTodoStartTime ? "range_from_todo" : "point_in_time",
+  };
+}
+
 function synthesizeTodoDoneTimelineText({
   section = DEFAULT_SECTION,
   timeString = "",
   title = "",
   body = "",
   todoState = "open",
+  existingTodoStartTime = "",
 }) {
   if (!shouldSynthesizeTodoDoneTimelineText({ section, todoState })) {
     return "";
@@ -258,19 +334,23 @@ function synthesizeTodoDoneTimelineText({
     return "";
   }
 
-  // Keep stale prompts from dropping the diary hard fact entirely. This
-  // compatibility bridge records only a minimal point-in-time fact; fresh
-  // callers should still pass --timeline-text with the real cutover context.
+  // Keep stale prompts from dropping the diary hard fact entirely. When the
+  // same live Todo already captured a reliable start time, reuse it here so
+  // todo-first workflow can still produce an accurate diary range at cutover.
+  const capturedStartTime = normalizeTodoClock(existingTodoStartTime);
   const normalizedTime = normalizeLineItem(timeString);
+  if (capturedStartTime && normalizedTime && capturedStartTime !== normalizedTime) {
+    return `${capturedStartTime}-${normalizedTime} ${lineText}`;
+  }
   return normalizedTime ? `${normalizedTime} ${lineText}` : lineText;
 }
 
-function ensureDiaryFile(filePath, now) {
+function ensureDiaryFile(filePath, now, timezone = LEGACY_TIMELINE_TIMEZONE) {
   if (fs.existsSync(filePath) && fs.statSync(filePath).size > 0) {
     return;
   }
-  const createdAt = formatDateTime(now);
-  const updated = formatDate(now);
+  const createdAt = formatDateTime(now, timezone);
+  const updated = formatDate(now, timezone);
   fs.writeFileSync(filePath, buildDiaryFileSkeleton({ createdAt, updated }), "utf8");
 }
 
@@ -349,6 +429,7 @@ function normalizeEntryPayload(entry) {
     title: normalizeLineItem(payload.title),
     body: normalizeBody(payload.body),
     todoState: normalizeTodoState(payload.todoState, normalizeSection(payload.section)),
+    todoStartedAt: normalizeTodoClock(payload.todoStartedAt),
   };
 }
 
@@ -423,22 +504,49 @@ function isPlaceholderLine(line, section) {
 
 function upsertTodoLine(lines, payload) {
   const nextLines = Array.isArray(lines) ? [...lines] : [];
-  const desiredLine = `- [${TODO_STATE_MARKERS[payload.todoState]}] ${payload.text}`;
   for (let index = 0; index < nextLines.length; index += 1) {
-    const match = /^- \[( |x|X)\] (.*)$/u.exec(String(nextLines[index] || ""));
-    if (!match) {
+    const parsed = parseTodoLine(nextLines[index]);
+    if (!parsed) {
       continue;
     }
-    if (normalizeLineItem(match[2]) !== payload.text) {
+    if (parsed.text !== payload.text) {
       continue;
     }
-    nextLines[index] = desiredLine;
+    nextLines[index] = buildTodoLine({
+      text: payload.text,
+      todoState: payload.todoState,
+      todoStartedAt: resolveTodoStartedAtForUpsert(parsed, payload),
+    });
     return nextLines;
   }
-  nextLines.push(desiredLine);
+  nextLines.push(buildTodoLine({
+    text: payload.text,
+    todoState: payload.todoState,
+    todoStartedAt: payload.todoStartedAt,
+  }));
   return nextLines;
 }
 
+function resolveTodoStartedAtForUpsert(parsed, payload) {
+  const existingState = parsed?.todoState || "open";
+  const existingStartedAt = normalizeTodoClock(parsed?.todoStartedAt);
+  const payloadStartedAt = normalizeTodoClock(payload?.todoStartedAt);
+  const nextState = normalizeTodoState(payload?.todoState, "todo");
+
+  // Repeated writes against the same live open Todo should keep the original
+  // block start. But if the same text gets reopened after it was already done,
+  // the new open write represents a fresh block and must reset the captured
+  // start time instead of leaking the old finished block's timestamp.
+  if (nextState === "open") {
+    if (existingState === "open") {
+      return existingStartedAt || payloadStartedAt;
+    }
+    return payloadStartedAt || existingStartedAt;
+  }
+
+  return existingStartedAt || payloadStartedAt;
+}
+
 function upsertBulletLine(lines, payload) {
   const nextLines = Array.isArray(lines) ? [...lines] : [];
   for (const line of nextLines) {
@@ -531,6 +639,58 @@ function buildSectionLineText({ title, body }) {
   return normalizedTitle || normalizedBody;
 }
 
+function buildTodoLine({ text, todoState = "open", todoStartedAt = "" }) {
+  const startMarker = buildTodoStartMarker(todoStartedAt);
+  return `- [${TODO_STATE_MARKERS[todoState]}] ${text}${startMarker}`;
+}
+
+function buildTodoStartMarker(value) {
+  const normalized = normalizeTodoClock(value);
+  return normalized ? ` <!-- codeksei-todo:start=${normalized} -->` : "";
+}
+
+function parseTodoLine(line) {
+  const match = TODO_LINE_RE.exec(String(line || ""));
+  if (!match) {
+    return null;
+  }
+  const rawText = String(match[2] || "");
+  const startMarker = TODO_START_MARKER_RE.exec(rawText);
+  return {
+    todoState: String(match[1] || "").toLowerCase() === "x" ? "done" : "open",
+    text: normalizeLineItem(stripTodoMetadata(rawText)),
+    todoStartedAt: normalizeTodoClock(startMarker?.[1] || ""),
+  };
+}
+
+function stripTodoMetadata(value) {
+  return String(value || "").replace(TODO_START_MARKER_RE, "").trim();
+}
+
+function findTodoStartTimeInDiaryContent(content, { title = "", body = "" } = {}) {
+  const normalizedContent = normalizeFileEnding(content);
+  if (!normalizedContent.trim()) {
+    return "";
+  }
+  const range = findSectionRange(normalizedContent, SECTION_HEADINGS.todo);
+  if (!range) {
+    return "";
+  }
+  const targetText = buildSectionLineText({ title, body });
+  if (!targetText) {
+    return "";
+  }
+  const lines = extractSectionLines(normalizedContent.slice(range.contentStart, range.end), "todo");
+  for (let index = lines.length - 1; index >= 0; index -= 1) {
+    const parsed = parseTodoLine(lines[index]);
+    if (!parsed || parsed.text !== targetText) {
+      continue;
+    }
+    return parsed.todoStartedAt;
+  }
+  return "";
+}
+
 function normalizeSection(value) {
   const normalized = String(value || "").trim().toLowerCase();
   switch (normalized) {
@@ -576,35 +736,21 @@ function normalizeLineItem(value) {
   return normalizeBody(value).replace(/\s*\n+\s*/g, " ").replace(/\s{2,}/g, " ").trim();
 }
 
-function formatDate(date) {
-  return new Intl.DateTimeFormat("en-CA", {
-    timeZone: "Asia/Shanghai",
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit",
-  }).format(date);
-}
-
-function formatTime(date) {
-  return new Intl.DateTimeFormat("zh-CN", {
-    timeZone: "Asia/Shanghai",
-    hour: "2-digit",
-    minute: "2-digit",
-    hour12: false,
-  }).format(date);
-}
-
-function formatDateTime(date) {
-  const formatter = new Intl.DateTimeFormat("sv-SE", {
-    timeZone: "Asia/Shanghai",
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit",
-    hour: "2-digit",
-    minute: "2-digit",
-    hour12: false,
-  });
-  return formatter.format(date).replace(" ", "T");
+function normalizeTodoClock(value) {
+  const normalized = normalizeLineItem(value);
+  return /^\d{2}:\d{2}$/u.test(normalized) ? normalized : "";
+}
+
+function formatDate(date, timezone = LEGACY_TIMELINE_TIMEZONE) {
+  return formatDateInTimezone(date, timezone);
+}
+
+function formatTime(date, timezone = LEGACY_TIMELINE_TIMEZONE) {
+  return formatTimeInTimezone(date, timezone);
+}
+
+function formatDateTime(date, timezone = LEGACY_TIMELINE_TIMEZONE) {
+  return formatDateTimeInTimezone(date, timezone);
 }
 
 module.exports = {
@@ -616,5 +762,7 @@ module.exports = {
   normalizeSection,
   normalizeTodoState,
   parseArgs,
+  parseTodoLine,
   runDiaryWriteCommand,
+  resolveTodoDoneTimelineText,
 };

package/src/app/note-sync-cli.js

@@ -119,8 +119,8 @@ function printNoteSyncHelp() {
     "",
     "示例：",
     "  npm run note:sync -- --project <slug> --section \"最近动作\" --text \"把微信 prompt 收口为更温柔的 chief-of-staff 风格\" --max-items 6",
-    "  npm run note:sync -- --project <slug> --section \"当前状态\" --slot current-status --style paragraph --text \"当前默认主 workspace 是 Website，shared bridge 正常运行。\"",
-    "  npm run note:sync -- --path \"项目/Codeksei 生活助理/README.md\" --section \"当前定位\" --text \"默认先接住，再定向，再推进，不做催债式主动提醒。\"",
+    "  npm run note:sync -- --project <slug> --section \"当前状态\" --slot current-status --style paragraph --text \"当前 shared bridge 正常运行，默认入口稳定。\"",
+    "  npm run note:sync -- --path \"/absolute/path/to/note.md\" --section \"当前定位\" --text \"默认先接住，再定向，再推进。\"",
   ].join("\n"));
 }