throughline 0.8.1 → 0.8.2

package/CHANGELOG.md

@@ -10,6 +10,16 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.8.2] — 2026-07-20
+
+### Fixed
+
+- Windows native Codex hook commands now prefix quoted Node executables with the
+  PowerShell call operator `&`. POSIX command strings are unchanged, and the
+  existing managed-hook detector continues to recognize the canonical commands.
+
+## [0.8.1] — 2026-07-19
+
 ### Fixed
 
 - **Native factory diagnostics now report the database compatibility label from

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "throughline",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "type": "module",
   "description": "Claude Code hooks plugin for structured context compression (/clear-safe persistent memory)",
   "keywords": [

package/src/cli/install.mjs

@@ -101,22 +101,30 @@ export function resolveCodexHookNodePath({
 export function buildCodexStopHookCommand({
   nodePath = resolveCodexHookNodePath(),
   cliScriptPath = join(PACKAGE_ROOT, 'bin', 'throughline.mjs'),
+  platform = process.platform,
 } = {}) {
-  return `${quoteCommandPath(nodePath)} ${quoteCommandPath(cliScriptPath)} codex-hook stop`;
+  return buildCodexHookCommand('stop', { nodePath, cliScriptPath, platform });
 }
 
 export function buildCodexUserPromptSubmitHookCommand({
   nodePath = resolveCodexHookNodePath(),
   cliScriptPath = join(PACKAGE_ROOT, 'bin', 'throughline.mjs'),
+  platform = process.platform,
 } = {}) {
-  return `${quoteCommandPath(nodePath)} ${quoteCommandPath(cliScriptPath)} codex-hook user-prompt-submit`;
+  return buildCodexHookCommand('user-prompt-submit', { nodePath, cliScriptPath, platform });
 }
 
 export function buildCodexPostToolUseHookCommand({
   nodePath = resolveCodexHookNodePath(),
   cliScriptPath = join(PACKAGE_ROOT, 'bin', 'throughline.mjs'),
+  platform = process.platform,
 } = {}) {
-  return `${quoteCommandPath(nodePath)} ${quoteCommandPath(cliScriptPath)} codex-hook post-tool-use`;
+  return buildCodexHookCommand('post-tool-use', { nodePath, cliScriptPath, platform });
+}
+
+function buildCodexHookCommand(event, { nodePath, cliScriptPath, platform }) {
+  const prefix = platform === 'win32' ? '& ' : '';
+  return `${prefix}${quoteCommandPath(nodePath)} ${quoteCommandPath(cliScriptPath)} codex-hook ${event}`;
 }
 
 export function isThroughlineCodexHookCommand(command) {

package/src/cli/install.test.mjs

@@ -8,6 +8,7 @@ import {
   buildCodexPostToolUseHookCommand,
   buildCodexStopHookCommand,
   buildCodexUserPromptSubmitHookCommand,
+  isThroughlineCodexHookCommand,
   resolveCodexHookNodePath,
   run,
   resolveThroughlineOnPath,
@@ -141,6 +142,27 @@ test('global install registers Codex session hooks and enables hooks features',
   }
 });
 
+test('Codex hook builders use the PowerShell call operator on Windows only', () => {
+  const options = {
+    nodePath: String.raw`C:\Program Files\nodejs\node.exe`,
+    cliScriptPath: String.raw`C:\Users\Kite\App Data\Roaming\npm\node_modules\throughline\bin\throughline.mjs`,
+  };
+  assert.equal(
+    buildCodexStopHookCommand({ ...options, platform: 'win32' }),
+    String.raw`& "C:\Program Files\nodejs\node.exe" "C:\Users\Kite\App Data\Roaming\npm\node_modules\throughline\bin\throughline.mjs" codex-hook stop`,
+  );
+  assert.equal(
+    buildCodexUserPromptSubmitHookCommand({ ...options, platform: 'win32' }),
+    String.raw`& "C:\Program Files\nodejs\node.exe" "C:\Users\Kite\App Data\Roaming\npm\node_modules\throughline\bin\throughline.mjs" codex-hook user-prompt-submit`,
+  );
+  assert.equal(
+    buildCodexPostToolUseHookCommand({ ...options, platform: 'win32' }),
+    String.raw`& "C:\Program Files\nodejs\node.exe" "C:\Users\Kite\App Data\Roaming\npm\node_modules\throughline\bin\throughline.mjs" codex-hook post-tool-use`,
+  );
+  assert.equal(buildCodexStopHookCommand({ ...options, platform: 'linux' }).startsWith('& '), false);
+  assert.equal(isThroughlineCodexHookCommand(buildCodexStopHookCommand({ ...options, platform: 'win32' })), true);
+});
+
 test('global install copies Throughline Codex skill to ~/.codex/skills/', async () => {
   const home = makeTempHome();
   if (home.resolved !== home.dir) {