tokenusage-cli 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (131) hide show
  1. package/CHANGELOG.md +39 -19
  2. package/LICENSE +22 -22
  3. package/README.md +94 -94
  4. package/THIRD_PARTY_NOTICES.md +140 -140
  5. package/bin/tokenusage.js +69 -69
  6. package/package.json +59 -59
  7. package/src/cli.js +146 -134
  8. package/src/commands/device-login.js +205 -205
  9. package/src/commands/diagnostics.js +38 -38
  10. package/src/commands/doctor.js +110 -110
  11. package/src/commands/init.js +2484 -2436
  12. package/src/commands/pause.js +77 -0
  13. package/src/commands/sessions.js +29 -29
  14. package/src/commands/status.js +1758 -1747
  15. package/src/commands/sync.js +8048 -7934
  16. package/src/commands/uninstall.js +322 -312
  17. package/src/lib/account-usage-dedup.js +267 -267
  18. package/src/lib/antigravity-paths.js +48 -48
  19. package/src/lib/ark-agent-plan-limits.js +438 -438
  20. package/src/lib/ark-coding-plan-limits.js +537 -537
  21. package/src/lib/async-queue-reader.js +138 -138
  22. package/src/lib/atomic-json.js +27 -27
  23. package/src/lib/bearer-token.js +11 -11
  24. package/src/lib/categorizer-utils.js +232 -232
  25. package/src/lib/claude-categorizer.js +1343 -1343
  26. package/src/lib/claude-config.js +279 -279
  27. package/src/lib/claude-user-identity.js +56 -56
  28. package/src/lib/cli-ui.js +179 -179
  29. package/src/lib/cloud-account.js +541 -541
  30. package/src/lib/cloud-device-token.js +141 -141
  31. package/src/lib/cloud-sync-prefs.js +14 -14
  32. package/src/lib/cloud-usage-reset.js +115 -115
  33. package/src/lib/codex-config.js +595 -595
  34. package/src/lib/codex-context-breakdown.js +806 -806
  35. package/src/lib/codex-model-attribution.js +128 -128
  36. package/src/lib/codex-rollout-parser.js +1471 -1471
  37. package/src/lib/codex-service-tier.js +49 -49
  38. package/src/lib/codex-token-refresh.js +140 -140
  39. package/src/lib/codex-token-usage.js +195 -195
  40. package/src/lib/codex-usage-record.js +195 -195
  41. package/src/lib/collection-pause.js +77 -0
  42. package/src/lib/command-runner.js +313 -313
  43. package/src/lib/commandcode-limits.js +317 -317
  44. package/src/lib/context-health.js +124 -124
  45. package/src/lib/cursor-config.js +605 -605
  46. package/src/lib/cursor-store.js +1918 -1918
  47. package/src/lib/debug-flags.js +7 -7
  48. package/src/lib/devin-limits.js +249 -249
  49. package/src/lib/devin-usage.js +212 -212
  50. package/src/lib/diagnostics.js +383 -383
  51. package/src/lib/doctor.js +385 -385
  52. package/src/lib/dumate.js +95 -95
  53. package/src/lib/fs.js +455 -455
  54. package/src/lib/function-url.js +14 -14
  55. package/src/lib/gemini-config.js +291 -291
  56. package/src/lib/git-outcomes.js +243 -243
  57. package/src/lib/grok-context-breakdown.js +890 -890
  58. package/src/lib/grok-hook.js +360 -360
  59. package/src/lib/grok-limits.js +865 -865
  60. package/src/lib/grok-usage.js +98 -98
  61. package/src/lib/heatmap-compact.js +114 -114
  62. package/src/lib/ingest-sanitize.js +41 -41
  63. package/src/lib/init-flow.js +42 -42
  64. package/src/lib/install-resolver.js +170 -170
  65. package/src/lib/jsonl-lines.js +134 -134
  66. package/src/lib/kimi-model-repair.js +173 -173
  67. package/src/lib/kimi-profile.js +61 -61
  68. package/src/lib/kimi-session.js +216 -216
  69. package/src/lib/local-api.js +3588 -3588
  70. package/src/lib/machine-id.js +238 -238
  71. package/src/lib/multi-install-parser.js +113 -113
  72. package/src/lib/notify-command.js +38 -38
  73. package/src/lib/omp-hook.js +589 -589
  74. package/src/lib/openclaw-cli.js +104 -104
  75. package/src/lib/openclaw-hook.js +375 -375
  76. package/src/lib/openclaw-session-plugin.js +560 -560
  77. package/src/lib/opencode-config.js +121 -121
  78. package/src/lib/opencode-go-limits.js +807 -807
  79. package/src/lib/outcomes-engine.js +253 -253
  80. package/src/lib/passive-mode.js +219 -219
  81. package/src/lib/pet-packages.js +722 -722
  82. package/src/lib/pricing/curated-overrides.json +822 -822
  83. package/src/lib/pricing/index.js +379 -379
  84. package/src/lib/pricing/litellm-fetcher.js +172 -172
  85. package/src/lib/pricing/matcher.js +456 -456
  86. package/src/lib/pricing/seed-snapshot.json +1 -1
  87. package/src/lib/progress.js +76 -76
  88. package/src/lib/project-usage-purge.js +117 -117
  89. package/src/lib/prompt.js +24 -24
  90. package/src/lib/provider-status.js +104 -104
  91. package/src/lib/proxy-env.js +489 -489
  92. package/src/lib/proxy-settings.js +163 -163
  93. package/src/lib/qoder-cn-cli-limits.js +119 -119
  94. package/src/lib/qoder-limits.js +880 -880
  95. package/src/lib/quiet-warnings.js +26 -26
  96. package/src/lib/rollout.js +26005 -25966
  97. package/src/lib/runtime-config.js +9 -4
  98. package/src/lib/scan-roots.js +277 -277
  99. package/src/lib/scheduled-task.js +145 -0
  100. package/src/lib/sentry.js +231 -231
  101. package/src/lib/session-analytics.js +2972 -2972
  102. package/src/lib/session-performance.js +237 -237
  103. package/src/lib/session-upload.js +379 -379
  104. package/src/lib/skill-usage.js +267 -267
  105. package/src/lib/skills-manager.js +1591 -1591
  106. package/src/lib/source-metadata.js +48 -48
  107. package/src/lib/sqlite-reader.js +215 -215
  108. package/src/lib/star-cta.js +73 -73
  109. package/src/lib/subscription-manager.js +293 -293
  110. package/src/lib/subscriptions.js +508 -508
  111. package/src/lib/sync-report.js +138 -0
  112. package/src/lib/telemetry.js +193 -193
  113. package/src/lib/tracker-paths.js +16 -16
  114. package/src/lib/trae-cn-config.js +548 -548
  115. package/src/lib/trae-db.js +127 -127
  116. package/src/lib/trae-snapshot.js +230 -230
  117. package/src/lib/trae-sqlite.js +143 -143
  118. package/src/lib/trae-usage.js +121 -121
  119. package/src/lib/upload-queue.js +134 -134
  120. package/src/lib/upload-throttle.js +171 -171
  121. package/src/lib/usage-limits.js +4552 -4552
  122. package/src/lib/wrapped-aggregator.js +236 -236
  123. package/src/lib/wsl-probe.js +281 -281
  124. package/src/lib/zcode-limits.js +1172 -1172
  125. package/src/lib/zcode-reset-credits.js +66 -66
  126. package/test/audit-fixes.test.js +200 -0
  127. package/test/cli-smoke.test.js +53 -53
  128. package/test/collection-controls.test.js +181 -0
  129. package/test/ingest-sanitize.test.js +162 -162
  130. package/test/quiet-warnings.test.js +53 -53
  131. package/test/session-upload.test.js +427 -427
@@ -1,281 +1,281 @@
1
- const fssync = require("node:fs");
2
- const path = require("node:path");
3
-
4
- const DEFAULT_EXEC_OPTS = { timeout: 15000, windowsHide: true, maxBuffer: 1024 * 1024, stdio: ["ignore", "pipe", "ignore"] };
5
-
6
- let _cachedDistros = null;
7
- let _cachedDistrosError = null;
8
- const _cachedWslUsers = new Map();
9
- const _cachedWslUserErrors = new Map();
10
-
11
- function resetWslProbeCache() {
12
- _cachedDistros = null;
13
- _cachedDistrosError = null;
14
- _cachedWslUsers.clear();
15
- _cachedWslUserErrors.clear();
16
- }
17
-
18
- const WSL_MODES = new Set([
19
- "wsl-first",
20
- "native-first",
21
- "wsl-only",
22
- "native-only",
23
- "both",
24
- ]);
25
-
26
- function defaultRunWsl(args, { utf16 = false } = {}) {
27
- const { execFileSync } = require("node:child_process");
28
- const buf = execFileSync("wsl.exe", args, DEFAULT_EXEC_OPTS);
29
- return utf16 ? buf.toString("utf16le") : buf.toString("utf8");
30
- }
31
-
32
- function cleanWslOutput(raw) {
33
- return raw.replace(/\0/g, "").replace(/\uFEFF/g, "").trim();
34
- }
35
-
36
- function parseWslListVerbose(raw) {
37
- if (typeof raw !== "string") return [];
38
- const distros = [];
39
- for (const line of raw.split(/\r?\n/)) {
40
- const clean = cleanWslOutput(line);
41
- if (!clean) continue;
42
- const cells = clean.split(/\s+/);
43
- let isDefault = false;
44
- let idx = 0;
45
- if (cells[0] === "*") {
46
- isDefault = true;
47
- idx = 1;
48
- }
49
- const name = cells[idx];
50
- if (!name || name === "NAME") continue;
51
- const version = parseInt(cells[cells.length - 1], 10);
52
- distros.push({ name, version: Number.isFinite(version) ? version : null, isDefault });
53
- }
54
- return distros;
55
- }
56
-
57
- function probeWslDistros(deps = {}) {
58
- const strict = deps.strict === true;
59
- const hasDeps = Object.keys(deps).some((key) => key !== "strict");
60
- // Legacy callers retain their fail-safe cache. Strict observers may reuse
61
- // successful empty results, but must retry a failure cached by any caller.
62
- if (!hasDeps && _cachedDistros && (!strict || !_cachedDistrosError)) return _cachedDistros;
63
- const runWsl = deps.runWsl || defaultRunWsl;
64
- let raw;
65
- try {
66
- raw = runWsl(["-l", "-v"], { utf16: true });
67
- } catch (error) {
68
- let confirmedEmpty = false;
69
- if (
70
- strict && Number.isInteger(error?.status) && error.status !== 0 &&
71
- error.signal == null && (error.code == null || error.code === error.status)
72
- ) {
73
- // Some WSL builds exit nonzero for an empty verbose list. Confirm that
74
- // case with a successful empty quiet list, not localized diagnostic text.
75
- // Transport/permission/signal failures must never reach this fallback.
76
- try {
77
- const quiet = runWsl(["-l", "-q"], { utf16: true });
78
- confirmedEmpty = typeof quiet === "string" && cleanWslOutput(quiet) === "";
79
- } catch (_quietError) { }
80
- }
81
- if (!hasDeps) {
82
- _cachedDistros = [];
83
- _cachedDistrosError = confirmedEmpty ? null : error;
84
- }
85
- // ENOENT confirms wsl.exe is not installed. A failed invocation of an
86
- // existing executable is not evidence of an empty distro list.
87
- if (strict && error?.code !== "ENOENT" && !confirmedEmpty) throw error;
88
- return [];
89
- }
90
- const distros = parseWslListVerbose(raw);
91
- const sorted = distros.sort((a, b) => (b.isDefault ? 1 : 0) - (a.isDefault ? 1 : 0));
92
- if (!hasDeps) {
93
- _cachedDistros = sorted;
94
- _cachedDistrosError = null;
95
- }
96
- return sorted;
97
- }
98
-
99
- function normalizeWslMode(value) {
100
- return String(value ?? "")
101
- .trim()
102
- .toLowerCase()
103
- .replaceAll("_", "-");
104
- }
105
-
106
- function getWslMode(env = process.env) {
107
- const raw = normalizeWslMode(env.TOKENUSAGE_WSL_MODE);
108
- return WSL_MODES.has(raw) ? raw : "wsl-first";
109
- }
110
-
111
- function isInvalidWslMode(env = process.env) {
112
- const value = env.TOKENUSAGE_WSL_MODE;
113
- if (value == null || String(value).trim() === "") return false;
114
- return !WSL_MODES.has(normalizeWslMode(value));
115
- }
116
-
117
- function shouldProbeWsl(env = process.env) {
118
- return getWslMode(env) !== "native-only";
119
- }
120
-
121
- function shouldProbeNative(env = process.env) {
122
- return getWslMode(env) !== "wsl-only";
123
- }
124
-
125
- function pickWin32Path({
126
- wslValue,
127
- nativeValue,
128
- env = process.env,
129
- platform = process.platform,
130
- }) {
131
- if (platform !== "win32") return null;
132
-
133
- const mode = getWslMode(env);
134
-
135
- if (mode === "both") return wslValue ?? nativeValue ?? null;
136
- if (mode === "wsl-only") return wslValue ?? null;
137
- if (mode === "native-only") return nativeValue ?? null;
138
- if (mode === "native-first") return nativeValue ?? wslValue ?? null;
139
-
140
- return wslValue ?? nativeValue ?? null;
141
- }
142
-
143
- function resolveAllWin32Paths({
144
- nativeValue,
145
- wslValue,
146
- env = process.env,
147
- platform = process.platform,
148
- }) {
149
- if (platform !== "win32") return { native: null, wsl: null };
150
-
151
- const mode = getWslMode(env);
152
-
153
- if (mode === "both") {
154
- return { native: nativeValue ?? null, wsl: wslValue ?? null };
155
- }
156
-
157
- const single = pickWin32Path({ wslValue, nativeValue, env, platform });
158
- return { native: single, wsl: null };
159
- }
160
-
161
- function lookupWslUser(distroName, runWsl, useCache, strict = false) {
162
- if (useCache && _cachedWslUsers.has(distroName) && (!strict || !_cachedWslUserErrors.has(distroName))) {
163
- return _cachedWslUsers.get(distroName);
164
- }
165
- let user = "";
166
- let error = null;
167
- try {
168
- user = String(runWsl(["-d", distroName, "-e", "whoami"], { utf16: false }) || "").trim();
169
- if (!user) error = Object.assign(new Error("WSL identity probe returned no user"), { code: "EWSLIDENTITY" });
170
- } catch (cause) { error = cause; }
171
- if (useCache) {
172
- _cachedWslUsers.set(distroName, user);
173
- if (error) _cachedWslUserErrors.set(distroName, error);
174
- else _cachedWslUserErrors.delete(distroName);
175
- }
176
- if (strict && error) throw error;
177
- return user;
178
- }
179
-
180
- function discoverWslHome(providerDir, deps = {}) {
181
- if (!shouldProbeWsl(deps.env)) return null;
182
-
183
- const runWsl = deps.runWsl || defaultRunWsl;
184
- const existsSync = deps.existsSync || fssync.existsSync;
185
- const strict = deps.strict === true;
186
- const distros = deps.runWsl
187
- ? probeWslDistros({ runWsl: deps.runWsl, strict })
188
- : probeWslDistros(strict ? { strict } : undefined);
189
- const useCache = !deps.runWsl;
190
- for (const distro of distros) {
191
- const user = lookupWslUser(distro.name, runWsl, useCache, strict);
192
- if (!user) continue;
193
- const roots = distro.version === 1
194
- ? ["\\\\wsl.localhost\\", "\\\\wsl$\\"]
195
- : ["\\\\wsl$\\", "\\\\wsl.localhost\\"];
196
- for (const root of roots) {
197
- const candidate = `${root}${distro.name}\\home\\${user}\\${providerDir}`;
198
- try {
199
- if (existsSync(candidate)) return candidate;
200
- } catch (_e) { }
201
- }
202
- }
203
- return null;
204
- }
205
-
206
- function isUncPath(p) {
207
- return typeof p === "string" && (p.startsWith("\\\\") || p.startsWith("//"));
208
- }
209
-
210
- const WSL_UNC_ROOT_RE = /^[\\/]{2}(wsl\$|wsl\.localhost)[\\/]([^\\/]+)[\\/]/i;
211
- const WINDOWS_DRIVE_PREFIX_RE = /^\/[A-Za-z]:[\\/]/;
212
-
213
- // `\\wsl$\Ubuntu-24.04\home\u\...` -> `\\wsl$\Ubuntu-24.04\`. Returns null for
214
- // native and non-WSL UNC paths.
215
- function wslUncRoot(p) {
216
- if (typeof p !== "string") return null;
217
- const match = WSL_UNC_ROOT_RE.exec(p);
218
- return match ? `\\\\${match[1]}\\${match[2]}\\` : null;
219
- }
220
-
221
- // A WSL session records its cwd as a POSIX path (`/home/u/dev/app`) while the
222
- // transcript itself is read over the distro's UNC bridge. Probing that raw
223
- // POSIX path from Windows resolves it against the current drive
224
- // (`C:\home\u\dev\app`), which never exists — so project attribution finds no
225
- // `.git`, and every WSL session ends up with a null projectKey (#374).
226
- // Re-anchor the cwd onto the UNC prefix the transcript came from.
227
- //
228
- // The prefix is taken from the transcript path rather than re-probed, which
229
- // also picks whichever of `\\wsl$` / `\\wsl.localhost` actually resolves on
230
- // this machine — they are not interchangeable everywhere. Anything that isn't
231
- // a POSIX cwd from a WSL-hosted file is returned untouched.
232
- function mapWslCwdToUnc(cwd, transcriptPath) {
233
- if (typeof cwd !== "string" || !cwd.startsWith("/")) return cwd;
234
- // `new URL("file:///C:/dev/app").pathname` is "/C:/dev/app" — a leading
235
- // slash, but a Windows path rather than a POSIX one. Qoder feeds exactly
236
- // that shape in via `project_uri`; re-anchoring it would invent
237
- // `\\wsl$\Distro\C:\dev\app`.
238
- if (WINDOWS_DRIVE_PREFIX_RE.test(cwd)) return cwd;
239
- const root = wslUncRoot(transcriptPath);
240
- if (!root) return cwd;
241
- return root + cwd.slice(1).replaceAll("/", "\\");
242
- }
243
-
244
- function snapshotSqliteDb(dbPath) {
245
- const tmpRoot = fssync.mkdtempSync(
246
- path.join(require("node:os").tmpdir(), "tokenusage-wsl-snap-"),
247
- );
248
- const target = path.join(tmpRoot, path.basename(dbPath));
249
- fssync.copyFileSync(dbPath, target);
250
- for (const suffix of ["-wal", "-shm", "-journal"]) {
251
- const src = dbPath + suffix;
252
- try {
253
- if (fssync.existsSync(src)) fssync.copyFileSync(src, target + suffix);
254
- } catch (_e) { }
255
- }
256
- return {
257
- path: target,
258
- cleanup() {
259
- try { fssync.rmSync(tmpRoot, { recursive: true, force: true }); } catch (_e) { }
260
- },
261
- };
262
- }
263
-
264
- module.exports = {
265
- defaultRunWsl,
266
- parseWslListVerbose,
267
- probeWslDistros,
268
- resetWslProbeCache,
269
- discoverWslHome,
270
- isUncPath,
271
- wslUncRoot,
272
- mapWslCwdToUnc,
273
- snapshotSqliteDb,
274
- getWslMode,
275
- isInvalidWslMode,
276
- shouldProbeWsl,
277
- shouldProbeNative,
278
- pickWin32Path,
279
- resolveAllWin32Paths,
280
- normalizeWslMode,
281
- };
1
+ const fssync = require("node:fs");
2
+ const path = require("node:path");
3
+
4
+ const DEFAULT_EXEC_OPTS = { timeout: 15000, windowsHide: true, maxBuffer: 1024 * 1024, stdio: ["ignore", "pipe", "ignore"] };
5
+
6
+ let _cachedDistros = null;
7
+ let _cachedDistrosError = null;
8
+ const _cachedWslUsers = new Map();
9
+ const _cachedWslUserErrors = new Map();
10
+
11
+ function resetWslProbeCache() {
12
+ _cachedDistros = null;
13
+ _cachedDistrosError = null;
14
+ _cachedWslUsers.clear();
15
+ _cachedWslUserErrors.clear();
16
+ }
17
+
18
+ const WSL_MODES = new Set([
19
+ "wsl-first",
20
+ "native-first",
21
+ "wsl-only",
22
+ "native-only",
23
+ "both",
24
+ ]);
25
+
26
+ function defaultRunWsl(args, { utf16 = false } = {}) {
27
+ const { execFileSync } = require("node:child_process");
28
+ const buf = execFileSync("wsl.exe", args, DEFAULT_EXEC_OPTS);
29
+ return utf16 ? buf.toString("utf16le") : buf.toString("utf8");
30
+ }
31
+
32
+ function cleanWslOutput(raw) {
33
+ return raw.replace(/\0/g, "").replace(/\uFEFF/g, "").trim();
34
+ }
35
+
36
+ function parseWslListVerbose(raw) {
37
+ if (typeof raw !== "string") return [];
38
+ const distros = [];
39
+ for (const line of raw.split(/\r?\n/)) {
40
+ const clean = cleanWslOutput(line);
41
+ if (!clean) continue;
42
+ const cells = clean.split(/\s+/);
43
+ let isDefault = false;
44
+ let idx = 0;
45
+ if (cells[0] === "*") {
46
+ isDefault = true;
47
+ idx = 1;
48
+ }
49
+ const name = cells[idx];
50
+ if (!name || name === "NAME") continue;
51
+ const version = parseInt(cells[cells.length - 1], 10);
52
+ distros.push({ name, version: Number.isFinite(version) ? version : null, isDefault });
53
+ }
54
+ return distros;
55
+ }
56
+
57
+ function probeWslDistros(deps = {}) {
58
+ const strict = deps.strict === true;
59
+ const hasDeps = Object.keys(deps).some((key) => key !== "strict");
60
+ // Legacy callers retain their fail-safe cache. Strict observers may reuse
61
+ // successful empty results, but must retry a failure cached by any caller.
62
+ if (!hasDeps && _cachedDistros && (!strict || !_cachedDistrosError)) return _cachedDistros;
63
+ const runWsl = deps.runWsl || defaultRunWsl;
64
+ let raw;
65
+ try {
66
+ raw = runWsl(["-l", "-v"], { utf16: true });
67
+ } catch (error) {
68
+ let confirmedEmpty = false;
69
+ if (
70
+ strict && Number.isInteger(error?.status) && error.status !== 0 &&
71
+ error.signal == null && (error.code == null || error.code === error.status)
72
+ ) {
73
+ // Some WSL builds exit nonzero for an empty verbose list. Confirm that
74
+ // case with a successful empty quiet list, not localized diagnostic text.
75
+ // Transport/permission/signal failures must never reach this fallback.
76
+ try {
77
+ const quiet = runWsl(["-l", "-q"], { utf16: true });
78
+ confirmedEmpty = typeof quiet === "string" && cleanWslOutput(quiet) === "";
79
+ } catch (_quietError) { }
80
+ }
81
+ if (!hasDeps) {
82
+ _cachedDistros = [];
83
+ _cachedDistrosError = confirmedEmpty ? null : error;
84
+ }
85
+ // ENOENT confirms wsl.exe is not installed. A failed invocation of an
86
+ // existing executable is not evidence of an empty distro list.
87
+ if (strict && error?.code !== "ENOENT" && !confirmedEmpty) throw error;
88
+ return [];
89
+ }
90
+ const distros = parseWslListVerbose(raw);
91
+ const sorted = distros.sort((a, b) => (b.isDefault ? 1 : 0) - (a.isDefault ? 1 : 0));
92
+ if (!hasDeps) {
93
+ _cachedDistros = sorted;
94
+ _cachedDistrosError = null;
95
+ }
96
+ return sorted;
97
+ }
98
+
99
+ function normalizeWslMode(value) {
100
+ return String(value ?? "")
101
+ .trim()
102
+ .toLowerCase()
103
+ .replaceAll("_", "-");
104
+ }
105
+
106
+ function getWslMode(env = process.env) {
107
+ const raw = normalizeWslMode(env.TOKENUSAGE_WSL_MODE);
108
+ return WSL_MODES.has(raw) ? raw : "wsl-first";
109
+ }
110
+
111
+ function isInvalidWslMode(env = process.env) {
112
+ const value = env.TOKENUSAGE_WSL_MODE;
113
+ if (value == null || String(value).trim() === "") return false;
114
+ return !WSL_MODES.has(normalizeWslMode(value));
115
+ }
116
+
117
+ function shouldProbeWsl(env = process.env) {
118
+ return getWslMode(env) !== "native-only";
119
+ }
120
+
121
+ function shouldProbeNative(env = process.env) {
122
+ return getWslMode(env) !== "wsl-only";
123
+ }
124
+
125
+ function pickWin32Path({
126
+ wslValue,
127
+ nativeValue,
128
+ env = process.env,
129
+ platform = process.platform,
130
+ }) {
131
+ if (platform !== "win32") return null;
132
+
133
+ const mode = getWslMode(env);
134
+
135
+ if (mode === "both") return wslValue ?? nativeValue ?? null;
136
+ if (mode === "wsl-only") return wslValue ?? null;
137
+ if (mode === "native-only") return nativeValue ?? null;
138
+ if (mode === "native-first") return nativeValue ?? wslValue ?? null;
139
+
140
+ return wslValue ?? nativeValue ?? null;
141
+ }
142
+
143
+ function resolveAllWin32Paths({
144
+ nativeValue,
145
+ wslValue,
146
+ env = process.env,
147
+ platform = process.platform,
148
+ }) {
149
+ if (platform !== "win32") return { native: null, wsl: null };
150
+
151
+ const mode = getWslMode(env);
152
+
153
+ if (mode === "both") {
154
+ return { native: nativeValue ?? null, wsl: wslValue ?? null };
155
+ }
156
+
157
+ const single = pickWin32Path({ wslValue, nativeValue, env, platform });
158
+ return { native: single, wsl: null };
159
+ }
160
+
161
+ function lookupWslUser(distroName, runWsl, useCache, strict = false) {
162
+ if (useCache && _cachedWslUsers.has(distroName) && (!strict || !_cachedWslUserErrors.has(distroName))) {
163
+ return _cachedWslUsers.get(distroName);
164
+ }
165
+ let user = "";
166
+ let error = null;
167
+ try {
168
+ user = String(runWsl(["-d", distroName, "-e", "whoami"], { utf16: false }) || "").trim();
169
+ if (!user) error = Object.assign(new Error("WSL identity probe returned no user"), { code: "EWSLIDENTITY" });
170
+ } catch (cause) { error = cause; }
171
+ if (useCache) {
172
+ _cachedWslUsers.set(distroName, user);
173
+ if (error) _cachedWslUserErrors.set(distroName, error);
174
+ else _cachedWslUserErrors.delete(distroName);
175
+ }
176
+ if (strict && error) throw error;
177
+ return user;
178
+ }
179
+
180
+ function discoverWslHome(providerDir, deps = {}) {
181
+ if (!shouldProbeWsl(deps.env)) return null;
182
+
183
+ const runWsl = deps.runWsl || defaultRunWsl;
184
+ const existsSync = deps.existsSync || fssync.existsSync;
185
+ const strict = deps.strict === true;
186
+ const distros = deps.runWsl
187
+ ? probeWslDistros({ runWsl: deps.runWsl, strict })
188
+ : probeWslDistros(strict ? { strict } : undefined);
189
+ const useCache = !deps.runWsl;
190
+ for (const distro of distros) {
191
+ const user = lookupWslUser(distro.name, runWsl, useCache, strict);
192
+ if (!user) continue;
193
+ const roots = distro.version === 1
194
+ ? ["\\\\wsl.localhost\\", "\\\\wsl$\\"]
195
+ : ["\\\\wsl$\\", "\\\\wsl.localhost\\"];
196
+ for (const root of roots) {
197
+ const candidate = `${root}${distro.name}\\home\\${user}\\${providerDir}`;
198
+ try {
199
+ if (existsSync(candidate)) return candidate;
200
+ } catch (_e) { }
201
+ }
202
+ }
203
+ return null;
204
+ }
205
+
206
+ function isUncPath(p) {
207
+ return typeof p === "string" && (p.startsWith("\\\\") || p.startsWith("//"));
208
+ }
209
+
210
+ const WSL_UNC_ROOT_RE = /^[\\/]{2}(wsl\$|wsl\.localhost)[\\/]([^\\/]+)[\\/]/i;
211
+ const WINDOWS_DRIVE_PREFIX_RE = /^\/[A-Za-z]:[\\/]/;
212
+
213
+ // `\\wsl$\Ubuntu-24.04\home\u\...` -> `\\wsl$\Ubuntu-24.04\`. Returns null for
214
+ // native and non-WSL UNC paths.
215
+ function wslUncRoot(p) {
216
+ if (typeof p !== "string") return null;
217
+ const match = WSL_UNC_ROOT_RE.exec(p);
218
+ return match ? `\\\\${match[1]}\\${match[2]}\\` : null;
219
+ }
220
+
221
+ // A WSL session records its cwd as a POSIX path (`/home/u/dev/app`) while the
222
+ // transcript itself is read over the distro's UNC bridge. Probing that raw
223
+ // POSIX path from Windows resolves it against the current drive
224
+ // (`C:\home\u\dev\app`), which never exists — so project attribution finds no
225
+ // `.git`, and every WSL session ends up with a null projectKey (#374).
226
+ // Re-anchor the cwd onto the UNC prefix the transcript came from.
227
+ //
228
+ // The prefix is taken from the transcript path rather than re-probed, which
229
+ // also picks whichever of `\\wsl$` / `\\wsl.localhost` actually resolves on
230
+ // this machine — they are not interchangeable everywhere. Anything that isn't
231
+ // a POSIX cwd from a WSL-hosted file is returned untouched.
232
+ function mapWslCwdToUnc(cwd, transcriptPath) {
233
+ if (typeof cwd !== "string" || !cwd.startsWith("/")) return cwd;
234
+ // `new URL("file:///C:/dev/app").pathname` is "/C:/dev/app" — a leading
235
+ // slash, but a Windows path rather than a POSIX one. Qoder feeds exactly
236
+ // that shape in via `project_uri`; re-anchoring it would invent
237
+ // `\\wsl$\Distro\C:\dev\app`.
238
+ if (WINDOWS_DRIVE_PREFIX_RE.test(cwd)) return cwd;
239
+ const root = wslUncRoot(transcriptPath);
240
+ if (!root) return cwd;
241
+ return root + cwd.slice(1).replaceAll("/", "\\");
242
+ }
243
+
244
+ function snapshotSqliteDb(dbPath) {
245
+ const tmpRoot = fssync.mkdtempSync(
246
+ path.join(require("node:os").tmpdir(), "tokenusage-wsl-snap-"),
247
+ );
248
+ const target = path.join(tmpRoot, path.basename(dbPath));
249
+ fssync.copyFileSync(dbPath, target);
250
+ for (const suffix of ["-wal", "-shm", "-journal"]) {
251
+ const src = dbPath + suffix;
252
+ try {
253
+ if (fssync.existsSync(src)) fssync.copyFileSync(src, target + suffix);
254
+ } catch (_e) { }
255
+ }
256
+ return {
257
+ path: target,
258
+ cleanup() {
259
+ try { fssync.rmSync(tmpRoot, { recursive: true, force: true }); } catch (_e) { }
260
+ },
261
+ };
262
+ }
263
+
264
+ module.exports = {
265
+ defaultRunWsl,
266
+ parseWslListVerbose,
267
+ probeWslDistros,
268
+ resetWslProbeCache,
269
+ discoverWslHome,
270
+ isUncPath,
271
+ wslUncRoot,
272
+ mapWslCwdToUnc,
273
+ snapshotSqliteDb,
274
+ getWslMode,
275
+ isInvalidWslMode,
276
+ shouldProbeWsl,
277
+ shouldProbeNative,
278
+ pickWin32Path,
279
+ resolveAllWin32Paths,
280
+ normalizeWslMode,
281
+ };