singularity-forge/src/web/hooks-service.ts
Iouri Goussev a952391b33 chore: rename preferences.md to PREFERENCES.md for consistency (#2700) (#2738)
All other .gsd/ state files use uppercase naming (DECISIONS.md,
REQUIREMENTS.md, PROJECT.md, etc). This renames the canonical
preferences file to PREFERENCES.md while keeping a migration
fallback — the loader checks PREFERENCES.md first, then falls
back to lowercase preferences.md for existing installations.

Closes #2700

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-26 16:09:59 -06:00

88 lines
3.4 KiB
TypeScript

import { execFile } from "node:child_process"
import { existsSync } from "node:fs"
import { join } from "node:path"
import { pathToFileURL } from "node:url"
import { resolveBridgeRuntimeConfig } from "./bridge-service.ts"
import { resolveTypeStrippingFlag, resolveSubprocessModule, buildSubprocessPrefixArgs } from "./ts-subprocess-flags.ts"
import type { HooksData } from "../../web/lib/remaining-command-types.ts"
const HOOKS_MAX_BUFFER = 512 * 1024
const HOOKS_MODULE_ENV = "GSD_HOOKS_MODULE"
function resolveTsLoaderPath(packageRoot: string): string {
return join(packageRoot, "src", "resources", "extensions", "gsd", "tests", "resolve-ts.mjs")
}
/**
* Collects hook configuration and status via a child process.
* Runtime state (active cycles, hook queue) is not available in a cold child
* process, so activeCycles will be empty. The child calls getHookStatus() which
* reads from preferences to build entries, then formatHookStatus() for display.
*/
export async function collectHooksData(projectCwdOverride?: string): Promise<HooksData> {
const config = resolveBridgeRuntimeConfig(undefined, projectCwdOverride)
const { packageRoot, projectCwd } = config
const resolveTsLoader = resolveTsLoaderPath(packageRoot)
const moduleResolution = resolveSubprocessModule(packageRoot, "resources/extensions/gsd/post-unit-hooks.ts")
const hooksModulePath = moduleResolution.modulePath
if (!moduleResolution.useCompiledJs && (!existsSync(resolveTsLoader) || !existsSync(hooksModulePath))) {
throw new Error(
`hooks data provider not found; checked=${resolveTsLoader},${hooksModulePath}`,
)
}
if (moduleResolution.useCompiledJs && !existsSync(hooksModulePath)) {
throw new Error(`hooks data provider not found; checked=${hooksModulePath}`)
}
// getHookStatus() internally calls resolvePostUnitHooks() and resolvePreDispatchHooks()
// from preferences.ts, which read from process.cwd()/.gsd/PREFERENCES.md.
// We set cwd to projectCwd so preferences resolution finds the right files.
// In a cold child process, cycleCounts is empty, so activeCycles will be {}.
const script = [
'const { pathToFileURL } = await import("node:url");',
`const mod = await import(pathToFileURL(process.env.${HOOKS_MODULE_ENV}).href);`,
'const entries = mod.getHookStatus();',
'const formattedStatus = mod.formatHookStatus();',
'process.stdout.write(JSON.stringify({ entries, formattedStatus }));',
].join(" ")
const prefixArgs = buildSubprocessPrefixArgs(packageRoot, moduleResolution, pathToFileURL(resolveTsLoader).href)
return await new Promise<HooksData>((resolveResult, reject) => {
execFile(
process.execPath,
[
...prefixArgs,
"--eval",
script,
],
{
cwd: projectCwd,
env: {
...process.env,
[HOOKS_MODULE_ENV]: hooksModulePath,
},
maxBuffer: HOOKS_MAX_BUFFER,
},
(error, stdout, stderr) => {
if (error) {
reject(new Error(`hooks data subprocess failed: ${stderr || error.message}`))
return
}
try {
resolveResult(JSON.parse(stdout) as HooksData)
} catch (parseError) {
reject(
new Error(
`hooks data subprocess returned invalid JSON: ${parseError instanceof Error ? parseError.message : String(parseError)}`,
),
)
}
},
)
})
}