Merge dev into main

Cargo.toml

@@ -9,7 +9,7 @@ members = [
 ]
 
 [workspace.package]
-version = "2026.10323.10152"
+version = "2026.10323.10738"
 edition = "2024"
 license = "AGPL-3.0-only"
 authors = ["TrueNine"]

cli/npm/darwin-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truenine/memory-sync-cli-darwin-arm64",
-  "version": "2026.10323.10152",
+  "version": "2026.10323.10738",
   "os": [
     "darwin"
   ],

cli/npm/darwin-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truenine/memory-sync-cli-darwin-x64",
-  "version": "2026.10323.10152",
+  "version": "2026.10323.10738",
   "os": [
     "darwin"
   ],

cli/npm/linux-arm64-gnu/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truenine/memory-sync-cli-linux-arm64-gnu",
-  "version": "2026.10323.10152",
+  "version": "2026.10323.10738",
   "os": [
     "linux"
   ],

cli/npm/linux-x64-gnu/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truenine/memory-sync-cli-linux-x64-gnu",
-  "version": "2026.10323.10152",
+  "version": "2026.10323.10738",
   "os": [
     "linux"
   ],

cli/npm/win32-x64-msvc/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truenine/memory-sync-cli-win32-x64-msvc",
-  "version": "2026.10323.10152",
+  "version": "2026.10323.10738",
   "os": [
     "win32"
   ],

cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@truenine/memory-sync-cli",
   "type": "module",
-  "version": "2026.10323.10152",
+  "version": "2026.10323.10738",
   "description": "TrueNine Memory Synchronization CLI",
   "author": "TrueNine",
   "license": "AGPL-3.0-only",

cli/src/ConfigLoader.ts

@@ -7,11 +7,10 @@ import type {
   ILogger,
   OutputScopeOptions,
   PluginOutputScopeTopics,
-  UserConfigFile
+  UserConfigFile,
+  WindowsOptions
 } from './plugins/plugin-core'
 import * as fs from 'node:fs'
-import * as os from 'node:os'
-import * as path from 'node:path'
 import process from 'node:process'
 import {
   buildConfigDiagnostic,
@@ -20,6 +19,13 @@ import {
   splitDiagnosticText
 } from './diagnostics'
 import {createLogger, ZUserConfigFile} from './plugins/plugin-core'
+import {
+  getRequiredGlobalConfigPath,
+  resolveRuntimeEnvironment,
+  resolveUserPath,
+  DEFAULT_GLOBAL_CONFIG_FILE_NAME as RUNTIME_DEFAULT_CONFIG_FILE_NAME,
+  DEFAULT_GLOBAL_CONFIG_DIR as RUNTIME_DEFAULT_GLOBAL_CONFIG_DIR
+} from './runtime-environment'
 
 /**
  * Default config file name
@@ -35,7 +41,7 @@ export const DEFAULT_GLOBAL_CONFIG_DIR = '.aindex'
  * Get global config file path
  */
 export function getGlobalConfigPath(): string {
-  return path.join(os.homedir(), DEFAULT_GLOBAL_CONFIG_DIR, DEFAULT_CONFIG_FILE_NAME)
+  return getRequiredGlobalConfigPath()
 }
 
 /**
@@ -67,7 +73,22 @@ export class ConfigLoader {
 
   getSearchPaths(cwd: string = process.cwd()): string[] {
     void cwd
-    return [getGlobalConfigPath()]
+    const runtimeEnvironment = resolveRuntimeEnvironment()
+
+    if (!runtimeEnvironment.isWsl) return [getRequiredGlobalConfigPath()]
+
+    this.logger.info('wsl environment detected', {
+      effectiveHomeDir: runtimeEnvironment.effectiveHomeDir
+    })
+    if (runtimeEnvironment.selectedGlobalConfigPath == null) {
+      throw new Error(
+        `WSL host config file not found under "${runtimeEnvironment.windowsUsersRoot}/*/${DEFAULT_GLOBAL_CONFIG_DIR}/${DEFAULT_CONFIG_FILE_NAME}".`
+      )
+    }
+    this.logger.info('using wsl host global config', {
+      path: runtimeEnvironment.selectedGlobalConfigPath
+    })
+    return [getRequiredGlobalConfigPath()]
   }
 
   loadFromFile(filePath: string): ConfigLoadResult {
@@ -147,14 +168,16 @@ export class ConfigLoader {
         acc.cleanupProtection,
         config.cleanupProtection
       )
+      const mergedWindows = this.mergeWindowsOptions(acc.windows, config.windows)
 
       return {
         ...acc,
         ...config,
         ...mergedAindex != null ? {aindex: mergedAindex} : {},
         ...mergedOutputScopes != null ? {outputScopes: mergedOutputScopes} : {},
         ...mergedFrontMatter != null ? {frontMatter: mergedFrontMatter} : {},
-        ...mergedCleanupProtection != null ? {cleanupProtection: mergedCleanupProtection} : {}
+        ...mergedCleanupProtection != null ? {cleanupProtection: mergedCleanupProtection} : {},
+        ...mergedWindows != null ? {windows: mergedWindows} : {}
       }
     }, {})
   }
@@ -237,9 +260,30 @@ export class ConfigLoader {
     }
   }
 
+  private mergeWindowsOptions(
+    a?: WindowsOptions,
+    b?: WindowsOptions
+  ): WindowsOptions | undefined {
+    if (a == null && b == null) return void 0
+    if (a == null) return b
+    if (b == null) return a
+
+    return {
+      ...a,
+      ...b,
+      ...a.wsl2 != null || b.wsl2 != null
+        ? {
+            wsl2: {
+              ...a.wsl2,
+              ...b.wsl2
+            }
+          }
+        : {}
+    }
+  }
+
   private resolveTilde(p: string): string {
-    if (p.startsWith('~')) return path.join(os.homedir(), p.slice(1))
-    return p
+    return p.startsWith('~') ? resolveUserPath(p) : p
   }
 }
 
@@ -283,7 +327,29 @@ export function loadUserConfig(cwd?: string): MergedConfigResult {
  */
 export function validateGlobalConfig(): GlobalConfigValidationResult {
   const logger = createLogger('ConfigLoader')
-  const configPath = getGlobalConfigPath()
+  let configPath: string
+
+  try {
+    configPath = getRequiredGlobalConfigPath()
+  }
+  catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error)
+    logger.error(buildConfigDiagnostic({
+      code: 'GLOBAL_CONFIG_PATH_RESOLUTION_FAILED',
+      title: 'Failed to resolve global config path',
+      reason: diagnosticLines(errorMessage),
+      configPath: `${RUNTIME_DEFAULT_GLOBAL_CONFIG_DIR}/${RUNTIME_DEFAULT_CONFIG_FILE_NAME}`,
+      exactFix: diagnosticLines(
+        'Ensure the required global config exists in the expected runtime-specific location before running tnmsc again.'
+      )
+    }))
+    return {
+      valid: false,
+      exists: false,
+      errors: [errorMessage],
+      shouldExit: true
+    }
+  }
 
   if (!fs.existsSync(configPath)) { // Check if config file exists - do not auto-create
     const error = `Global config not found at ${configPath}. Please create it manually.`

cli/src/ProtectedDeletionGuard.ts

@@ -1,12 +1,12 @@
 import type {ILogger, OutputCollectedContext, PluginOptions} from './plugins/plugin-core'
 import type {PublicDefinitionResolveOptions} from './public-config-paths'
 import * as fs from 'node:fs'
-import * as os from 'node:os'
 import * as path from 'node:path'
 import process from 'node:process'
 import glob from 'fast-glob'
 import {buildProtectedDeletionDiagnostic} from './diagnostics'
 import {collectKnownPublicConfigDefinitionPaths} from './public-config-paths'
+import {getEffectiveHomeDir, resolveUserPath} from './runtime-environment'
 
 interface DirPathLike {
   readonly path: string
@@ -126,8 +126,7 @@ function resolveAbsolutePathFromDir(dir: DirPathLike | undefined): string | unde
 }
 
 export function expandHomePath(rawPath: string): string {
-  if (rawPath === '~') return os.homedir()
-  if (rawPath.startsWith('~/') || rawPath.startsWith('~\\')) return path.resolve(os.homedir(), rawPath.slice(2))
+  if (rawPath === '~' || rawPath.startsWith('~/') || rawPath.startsWith('~\\')) return resolveUserPath(rawPath)
   return rawPath
 }
 
@@ -256,7 +255,7 @@ function detectPathProtectionMode(rawPath: string, fallback: ProtectionMode): Pr
 }
 
 function collectBuiltInDangerousPathRules(): ProtectedPathRule[] {
-  const homeDir = os.homedir()
+  const homeDir = getEffectiveHomeDir()
 
   return [
     createProtectedPathRule(path.parse(homeDir).root, 'direct', 'built-in dangerous root path', 'built-in-dangerous-root'),

cli/src/commands/ConfigCommand.ts

@@ -1,9 +1,8 @@
 import type {Command, CommandContext, CommandResult} from './Command'
 import * as fs from 'node:fs'
-import * as os from 'node:os'
 import * as path from 'node:path'
-import {DEFAULT_CONFIG_FILE_NAME, DEFAULT_GLOBAL_CONFIG_DIR} from '@/ConfigLoader'
 import {buildUsageDiagnostic, diagnosticLines} from '@/diagnostics'
+import {getRequiredGlobalConfigPath} from '@/runtime-environment'
 
 /**
  * Valid configuration keys that can be set via `tnmsc config key=value`.
@@ -53,7 +52,7 @@ function isValidLogLevel(value: string): boolean {
  * Get global config file path
  */
 function getGlobalConfigPath(): string {
-  return path.join(os.homedir(), DEFAULT_GLOBAL_CONFIG_DIR, DEFAULT_CONFIG_FILE_NAME)
+  return getRequiredGlobalConfigPath()
 }
 
 /**
@@ -157,7 +156,21 @@ export class ConfigCommand implements Command {
       }
     }
 
-    const config = readGlobalConfig() // Read existing config
+    let config: ConfigObject
+
+    try {
+      config = readGlobalConfig()
+    }
+    catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error)
+      return {
+        success: false,
+        filesAffected: 0,
+        dirsAffected: 0,
+        message: errorMessage
+      }
+    }
+
     const errors: string[] = []
     const updated: string[] = []
 
@@ -209,7 +222,18 @@ export class ConfigCommand implements Command {
     }
 
     if (updated.length > 0) { // Write config if there are valid updates
-      writeGlobalConfig(config)
+      try {
+        writeGlobalConfig(config)
+      }
+      catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error)
+        return {
+          success: false,
+          filesAffected: 0,
+          dirsAffected: 0,
+          message: errorMessage
+        }
+      }
       logger.info('global config written', {path: getGlobalConfigPath()})
     }
 

cli/src/commands/DryRunOutputCommand.ts

@@ -1,5 +1,7 @@
 import type {Command, CommandContext, CommandResult} from './Command'
+import {syncWindowsConfigIntoWsl} from '@/wsl-mirror-sync'
 import {
+  collectOutputDeclarations,
   executeDeclarativeWriteOutputs
 } from '../plugins/plugin-core'
 
@@ -14,7 +16,8 @@ export class DryRunOutputCommand implements Command {
     logger.info('started', {command: 'dry-run-output', dryRun: true})
 
     const writeCtx = createWriteContext(true)
-    const results = await executeDeclarativeWriteOutputs(outputPlugins, writeCtx)
+    const predeclaredOutputs = await collectOutputDeclarations(outputPlugins, writeCtx)
+    const results = await executeDeclarativeWriteOutputs(outputPlugins, writeCtx, predeclaredOutputs)
 
     let totalFiles = 0
     let totalDirs = 0
@@ -24,6 +27,18 @@ export class DryRunOutputCommand implements Command {
       logger.info('plugin result', {plugin: pluginName, files: result.files.length, dirs: result.dirs.length, dryRun: true})
     }
 
+    const wslMirrorResult = await syncWindowsConfigIntoWsl(outputPlugins, writeCtx, void 0, predeclaredOutputs)
+    if (wslMirrorResult.errors.length > 0) {
+      return {
+        success: false,
+        filesAffected: totalFiles,
+        dirsAffected: totalDirs,
+        message: wslMirrorResult.errors.join('\n')
+      }
+    }
+
+    totalFiles += wslMirrorResult.mirroredFiles
+
     logger.info('complete', {command: 'dry-run-output', totalFiles, totalDirs, dryRun: true})
 
     return {