codeksei 0.1.0 → 0.1.1

package/src/core/workspace-bootstrap.js

@@ -7,6 +7,10 @@ const DEFAULT_BOOTSTRAP_PROFILE = Object.freeze({
       path: "AGENTS.md",
       role: "workspace routing and boundary contract",
     },
+    {
+      path: "AGENTS.local.md",
+      role: "private operator overlay for this workspace",
+    },
     {
       path: "README.md",
       role: "workspace overview and operating instructions",
@@ -19,12 +23,16 @@ const DEFAULT_BOOTSTRAP_PROFILE = Object.freeze({
       path: ".codex/AGENT_GUIDE.md",
       role: "agent write/update rules for this workspace",
     },
+    {
+      path: ".codex/AGENT_GUIDE.local.md",
+      role: "private agent write/update overlay for this workspace",
+    },
   ],
   conditionalFiles: [
     {
       path: ".codex/timeline/README.md",
       role: "timeline write/read contract for this workspace",
-      when: "timeline read/write/build/screenshot work",
+      when: "timeline read/write/build/screenshot work, or cutover/closeout bookkeeping that may append timeline facts/events",
     },
   ],
   recentFiles: [],

package/src/index.js

@@ -1,6 +1,6 @@
-const fs = require("fs");
-const os = require("os");
-const path = require("path");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
 const dotenv = require("dotenv");
 
 const {
@@ -24,12 +24,12 @@ const { runTimelineEventCommand } = require("./app/timeline-event-cli");
 const { runTimelineScreenshotCommand } = require("./app/timeline-screenshot-cli");
 const { runSystemCheckinPoller } = require("./app/system-checkin-poller");
 const { runSystemSendCommand } = require("./app/system-send-cli");
-const {
-  buildTerminalHelpText,
-  buildTerminalTopicHelp,
-  isPlannedTerminalTopic,
-} = require("./core/command-registry");
-
+const {
+  buildTerminalHelpText,
+  buildTerminalTopicHelp,
+  isPlannedTerminalTopic,
+} = require("./core/command-registry");
+
 function ensureDefaultStateDirectory() {
   ensureStateDirectory();
 }
@@ -40,58 +40,60 @@ function loadEnv() {
   for (const envPath of candidates) {
     if (!fs.existsSync(envPath)) {
       continue;
-    }
-    dotenv.config({ path: envPath });
-    return;
-  }
-  dotenv.config();
+    }
+    dotenv.config({ path: envPath });
+    return;
+  }
+  dotenv.config();
 }
 
 function ensureRuntimeEnv() {
   ensureCompatHomeEnv({ fallbackRoot: path.resolve(__dirname, "..") });
 }
-
-function ensureBootstrapFiles(config) {
-  ensureInstructionsTemplate(config);
-}
-
-function ensureInstructionsTemplate(config) {
-  const filePath = typeof config?.weixinInstructionsFile === "string"
-    ? config.weixinInstructionsFile.trim()
-    : "";
-  if (!filePath || fs.existsSync(filePath)) {
-    return;
-  }
-
-  const templatePath = path.resolve(__dirname, "..", "templates", "weixin-instructions.md");
-  let template = "";
-  try {
-    template = fs.readFileSync(templatePath, "utf8");
-  } catch {
-    return;
-  }
-
-  const userName = String(config?.userName || "").trim() || "用户";
-  const content = renderInstructionTemplate(template, {
-    ...config,
-    userName,
-  }).trimEnd() + "\n";
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-  fs.writeFileSync(filePath, content, "utf8");
-}
-
-function printHelp() {
-  console.log(buildTerminalHelpText());
-}
-
-let runtimeErrorHooksInstalled = false;
-
-function installRuntimeErrorHooks() {
-  if (runtimeErrorHooksInstalled) {
-    return;
-  }
-  runtimeErrorHooksInstalled = true;
-
+
+function ensureBootstrapFiles(config) {
+  ensureInstructionsTemplate(config);
+}
+
+function ensureInstructionsTemplate(config) {
+  const filePath = typeof config?.weixinInstructionsFile === "string"
+    ? config.weixinInstructionsFile.trim()
+    : "";
+  if (!filePath || fs.existsSync(filePath)) {
+    return;
+  }
+
+  // The repo template is now the default persona source. Keep this bootstrap
+  // path only for explicit custom file paths that may still need seeding.
+  const templatePath = path.resolve(__dirname, "..", "templates", "weixin-instructions.md");
+  let template = "";
+  try {
+    template = fs.readFileSync(templatePath, "utf8");
+  } catch {
+    return;
+  }
+
+  const userName = String(config?.userName || "").trim() || "用户";
+  const content = renderInstructionTemplate(template, {
+    ...config,
+    userName,
+  }).trimEnd() + "\n";
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, content, "utf8");
+}
+
+function printHelp() {
+  console.log(buildTerminalHelpText());
+}
+
+let runtimeErrorHooksInstalled = false;
+
+function installRuntimeErrorHooks() {
+  if (runtimeErrorHooksInstalled) {
+    return;
+  }
+  runtimeErrorHooksInstalled = true;
+
   process.on("unhandledRejection", (reason) => {
     const message = reason instanceof Error ? reason.stack || reason.message : String(reason);
     console.error(`[${PACKAGE_NAME}] unhandled rejection ${message}`);
@@ -103,62 +105,62 @@ function installRuntimeErrorHooks() {
     process.exitCode = 1;
   });
 }
-
-async function main() {
-  loadEnv();
-  ensureRuntimeEnv();
-  installRuntimeErrorHooks();
-  const argv = process.argv.slice(2);
-  const config = readConfig();
-  ensureBootstrapFiles(config);
-  const command = config.mode || "help";
-  const subcommand = argv[1] || "";
-  let app = null;
-  const getApp = () => {
-    if (!app) {
-      app = new CyberbossApp(config);
-    }
-    return app;
-  };
-
-  if (command === "help" || command === "--help" || command === "-h") {
-    const topicHelp = subcommand ? buildTerminalTopicHelp(subcommand) : "";
-    console.log(topicHelp || buildTerminalHelpText());
-    return;
-  }
-
-  if (isPlannedTerminalTopic(command)) {
-    const topicHelp = buildTerminalTopicHelp(command);
-    const subcommandArgs = argv.slice(2);
-    const wantsSubcommandHelp = subcommandArgs.includes("--help") || subcommandArgs.includes("-h");
-    if (subcommand === "help" || !subcommand) {
-      console.log(topicHelp);
-      return;
-    }
-    if (command === "diary" && subcommand === "write") {
-      if (wantsSubcommandHelp) {
-        console.log(topicHelp);
-        return;
-      }
-      await runDiaryWriteCommand(config);
-      return;
-    }
-    if (command === "reminder" && subcommand === "write") {
-      if (wantsSubcommandHelp) {
-        console.log(topicHelp);
-        return;
-      }
-      await runReminderWriteCommand(config);
-      return;
-    }
-    if (command === "system" && subcommand === "send") {
-      await runSystemSendCommand(config);
-      return;
-    }
-    if (command === "system" && subcommand === "checkin-poller") {
-      await runSystemCheckinPoller(config);
-      return;
-    }
+
+async function main() {
+  loadEnv();
+  ensureRuntimeEnv();
+  installRuntimeErrorHooks();
+  const argv = process.argv.slice(2);
+  const config = readConfig();
+  ensureBootstrapFiles(config);
+  const command = config.mode || "help";
+  const subcommand = argv[1] || "";
+  let app = null;
+  const getApp = () => {
+    if (!app) {
+      app = new CyberbossApp(config);
+    }
+    return app;
+  };
+
+  if (command === "help" || command === "--help" || command === "-h") {
+    const topicHelp = subcommand ? buildTerminalTopicHelp(subcommand) : "";
+    console.log(topicHelp || buildTerminalHelpText());
+    return;
+  }
+
+  if (isPlannedTerminalTopic(command)) {
+    const topicHelp = buildTerminalTopicHelp(command);
+    const subcommandArgs = argv.slice(2);
+    const wantsSubcommandHelp = subcommandArgs.includes("--help") || subcommandArgs.includes("-h");
+    if (subcommand === "help" || !subcommand) {
+      console.log(topicHelp);
+      return;
+    }
+    if (command === "diary" && subcommand === "write") {
+      if (wantsSubcommandHelp) {
+        console.log(topicHelp);
+        return;
+      }
+      await runDiaryWriteCommand(config);
+      return;
+    }
+    if (command === "reminder" && subcommand === "write") {
+      if (wantsSubcommandHelp) {
+        console.log(topicHelp);
+        return;
+      }
+      await runReminderWriteCommand(config);
+      return;
+    }
+    if (command === "system" && subcommand === "send") {
+      await runSystemSendCommand(config);
+      return;
+    }
+    if (command === "system" && subcommand === "checkin-poller") {
+      await runSystemCheckinPoller(config);
+      return;
+    }
     if (command === "channel" && subcommand === "send-file") {
       await runChannelSendFileCommand(getApp());
       return;
@@ -220,7 +222,7 @@ async function main() {
       return;
     }
   }
-
+
   if (command === "timeline") {
     const timelineIntegration = createTimelineIntegration(config);
     if (!subcommand || subcommand === "help") {
@@ -228,7 +230,7 @@ async function main() {
       return;
     }
     if (subcommand === "event") {
-      await runTimelineEventCommand(timelineIntegration, argv.slice(2));
+      await runTimelineEventCommand(timelineIntegration, config, argv.slice(2));
       return;
     }
     if (subcommand === "screenshot") {
@@ -236,35 +238,35 @@ async function main() {
       if (screenshotArgs.includes("--help") || screenshotArgs.includes("-h")) {
         await timelineIntegration.runSubcommand(subcommand, screenshotArgs);
         return;
-      }
-      await runTimelineScreenshotCommand(config, argv.slice(2));
-      return;
-    }
-    await timelineIntegration.runSubcommand(subcommand, argv.slice(2));
-    return;
-  }
-
-  if (command === "doctor") {
-    getApp().printDoctor();
-    return;
-  }
-
-  if (command === "login") {
-    await getApp().login();
-    return;
-  }
-
-  if (command === "accounts") {
-    getApp().printAccounts();
-    return;
-  }
-
-  if (command === "start") {
-    await getApp().start();
-    return;
-  }
-
-  throw new Error(`未知命令: ${command}`);
-}
-
-module.exports = { main };
+      }
+      await runTimelineScreenshotCommand(config, argv.slice(2));
+      return;
+    }
+    await timelineIntegration.runSubcommand(subcommand, argv.slice(2));
+    return;
+  }
+
+  if (command === "doctor") {
+    getApp().printDoctor();
+    return;
+  }
+
+  if (command === "login") {
+    await getApp().login();
+    return;
+  }
+
+  if (command === "accounts") {
+    getApp().printAccounts();
+    return;
+  }
+
+  if (command === "start") {
+    await getApp().start();
+    return;
+  }
+
+  throw new Error(`未知命令: ${command}`);
+}
+
+module.exports = { main };

package/src/integrations/timeline/index.js

@@ -1,17 +1,21 @@
 const path = require("path");
 const { spawn } = require("child_process");
 const { readPrefixedEnv } = require("../../core/branding");
+const { resolveTimelineStateFiles } = require("../../core/timezone");
+const { ensureTimelineStateTimezone } = require("./state-sync");
 
 function createTimelineIntegration(config) {
   const binPath = resolveTimelineBinPath();
-
-  return {
-    describe() {
+  const timelineFiles = resolveTimelineStateFiles(config.timelineStateDir);
+
+  return {
+    describe() {
       return {
         id: "timeline-for-agent",
         kind: "integration",
         command: `${process.execPath} ${binPath}`,
         stateDir: config.timelineStateDir,
+        timelineDir: timelineFiles.dir,
       };
     },
     async runSubcommand(subcommand, args = []) {
@@ -19,26 +23,37 @@ function createTimelineIntegration(config) {
       if (!normalizedSubcommand) {
         throw new Error("timeline 子命令不能为空");
       }
+      ensureTimelineStateTimezone(config);
+      // Pass the fully resolved files so Codeksei, state sync, and
+      // timeline-for-agent all operate on the same layout during direct,
+      // nested, and migrated state-dir variants.
       return runTimelineCommand(binPath, [normalizedSubcommand, ...normalizeTimelineArgs(normalizedSubcommand, args)], {
         TIMELINE_FOR_AGENT_STATE_DIR: config.timelineStateDir,
+        TIMELINE_FOR_AGENT_DIR: timelineFiles.dir,
+        TIMELINE_FOR_AGENT_STATE_FILE: timelineFiles.stateFile,
+        TIMELINE_FOR_AGENT_TAXONOMY_FILE: timelineFiles.taxonomyFile,
+        TIMELINE_FOR_AGENT_FACTS_FILE: timelineFiles.factsFile,
+        TIMELINE_FOR_AGENT_DB_FILE: path.join(timelineFiles.dir, "timeline-db.json"),
+        TIMELINE_FOR_AGENT_SITE_DIR: path.join(timelineFiles.dir, "site"),
+        TIMELINE_FOR_AGENT_WRITE_LOCK_DIR: path.join(timelineFiles.dir, "timeline-write.lock"),
         TIMELINE_FOR_AGENT_CHROME_PATH: resolveTimelineChromePath(),
       }, {
         subcommand: normalizedSubcommand,
       });
-    },
-  };
-}
-
-function resolveTimelineBinPath() {
-  const packageJsonPath = require.resolve("timeline-for-agent/package.json");
-  return path.join(path.dirname(packageJsonPath), "bin", "timeline-for-agent.js");
-}
-
+    },
+  };
+}
+
+function resolveTimelineBinPath() {
+  const packageJsonPath = require.resolve("timeline-for-agent/package.json");
+  return path.join(path.dirname(packageJsonPath), "bin", "timeline-for-agent.js");
+}
+
 function runTimelineCommand(binPath, args, extraEnv = {}, options = {}) {
   return new Promise((resolve, reject) => {
     const spawnSpec = buildTimelineSpawnSpec(binPath, args);
     const child = spawn(spawnSpec.command, spawnSpec.args, {
-      stdio: ["inherit", "pipe", "pipe"],
+      stdio: ["pipe", "pipe", "pipe"],
       env: {
         ...process.env,
         ...extraEnv,
@@ -46,42 +61,45 @@ function runTimelineCommand(binPath, args, extraEnv = {}, options = {}) {
       shell: false,
       windowsHide: true,
     });
-
-    let stdout = "";
-    let stderr = "";
-
-    child.stdout.on("data", (chunk) => {
-      const text = chunk.toString("utf8");
-      stdout += text;
-      process.stdout.write(text);
-    });
-
-    child.stderr.on("data", (chunk) => {
-      const text = chunk.toString("utf8");
-      stderr += text;
-      process.stderr.write(text);
-    });
-
-    child.once("error", reject);
-    child.once("exit", (code, signal) => {
-      if (signal) {
-        reject(new Error(`timeline 进程被信号中断: ${signal}`));
-        return;
-      }
-      if (code !== 0) {
-        reject(new Error(`timeline 命令执行失败，退出码 ${code}`));
-        return;
-      }
-      if (options.subcommand === "write") {
-        const failure = detectTimelineWriteFailure(stdout, stderr);
-        if (failure) {
-          reject(new Error(failure));
-          return;
-        }
-      }
-      resolve();
-    });
-  });
+
+    let stdout = "";
+    let stderr = "";
+
+    child.stdout.on("data", (chunk) => {
+      const text = chunk.toString("utf8");
+      stdout += text;
+      process.stdout.write(text);
+    });
+
+    child.stderr.on("data", (chunk) => {
+      const text = chunk.toString("utf8");
+      stderr += text;
+      process.stderr.write(text);
+    });
+
+    wireTimelineStdin(child, args);
+
+    child.once("error", reject);
+    child.once("exit", (code, signal) => {
+      if (signal) {
+        reject(new Error(`timeline 进程被信号中断: ${signal}`));
+        return;
+      }
+      if (code !== 0) {
+        const detail = extractTimelineCommandFailure(stdout, stderr);
+        reject(new Error(detail || `timeline 命令执行失败，退出码 ${code}`));
+        return;
+      }
+      if (options.subcommand === "write") {
+        const failure = detectTimelineWriteFailure(stdout, stderr);
+        if (failure) {
+          reject(new Error(failure));
+          return;
+        }
+      }
+      resolve();
+    });
+  });
 }
 
 function buildTimelineSpawnSpec(binPath, args = []) {
@@ -93,7 +111,7 @@ function buildTimelineSpawnSpec(binPath, args = []) {
     args: [binPath, ...args],
   };
 }
-
+
 function normalizeArgs(args) {
   return Array.isArray(args)
     ? args
@@ -159,33 +177,71 @@ function normalizeTimelineArgs(subcommand, args) {
 function isIsoDateToken(value) {
   return /^\d{4}-\d{2}-\d{2}$/.test(normalizeText(value));
 }
-
-function normalizeText(value) {
-  return typeof value === "string" ? value.trim() : "";
-}
-
+
+function normalizeText(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
 function resolveTimelineChromePath() {
   const configured = normalizeText(process.env.TIMELINE_FOR_AGENT_CHROME_PATH)
     || normalizeText(readPrefixedEnv(process.env, "SCREENSHOT_CHROME_PATH"));
   if (configured) {
     return configured;
   }
-  if (process.platform === "darwin") {
-    return "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome";
-  }
-  return "";
-}
-
-function detectTimelineWriteFailure(stdout, stderr) {
-  const output = `${stdout}\n${stderr}`;
-  const statusMatch = output.match(/^\s*status:\s*(.+)\s*$/m);
-  const eventsMatch = output.match(/^\s*events:\s*(\d+)\s*$/m);
-  const status = normalizeText(statusMatch?.[1]);
-  const events = Number.parseInt(eventsMatch?.[1] || "", 10);
-  if (status === "missing" && Number.isFinite(events) && events <= 0) {
-    return "timeline write 没有写入任何事件；当前结果是 events: 0 且 status: missing。请检查是否真的传入了有效 JSON events。";
-  }
-  return "";
-}
-
-module.exports = { createTimelineIntegration };
+  if (process.platform === "darwin") {
+    return "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome";
+  }
+  return "";
+}
+
+function detectTimelineWriteFailure(stdout, stderr) {
+  const output = `${stdout}\n${stderr}`;
+  const statusMatch = output.match(/^\s*status:\s*(.+)\s*$/m);
+  const eventsMatch = output.match(/^\s*events:\s*(\d+)\s*$/m);
+  const status = normalizeText(statusMatch?.[1]);
+  const events = Number.parseInt(eventsMatch?.[1] || "", 10);
+  if (status === "missing" && Number.isFinite(events) && events <= 0) {
+    return "timeline write 没有写入任何事件；当前结果是 events: 0 且 status: missing。请检查是否真的传入了有效 JSON events。";
+  }
+  return "";
+}
+
+function extractTimelineCommandFailure(stdout, stderr) {
+  const output = `${stderr}\n${stdout}`;
+  const lines = output
+    .split("\n")
+    .map((line) => line.trim())
+    .filter(Boolean);
+
+  return lines.find((line) => line.includes("timeline 事件无效"))
+    || lines.find((line) => line.includes("timeline 事件不能跨天"))
+    || lines.find((line) => line.includes("timeline-write"))
+    || lines.at(-1)
+    || "";
+}
+
+function shouldForwardTimelineStdin(args = [], stdin = process.stdin) {
+  return Array.isArray(args)
+    && args.some((value) => String(value || "").trim() === "--stdin")
+    && stdin
+    && stdin.isTTY === false;
+}
+
+function wireTimelineStdin(child, args = [], stdin = process.stdin) {
+  if (!child?.stdin) {
+    return;
+  }
+  if (!shouldForwardTimelineStdin(args, stdin)) {
+    child.stdin.end();
+    return;
+  }
+  stdin.pipe(child.stdin);
+}
+
+module.exports = {
+  createTimelineIntegration,
+  detectTimelineWriteFailure,
+  extractTimelineCommandFailure,
+  normalizeTimelineArgs,
+  shouldForwardTimelineStdin,
+};