Files
waggle-os/packages/hive-mind-hooks-codex/src/paths.ts
Oleg Maslov b20b138fe4 moving
2026-09-02 10:14:22 +02:00

148 lines
4.9 KiB
TypeScript

/**
* Filesystem path helpers for the Codex hive-mind hook install lifecycle.
*
* Mirrors the frozen Wave 1 claude-code `paths.ts` shape, but targets
* Codex's standalone `~/.codex/hooks.json` (NOT `~/.codex/config.toml` —
* we stay out of the user's TOML and away from protected
* `notify`/`profile`/`model_providers` keys). The Windows-safe backup
* path + hooks-dir resolution reuse `@waggle/hive-mind-hooks-core`. Codex
* needs its own Windows command encoder because its Rust runtime passes the
* whole handler string through the selected host shell (PowerShell for a
* normal local thread, with `cmd.exe /C` as the fallback).
*/
import { homedir } from 'node:os';
import { join, resolve, win32 } from 'node:path';
import {
backupPathFor,
hookCommandFor as sharedHookCommandFor,
hooksDirFromModuleUrl,
} from '@waggle/hive-mind-hooks-core';
export interface CodexPaths {
/** Codex config root (`~/.codex/`). */
codexDir: string;
/** `~/.codex/hooks.json` — the standalone hooks config (NOT config.toml). */
configPath: string;
/** `~/.codex/hive-mind-install.json` — pointer to the active backup. */
pointerPath: string;
/** Directory where compiled hook scripts live (`dist/hooks/`). */
hooksDir: string;
}
export interface ResolvePathsOptions {
/** Override $HOME for tests. */
home?: string;
/** Override the URL used to locate dist/hooks (defaults to import.meta.url at runtime). */
moduleUrl?: string;
/** Override hooks directory directly (wins over moduleUrl). */
hooksDir?: string;
}
const HOOK_BASENAMES = [
'session-start',
'user-prompt-submit',
'stop',
'pre-compact',
] as const;
export type HookBasename = typeof HOOK_BASENAMES[number];
export function allHookBasenames(): readonly HookBasename[] {
return HOOK_BASENAMES;
}
export function resolvePaths(opts: ResolvePathsOptions = {}): CodexPaths {
const home = opts.home ?? homedir();
const codexDir = join(home, '.codex');
const configPath = join(codexDir, 'hooks.json');
const pointerPath = join(codexDir, 'hive-mind-install.json');
let hooksDir: string;
if (opts.hooksDir) {
hooksDir = resolve(opts.hooksDir);
} else if (opts.moduleUrl) {
hooksDir = hooksDirFromModuleUrl(opts.moduleUrl);
} else {
// Fallback for ad-hoc test use — install.ts always passes moduleUrl.
hooksDir = resolve(process.cwd(), 'dist', 'hooks');
}
return { codexDir, configPath, pointerPath, hooksDir };
}
export interface HookCommandOptions {
/** Explicit seam for cross-platform command-shape tests. */
platform?: NodeJS.Platform;
/** Explicit Windows runtime seam; production normally uses the launcher env override. */
nodePath?: string;
/** Explicit Windows root seam; production reads the OS-provided SystemRoot. */
systemRoot?: string;
}
function powershellLiteral(value: string): string {
return `'${value.replaceAll("'", "''")}'`;
}
function windowsPowerShellPath(systemRoot?: string): string {
const root = win32.normalize(
systemRoot?.trim()
|| process.env.SystemRoot?.trim()
|| 'C:\\Windows',
);
if (!/^[A-Za-z]:\\[A-Za-z0-9._\\-]+$/.test(root)) {
throw new Error('Windows SystemRoot must be an absolute shell-safe path');
}
return win32.join(root, 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
}
function windowsHookCommand(
nodePath: string,
scriptPath: string,
cliPath?: string,
systemRoot?: string,
): string {
const args = [nodePath, scriptPath];
if (cliPath && cliPath.length > 0) args.push('--cli-path', cliPath);
const script = [
"$ErrorActionPreference = 'Stop'",
'try {',
` & ${args.map(powershellLiteral).join(' ')}`,
' if ($null -eq $LASTEXITCODE) { exit 1 }',
' exit $LASTEXITCODE',
'} catch {',
' [Console]::Error.WriteLine($_.Exception.Message)',
' exit 1',
'}',
].join('\r\n');
const encoded = Buffer.from(script, 'utf16le').toString('base64');
return `${windowsPowerShellPath(systemRoot)} -NoLogo -NoProfile -NonInteractive -EncodedCommand ${encoded}`;
}
/**
* Build a Codex command that survives the host's exact shell dispatch.
* POSIX keeps the shared `node "script" --cli-path "cli"` contract. On
* Windows the trusted invocation is UTF-16LE encoded inside PowerShell so
* both Codex's PowerShell host and its `cmd.exe /C` fallback can parse the
* same command. The system PowerShell path is resolved to a validated
* absolute literal so an untrusted workspace cannot win command lookup with
* a repo-local `powershell.exe`.
*/
export function hookCommandFor(
scriptPath: string,
cliPath?: string,
opts: HookCommandOptions = {},
): string {
if ((opts.platform ?? process.platform) !== 'win32') {
return sharedHookCommandFor(scriptPath, cliPath);
}
const nodePath = opts.nodePath?.trim()
|| process.env.WAGGLE_HOOK_NODE_PATH?.trim()
|| process.execPath;
return windowsHookCommand(nodePath, scriptPath, cliPath, opts.systemRoot);
}
export { backupPathFor };