codeksei 0.1.0 → 0.1.1

package/src/core/config.js

@@ -8,12 +8,19 @@ const {
   resolveAppHome,
   resolveStateDir,
 } = require("./branding");
+const { resolveCrossPlatformPathFromRoot } = require("./path-utils");
+const { resolveTimezoneConfig } = require("./timezone");
 
 function readConfig() {
   const argv = process.argv.slice(2);
   const mode = argv[0] || "";
   const stateDir = resolveStateDir({ env: process.env });
   const workspaceRoot = readPrefixedEnv(process.env, "WORKSPACE_ROOT") || process.cwd();
+  const timelineStateDir = readPrefixedEnv(process.env, "TIMELINE_STATE_DIR") || stateDir;
+  const timezoneConfig = resolveTimezoneConfig({
+    explicitTimezone: readPrefixedEnv(process.env, "TIMEZONE"),
+    timelineStateDir,
+  });
   const appHome = resolveAppHome({
     env: process.env,
     fallbackRoot: path.resolve(__dirname, "..", ".."),
@@ -27,8 +34,12 @@ function readConfig() {
     cyberbossHome: appHome,
     workspaceId: readPrefixedEnv(process.env, "WORKSPACE_ID") || "default",
     workspaceRoot,
+    timezone: timezoneConfig.timezone,
+    timezoneSource: timezoneConfig.source,
+    timezoneExplicit: timezoneConfig.explicit,
+    timelineStateTimezone: timezoneConfig.timelineStateTimezone,
     diaryDir: readPrefixedEnv(process.env, "DIARY_DIR") || path.join(stateDir, "diary"),
-    timelineStateDir: readPrefixedEnv(process.env, "TIMELINE_STATE_DIR") || stateDir,
+    timelineStateDir,
     userName: readPrefixedEnv(process.env, "USER_NAME") || "用户",
     userGender: readPrefixedEnv(process.env, "USER_GENDER") || "female",
     allowedUserIds: readPrefixedListEnv(process.env, "ALLOWED_USER_IDS"),
@@ -47,10 +58,15 @@ function readConfig() {
     accountsDir: path.join(stateDir, "accounts"),
     logDir: path.join(stateDir, "logs"),
     reminderQueueFile: path.join(stateDir, "reminder-queue.json"),
-    systemMessageQueueFile: path.join(stateDir, "system-message-queue.json"),
-    timelineScreenshotQueueFile: path.join(stateDir, "timeline-screenshot-queue.json"),
-    weixinInstructionsFile: path.join(stateDir, "weixin-instructions.md"),
+    systemMessageQueueFile: path.join(stateDir, "system-message-queue.json"),
+    timelineScreenshotQueueFile: path.join(stateDir, "timeline-screenshot-queue.json"),
+    weixinInstructionsFile: readPrefixedEnv(process.env, "WEIXIN_INSTRUCTIONS_FILE")
+      || path.resolve(__dirname, "..", "..", "templates", "weixin-instructions.md"),
+    weixinInstructionsOverlayFile: readPrefixedEnv(process.env, "WEIXIN_INSTRUCTIONS_OVERLAY_FILE")
+      || path.join(stateDir, "weixin-instructions.local.md"),
     weixinOperationsFile: path.resolve(__dirname, "..", "..", "templates", "weixin-operations.md"),
+    weixinOperationsOverlayFile: readPrefixedEnv(process.env, "WEIXIN_OPERATIONS_OVERLAY_FILE")
+      || path.join(stateDir, "weixin-operations.local.md"),
     syncBufferDir: path.join(stateDir, "sync-buffers"),
     codexEndpoint: readPrefixedEnv(process.env, "CODEX_ENDPOINT"),
     codexCommand: readPrefixedEnv(process.env, "CODEX_COMMAND"),
@@ -59,11 +75,11 @@ function readConfig() {
     workspaceBootstrapConfigFile: readPrefixedEnv(process.env, "WORKSPACE_BOOTSTRAP_CONFIG")
       || path.join(stateDir, "workspace-bootstrap.json"),
     projectRadarConfigFile: readPrefixedEnv(process.env, "PROJECT_RADAR_CONFIG")
-      || path.resolve(workspaceRoot, ".codex", "code-projects.json"),
+      || resolveCrossPlatformPathFromRoot(workspaceRoot, ".codex", "code-projects.json"),
     durableNoteSchemaConfigFile: readPrefixedEnv(process.env, "DURABLE_NOTE_SCHEMA_CONFIG")
-      || path.resolve(workspaceRoot, ".codex", "durable-note-schema.json"),
+      || resolveCrossPlatformPathFromRoot(workspaceRoot, ".codex", "durable-note-schema.json"),
     reviewSchemaConfigFile: readPrefixedEnv(process.env, "REVIEW_SCHEMA_CONFIG")
-      || path.resolve(workspaceRoot, ".codex", "review-schema.json"),
+      || resolveCrossPlatformPathFromRoot(workspaceRoot, ".codex", "review-schema.json"),
     reviewSemanticMode: readPrefixedEnv(process.env, "REVIEW_SEMANTIC_MODE") || "hybrid",
     reviewSemanticModel: readPrefixedEnv(process.env, "REVIEW_SEMANTIC_MODEL"),
     reviewSemanticTimeoutMs: readPrefixedIntEnv(process.env, "REVIEW_SEMANTIC_TIMEOUT_MS") || 120000,
@@ -72,13 +88,13 @@ function readConfig() {
     startWithCheckin: (mode === "start" && hasArgFlag(argv, "--checkin")) || readPrefixedBoolEnv(process.env, "ENABLE_CHECKIN"),
   };
 }
-
-function normalizeWeixinReplyMode(value) {
-  return String(value || "").trim().toLowerCase() === "settled" ? "settled" : "stream";
-}
-
+
+function normalizeWeixinReplyMode(value) {
+  return String(value || "").trim().toLowerCase() === "settled" ? "settled" : "stream";
+}
+
 function hasArgFlag(argv, flag) {
   return Array.isArray(argv) && argv.some((item) => String(item || "").trim() === flag);
 }
-
-module.exports = { readConfig };
+
+module.exports = { readConfig };

package/src/core/default-targets.js

@@ -1,163 +1,163 @@
-const { loadPersistedContextTokens } = require("../adapters/channel/weixin/context-token-store");
-
-function resolvePreferredSenderId({
-  config,
-  accountId,
-  explicitUser = "",
-  sessionStore = null,
-}) {
-  const normalizedExplicitUser = normalizeText(explicitUser);
-  if (normalizedExplicitUser) {
-    return normalizedExplicitUser;
-  }
-
-  const configuredUsers = Array.isArray(config?.allowedUserIds)
-    ? config.allowedUserIds.map((value) => normalizeText(value)).filter(Boolean)
-    : [];
-  if (configuredUsers.length) {
-    return configuredUsers[0];
-  }
-
-  const bindingCandidates = collectBindingSenderIds({ config, accountId, sessionStore });
-  if (bindingCandidates.length === 1) {
-    return bindingCandidates[0];
-  }
-
-  const persistedUserIds = Object.keys(loadPersistedContextTokens(config, accountId) || {})
-    .map((value) => normalizeText(value))
-    .filter(Boolean);
-  if (persistedUserIds.length === 1) {
-    return persistedUserIds[0];
-  }
-
-  return "";
-}
-
-function resolvePreferredWorkspaceRoot({
-  config,
-  accountId,
-  senderId = "",
-  explicitWorkspace = "",
-  sessionStore = null,
-}) {
-  const normalizedExplicitWorkspace = normalizeText(explicitWorkspace);
-  if (normalizedExplicitWorkspace) {
-    return normalizedExplicitWorkspace;
-  }
-
-  const normalizedSenderId = normalizeText(senderId);
-  const normalizedAccountId = normalizeText(accountId);
-  const store = sessionStore && typeof sessionStore.getBinding === "function"
-    ? sessionStore
-    : null;
-
-  if (store && normalizedSenderId && normalizedAccountId) {
-    const bindingKey = store.buildBindingKey({
-      workspaceId: config.workspaceId,
-      accountId: normalizedAccountId,
-      senderId: normalizedSenderId,
-    });
-    const activeWorkspaceRoot = normalizeText(store.getActiveWorkspaceRoot(bindingKey));
-    if (activeWorkspaceRoot) {
-      return activeWorkspaceRoot;
-    }
-
-    const binding = store.getBinding(bindingKey);
-    const boundWorkspaceRoots = collectWorkspaceRoots(binding);
-    if (boundWorkspaceRoots.length === 1) {
-      return boundWorkspaceRoots[0];
-    }
-  }
-
-  const globalWorkspaceCandidates = collectBindingWorkspaceRoots({ config, accountId, sessionStore: store });
-  if (globalWorkspaceCandidates.length === 1) {
-    return globalWorkspaceCandidates[0];
-  }
-
-  return normalizeText(config?.workspaceRoot);
-}
-
-function collectBindingSenderIds({ config, accountId, sessionStore }) {
-  const store = sessionStore && typeof sessionStore.getBinding === "function"
-    ? sessionStore
-    : null;
-  if (!store) {
-    return [];
-  }
-  const normalizedAccountId = normalizeText(accountId);
-  if (!normalizedAccountId) {
-    return [];
-  }
-
-  const senderIds = new Set();
-  for (const binding of Object.values(store.state?.bindings || {})) {
-    const bindingAccountId = normalizeText(binding?.accountId);
-    const bindingWorkspaceId = normalizeText(binding?.workspaceId);
-    const senderId = normalizeText(binding?.senderId);
-    if (!senderId || bindingAccountId !== normalizedAccountId) {
-      continue;
-    }
-    if (bindingWorkspaceId && bindingWorkspaceId !== normalizeText(config?.workspaceId)) {
-      continue;
-    }
-    senderIds.add(senderId);
-  }
-  return Array.from(senderIds).sort((left, right) => left.localeCompare(right));
-}
-
-function collectBindingWorkspaceRoots({ config, accountId, sessionStore }) {
-  const store = sessionStore && typeof sessionStore.getBinding === "function"
-    ? sessionStore
-    : null;
-  if (!store) {
-    return [];
-  }
-  const normalizedAccountId = normalizeText(accountId);
-  const workspaceRoots = new Set();
-
-  for (const binding of Object.values(store.state?.bindings || {})) {
-    const bindingAccountId = normalizeText(binding?.accountId);
-    const bindingWorkspaceId = normalizeText(binding?.workspaceId);
-    if (bindingAccountId !== normalizedAccountId) {
-      continue;
-    }
-    if (bindingWorkspaceId && bindingWorkspaceId !== normalizeText(config?.workspaceId)) {
-      continue;
-    }
-    for (const workspaceRoot of collectWorkspaceRoots(binding)) {
-      workspaceRoots.add(workspaceRoot);
-    }
-  }
-
-  return Array.from(workspaceRoots).sort((left, right) => left.localeCompare(right));
-}
-
-function collectWorkspaceRoots(binding) {
-  const workspaceRoots = new Set();
-  const activeWorkspaceRoot = normalizeText(binding?.activeWorkspaceRoot);
-  if (activeWorkspaceRoot) {
-    workspaceRoots.add(activeWorkspaceRoot);
-  }
-  for (const workspaceRoot of Object.keys(binding?.threadIdByWorkspaceRoot || {})) {
-    const normalizedWorkspaceRoot = normalizeText(workspaceRoot);
-    if (normalizedWorkspaceRoot) {
-      workspaceRoots.add(normalizedWorkspaceRoot);
-    }
-  }
-  for (const workspaceRoot of Object.keys(binding?.codexParamsByWorkspaceRoot || {})) {
-    const normalizedWorkspaceRoot = normalizeText(workspaceRoot);
-    if (normalizedWorkspaceRoot) {
-      workspaceRoots.add(normalizedWorkspaceRoot);
-    }
-  }
-  return Array.from(workspaceRoots).sort((left, right) => left.localeCompare(right));
-}
-
-function normalizeText(value) {
-  return typeof value === "string" ? value.trim() : "";
-}
-
-module.exports = {
-  resolvePreferredSenderId,
-  resolvePreferredWorkspaceRoot,
-};
+const { loadPersistedContextTokens } = require("../adapters/channel/weixin/context-token-store");
+
+function resolvePreferredSenderId({
+  config,
+  accountId,
+  explicitUser = "",
+  sessionStore = null,
+}) {
+  const normalizedExplicitUser = normalizeText(explicitUser);
+  if (normalizedExplicitUser) {
+    return normalizedExplicitUser;
+  }
+
+  const configuredUsers = Array.isArray(config?.allowedUserIds)
+    ? config.allowedUserIds.map((value) => normalizeText(value)).filter(Boolean)
+    : [];
+  if (configuredUsers.length) {
+    return configuredUsers[0];
+  }
+
+  const bindingCandidates = collectBindingSenderIds({ config, accountId, sessionStore });
+  if (bindingCandidates.length === 1) {
+    return bindingCandidates[0];
+  }
+
+  const persistedUserIds = Object.keys(loadPersistedContextTokens(config, accountId) || {})
+    .map((value) => normalizeText(value))
+    .filter(Boolean);
+  if (persistedUserIds.length === 1) {
+    return persistedUserIds[0];
+  }
+
+  return "";
+}
+
+function resolvePreferredWorkspaceRoot({
+  config,
+  accountId,
+  senderId = "",
+  explicitWorkspace = "",
+  sessionStore = null,
+}) {
+  const normalizedExplicitWorkspace = normalizeText(explicitWorkspace);
+  if (normalizedExplicitWorkspace) {
+    return normalizedExplicitWorkspace;
+  }
+
+  const normalizedSenderId = normalizeText(senderId);
+  const normalizedAccountId = normalizeText(accountId);
+  const store = sessionStore && typeof sessionStore.getBinding === "function"
+    ? sessionStore
+    : null;
+
+  if (store && normalizedSenderId && normalizedAccountId) {
+    const bindingKey = store.buildBindingKey({
+      workspaceId: config.workspaceId,
+      accountId: normalizedAccountId,
+      senderId: normalizedSenderId,
+    });
+    const activeWorkspaceRoot = normalizeText(store.getActiveWorkspaceRoot(bindingKey));
+    if (activeWorkspaceRoot) {
+      return activeWorkspaceRoot;
+    }
+
+    const binding = store.getBinding(bindingKey);
+    const boundWorkspaceRoots = collectWorkspaceRoots(binding);
+    if (boundWorkspaceRoots.length === 1) {
+      return boundWorkspaceRoots[0];
+    }
+  }
+
+  const globalWorkspaceCandidates = collectBindingWorkspaceRoots({ config, accountId, sessionStore: store });
+  if (globalWorkspaceCandidates.length === 1) {
+    return globalWorkspaceCandidates[0];
+  }
+
+  return normalizeText(config?.workspaceRoot);
+}
+
+function collectBindingSenderIds({ config, accountId, sessionStore }) {
+  const store = sessionStore && typeof sessionStore.getBinding === "function"
+    ? sessionStore
+    : null;
+  if (!store) {
+    return [];
+  }
+  const normalizedAccountId = normalizeText(accountId);
+  if (!normalizedAccountId) {
+    return [];
+  }
+
+  const senderIds = new Set();
+  for (const binding of Object.values(store.state?.bindings || {})) {
+    const bindingAccountId = normalizeText(binding?.accountId);
+    const bindingWorkspaceId = normalizeText(binding?.workspaceId);
+    const senderId = normalizeText(binding?.senderId);
+    if (!senderId || bindingAccountId !== normalizedAccountId) {
+      continue;
+    }
+    if (bindingWorkspaceId && bindingWorkspaceId !== normalizeText(config?.workspaceId)) {
+      continue;
+    }
+    senderIds.add(senderId);
+  }
+  return Array.from(senderIds).sort((left, right) => left.localeCompare(right));
+}
+
+function collectBindingWorkspaceRoots({ config, accountId, sessionStore }) {
+  const store = sessionStore && typeof sessionStore.getBinding === "function"
+    ? sessionStore
+    : null;
+  if (!store) {
+    return [];
+  }
+  const normalizedAccountId = normalizeText(accountId);
+  const workspaceRoots = new Set();
+
+  for (const binding of Object.values(store.state?.bindings || {})) {
+    const bindingAccountId = normalizeText(binding?.accountId);
+    const bindingWorkspaceId = normalizeText(binding?.workspaceId);
+    if (bindingAccountId !== normalizedAccountId) {
+      continue;
+    }
+    if (bindingWorkspaceId && bindingWorkspaceId !== normalizeText(config?.workspaceId)) {
+      continue;
+    }
+    for (const workspaceRoot of collectWorkspaceRoots(binding)) {
+      workspaceRoots.add(workspaceRoot);
+    }
+  }
+
+  return Array.from(workspaceRoots).sort((left, right) => left.localeCompare(right));
+}
+
+function collectWorkspaceRoots(binding) {
+  const workspaceRoots = new Set();
+  const activeWorkspaceRoot = normalizeText(binding?.activeWorkspaceRoot);
+  if (activeWorkspaceRoot) {
+    workspaceRoots.add(activeWorkspaceRoot);
+  }
+  for (const workspaceRoot of Object.keys(binding?.threadIdByWorkspaceRoot || {})) {
+    const normalizedWorkspaceRoot = normalizeText(workspaceRoot);
+    if (normalizedWorkspaceRoot) {
+      workspaceRoots.add(normalizedWorkspaceRoot);
+    }
+  }
+  for (const workspaceRoot of Object.keys(binding?.codexParamsByWorkspaceRoot || {})) {
+    const normalizedWorkspaceRoot = normalizeText(workspaceRoot);
+    if (normalizedWorkspaceRoot) {
+      workspaceRoots.add(normalizedWorkspaceRoot);
+    }
+  }
+  return Array.from(workspaceRoots).sort((left, right) => left.localeCompare(right));
+}
+
+function normalizeText(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+module.exports = {
+  resolvePreferredSenderId,
+  resolvePreferredWorkspaceRoot,
+};

package/src/core/durable-note-schema.js

@@ -3,6 +3,11 @@ const path = require("path");
 
 const { listTrackedProjects } = require("./project-radar");
 const { appendSection, findSectionRange, resolveNoteSyncTarget } = require("./note-sync");
+const {
+  normalizeDisplayPath,
+  resolveCrossPlatformPath,
+  resolveCrossPlatformPathFromRoot,
+} = require("./path-utils");
 
 function loadDurableNoteSchemaConfig(config = {}) {
   const filePath = normalizeText(config.durableNoteSchemaConfigFile);
@@ -26,7 +31,7 @@ function loadDurableNoteSchemaConfig(config = {}) {
 }
 
 function resolveDurableNoteProfile(config = {}) {
-  const workspaceRoot = normalizeDisplayPath(path.resolve(String(config.workspaceRoot || process.cwd())));
+  const workspaceRoot = resolveCrossPlatformPath(String(config.workspaceRoot || process.cwd()));
   const schemaConfig = loadDurableNoteSchemaConfig(config);
   const workspaceProfile = selectWorkspaceProfile(schemaConfig.workspaces, workspaceRoot);
   const projectDefaults = normalizeFamily(workspaceProfile?.projectDefaults);
@@ -285,10 +290,10 @@ function resolveWorkspaceNotePath(workspaceRoot, targetPath) {
   if (!normalizedTargetPath) {
     return "";
   }
-  if (path.isAbsolute(normalizedTargetPath)) {
-    return normalizeDisplayPath(path.resolve(normalizedTargetPath));
+  if (path.isAbsolute(normalizedTargetPath) || path.win32.isAbsolute(normalizedTargetPath)) {
+    return resolveCrossPlatformPath(normalizedTargetPath);
   }
-  return normalizeDisplayPath(path.resolve(workspaceRoot, ...normalizedTargetPath.split("/")));
+  return resolveCrossPlatformPathFromRoot(workspaceRoot, ...normalizedTargetPath.split("/"));
 }
 
 function listAvailableScopes(profile) {
@@ -299,10 +304,6 @@ function normalizeText(value) {
   return typeof value === "string" ? value.trim() : "";
 }
 
-function normalizeDisplayPath(targetPath) {
-  return normalizeText(targetPath).replace(/\\/g, "/");
-}
-
 function normalizeLineEnding(value) {
   return String(value || "").replace(/\r\n/g, "\n");
 }

package/src/core/instructions-template.js

@@ -1,14 +1,14 @@
-function resolveUserPronoun(gender) {
-  const normalized = String(gender || "").trim().toLowerCase();
-  if (normalized === "male" || normalized === "man" || normalized === "m" || normalized === "男") {
-    return "他";
-  }
-  if (normalized === "neutral" || normalized === "nonbinary" || normalized === "nb" || normalized === "ta") {
-    return "TA";
-  }
-  return "她";
-}
-
+function resolveUserPronoun(gender) {
+  const normalized = String(gender || "").trim().toLowerCase();
+  if (normalized === "male" || normalized === "man" || normalized === "m" || normalized === "男") {
+    return "他";
+  }
+  if (normalized === "neutral" || normalized === "nonbinary" || normalized === "nb" || normalized === "ta") {
+    return "TA";
+  }
+  return "她";
+}
+
 function renderInstructionTemplate(template, config = {}) {
   const userName = String(config?.userName || "").trim() || "用户";
   const pronoun = resolveUserPronoun(config?.userGender);
@@ -21,11 +21,12 @@ function renderInstructionTemplate(template, config = {}) {
   ).trim();
   return String(template || "")
     .replaceAll("{{USER_NAME}}", userName)
+    .replaceAll("{{CODEKSEI_HOME}}", codekseiHome)
     .replaceAll("{{CYBERBOSS_HOME}}", codekseiHome)
     .replaceAll("她", pronoun);
 }
-
-module.exports = {
-  renderInstructionTemplate,
-  resolveUserPronoun,
-};
+
+module.exports = {
+  renderInstructionTemplate,
+  resolveUserPronoun,
+};

package/src/core/note-sync.js

@@ -4,6 +4,11 @@ const {
   PRIMARY_NOTE_SYNC_MARKER_PREFIX,
   LEGACY_NOTE_SYNC_MARKER_PREFIX,
 } = require("./branding");
+const {
+  normalizeDisplayPath,
+  resolveCrossPlatformPath,
+  resolveCrossPlatformPathFromRoot,
+} = require("./path-utils");
 
 const { listTrackedProjects } = require("./project-radar");
 
@@ -42,11 +47,11 @@ function resolveNoteSyncTarget(config = {}, options = {}) {
 }
 
 function resolveNotePath(workspaceRoot, targetPath) {
-  if (path.isAbsolute(targetPath)) {
-    return normalizeDisplayPath(path.resolve(targetPath));
+  if (path.isAbsolute(targetPath) || path.win32.isAbsolute(targetPath)) {
+    return resolveCrossPlatformPath(targetPath);
   }
   const baseRoot = normalizeText(workspaceRoot) || process.cwd();
-  return normalizeDisplayPath(path.resolve(baseRoot, targetPath));
+  return resolveCrossPlatformPathFromRoot(baseRoot, targetPath);
 }
 
 function syncNoteFile(options = {}) {
@@ -397,10 +402,6 @@ function normalizeComparableText(value) {
   return normalizeParagraphText(value).replace(/\s+/gu, " ").toLowerCase();
 }
 
-function normalizeDisplayPath(targetPath) {
-  return normalizeText(targetPath).replace(/\\/g, "/");
-}
-
 function normalizeFileEnding(value) {
   return String(value || "").replace(/\r\n/g, "\n");
 }

package/src/core/path-utils.js

@@ -0,0 +1,54 @@
+const path = require("path");
+
+function normalizeText(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function normalizeDisplayPath(targetPath) {
+  return normalizeText(targetPath).replace(/\\/g, "/");
+}
+
+function isCrossPlatformAbsolutePath(targetPath) {
+  const normalized = normalizeText(targetPath);
+  if (!normalized) {
+    return false;
+  }
+  return path.isAbsolute(normalized) || path.win32.isAbsolute(normalized);
+}
+
+function resolveCrossPlatformPath(targetPath) {
+  const normalized = normalizeText(targetPath);
+  if (!normalized) {
+    return "";
+  }
+  if (isCrossPlatformAbsolutePath(normalized)) {
+    return normalizeDisplayPath(normalized);
+  }
+  return normalizeDisplayPath(path.resolve(normalized));
+}
+
+function resolveCrossPlatformPathFromRoot(rootPath, ...segments) {
+  const normalizedRoot = normalizeText(rootPath);
+  const normalizedSegments = segments
+    .flat()
+    .map((segment) => normalizeText(segment))
+    .filter(Boolean);
+
+  if (!normalizedRoot) {
+    return resolveCrossPlatformPath(path.join(...normalizedSegments));
+  }
+
+  // CI often runs on Linux even when users configure Windows absolute roots.
+  // Preserve those roots instead of reinterpreting `E:/...` as `<cwd>/E:/...`.
+  if (path.win32.isAbsolute(normalizedRoot) && !path.isAbsolute(normalizedRoot)) {
+    return normalizeDisplayPath(path.win32.resolve(normalizedRoot, ...normalizedSegments));
+  }
+  return normalizeDisplayPath(path.resolve(normalizedRoot, ...normalizedSegments));
+}
+
+module.exports = {
+  isCrossPlatformAbsolutePath,
+  normalizeDisplayPath,
+  resolveCrossPlatformPath,
+  resolveCrossPlatformPathFromRoot,
+};

package/src/core/project-radar.js

@@ -1,12 +1,17 @@
 const fs = require("fs");
 const path = require("path");
 const { spawnSync } = require("child_process");
+const {
+  normalizeDisplayPath,
+  resolveCrossPlatformPath,
+  resolveCrossPlatformPathFromRoot,
+} = require("./path-utils");
 
 function loadProjectRadarConfig(config = {}) {
-  const workspaceRoot = normalizeDisplayPath(path.resolve(String(config.workspaceRoot || process.cwd())));
-  const configFile = normalizeDisplayPath(path.resolve(String(
+  const workspaceRoot = resolveCrossPlatformPath(String(config.workspaceRoot || process.cwd()));
+  const configFile = resolveCrossPlatformPath(String(
     config.projectRadarConfigFile || path.join(workspaceRoot, ".codex", "code-projects.json")
-  )));
+  ));
 
   let raw = "";
   try {
@@ -196,7 +201,7 @@ function buildMissingRepoFacts(repoRoot) {
 function buildWorkspaceFileInfo(root, relativePath, kind) {
   const normalizedRelativePath = normalizeRelativePath(relativePath);
   const absolutePath = normalizedRelativePath
-    ? normalizeDisplayPath(path.resolve(root, ...normalizedRelativePath.split("/")))
+    ? resolveCrossPlatformPathFromRoot(root, ...normalizedRelativePath.split("/"))
     : "";
   return {
     kind,
@@ -218,9 +223,9 @@ function normalizeProjectEntry(entry, workspaceRoot) {
     slug,
     title: normalizeText(project.title) || slug,
     aliases: normalizeAliases(project.aliases),
-    repoRoot: normalizeDisplayPath(path.resolve(repoRoot)),
+    repoRoot: resolveCrossPlatformPath(repoRoot),
     notePath,
-    noteAbsolutePath: normalizeDisplayPath(path.resolve(workspaceRoot, ...notePath.split("/"))),
+    noteAbsolutePath: resolveCrossPlatformPathFromRoot(workspaceRoot, ...notePath.split("/")),
     overviewFiles: normalizeRelativePathList(project.overviewFiles),
     graphReportPath: normalizeRelativePath(project.graphReportPath),
     timelineLabel: normalizeText(project.timelineLabel),
@@ -383,10 +388,6 @@ function normalizeCommandStderr(value) {
   return String(value || "").replace(/\r\n/g, "\n").trim();
 }
 
-function normalizeDisplayPath(targetPath) {
-  return normalizeText(targetPath).replace(/\\/g, "/");
-}
-
 function normalizeText(value) {
   return typeof value === "string" ? value.trim() : "";
 }