@goodfoot/agent-hooks 1.0.10 → 1.0.12

package/CHANGELOG.md

@@ -1,9 +1,12 @@
 # @goodfoot/agent-hooks npm package changelog
 
-## 1.0.10
-- Fixed scaffolded hook bundles to work when the install path is a symlink or otherwise differs from the project root, so hooks resolve correctly across repository layouts
-- Improved stack traces from hooks by making source map resolution reliable in relocated or symlinked installs
-- Applied the portability fixes consistently across the Claude Code, Codex, and Antigravity entry points
+## 1.0.12
+
+Waits for stdout and stderr writes to complete before exiting, preventing truncated hook responses and error diagnostics when output is piped. Asynchronous stdout write failures now follow the existing unexpected-error policy without retrying the payload.
+
+## 1.0.11
+
+Moves generated-file tracking out of `hooks.json` into a sibling `hooks.meta.json`, because Claude Code rejects a hooks manifest carrying any key besides `hooks`. The manifest is now a pure function of its inputs, so a rebuild that changes nothing writes identical bytes and leaves the host's hook-trust hash intact. A missing or unreadable sidecar is treated as "nothing tracked as generated", which preserves the entries already in the manifest rather than pruning them.
 
 ## 1.0.10
 

package/dist/agents/antigravity/scaffold.js

@@ -50,7 +50,7 @@ function packageJson(projectName, outputPath) {
             lint: "biome check .",
             typecheck: "tsc --noEmit",
         },
-        dependencies: { [PACKAGE_NAME]: "^1.0.10" },
+        dependencies: { [PACKAGE_NAME]: "^1.0.12" },
         devDependencies: {
             "@biomejs/biome": "2.4.9",
             "@types/node": "^24.0.0",

package/dist/agents/codex/scaffold.js

@@ -55,7 +55,7 @@ function generatePackageJson(projectName, outputPath) {
             typecheck: "tsc --noEmit",
         },
         dependencies: {
-            [PACKAGE_NAME]: "^1.0.10",
+            [PACKAGE_NAME]: "^1.0.12",
         },
         devDependencies: {
             "@biomejs/biome": "2.4.9",

package/dist/cli.js

@@ -26,7 +26,9 @@ import { scaffoldProject } from "./scaffold.js";
 // ============================================================================
 // Constants
 // ============================================================================
-const VERSION = "1.0.10";
+const VERSION = "1.0.12";
+/** Filename of the tracking sidecar written beside hooks.json. */
+const HOOKS_META_FILENAME = "hooks.meta.json";
 const DEFAULT_ESBUILD_LOADERS = {
     ".md": "text",
 };
@@ -584,8 +586,12 @@ function symlinkVisiblePath(realPath, resolveDir) {
                     pkgRel = path.relative(dir, realPath);
                 }
             }
-            catch {
-                // Not a readable package.json — the realpath is not under a package.
+            catch (error) {
+                // An unreadable or malformed manifest is the same case as no manifest
+                // at all: identity stays undefined and the caller falls back below.
+                log("debug", `Could not read package manifest: ${pkgJsonPath}`, {
+                    error: error instanceof Error ? error.message : String(error),
+                });
             }
             break;
         }
@@ -1049,13 +1055,7 @@ function generateHooksJson(compiledHooks, buildDir, contextInfo, executable = "n
         }
         hooks[eventName] = entries;
     }
-    return {
-        hooks,
-        __generated: {
-            files: compiledHooks.map((h) => h.outputFilename),
-            timestamp: new Date().toISOString(),
-        },
-    };
+    return { hooks };
 }
 /**
  * Reads an existing hooks.json file if it exists.
@@ -1078,14 +1078,66 @@ function readExistingHooksJson(outputPath) {
     }
 }
 /**
- * Removes previously generated hook files from disk.
- * Only removes files that were tracked in __generated.files.
- * @param existingHooksJson - The existing hooks.json content
+ * Absolute path of the tracking sidecar that sits beside hooks.json.
+ * @param outputPath - Path to hooks.json
+ * @returns Path to hooks.meta.json
+ */
+function hooksMetaPath(outputPath) {
+    return path.join(path.dirname(outputPath), HOOKS_META_FILENAME);
+}
+/**
+ * Reads the tracking sidecar beside hooks.json if it exists.
+ *
+ * A missing or unreadable sidecar is not fatal: it only means no generated
+ * filenames are known, so every existing entry is treated as externally
+ * authored and preserved.
+ * @param outputPath - Path to the hooks.json the sidecar describes
+ * @returns Parsed HooksMeta or undefined if absent or unusable
+ */
+function readHooksMeta(outputPath) {
+    const metaPath = hooksMetaPath(outputPath);
+    if (!fs.existsSync(metaPath)) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(fs.readFileSync(metaPath, "utf-8"));
+        const rawFiles = parsed.files;
+        if (!Array.isArray(rawFiles)) {
+            log("warn", "hooks.meta.json has no files array, treating generated hooks as untracked", { path: metaPath });
+            return undefined;
+        }
+        const files = rawFiles.filter((entry) => typeof entry === "string");
+        if (files.length !== rawFiles.length) {
+            log("warn", "hooks.meta.json lists non-string filenames, treating generated hooks as untracked", {
+                path: metaPath,
+            });
+            return undefined;
+        }
+        return { files };
+    }
+    catch (error) {
+        log("warn", "Failed to parse hooks.meta.json, treating generated hooks as untracked", {
+            path: metaPath,
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return undefined;
+    }
+}
+/**
+ * Removes bundles a previous build generated that this build did not. Only
+ * filenames tracked in the sidecar are ever removed, and callers must run this
+ * after the new hooks.json is on disk so no reachable state loses a file it
+ * references.
+ * @param previousMeta - Tracking sidecar from the previous build, if any
  * @param outputDir - Directory containing the generated files
+ * @param keepFilenames - Filenames written by the current build
  */
-function removeOldGeneratedFiles(existingHooksJson, outputDir) {
-    const filesToRemove = existingHooksJson.__generated?.files ?? [];
+function removeStaleGeneratedFiles(previousMeta, outputDir, keepFilenames) {
+    const filesToRemove = previousMeta?.files ?? [];
     for (const filename of filesToRemove) {
+        if (keepFilenames.has(filename)) {
+            continue;
+        }
         const filePath = path.join(outputDir, filename);
         if (fs.existsSync(filePath)) {
             try {
@@ -1101,13 +1153,15 @@ function removeOldGeneratedFiles(existingHooksJson, outputDir) {
     }
 }
 /**
- * Extracts hooks from an existing hooks.json that were NOT generated by this package.
- * Identifies generated hooks by checking if their command path matches the generated file pattern.
+ * Extracts hooks from an existing hooks.json that were NOT generated by this
+ * package. Generated hooks are identified by the filenames tracked in the
+ * sidecar, so entries authored anywhere else survive a rebuild untouched.
  * @param existingHooksJson - The existing hooks.json content
+ * @param meta - Tracking sidecar from the previous build, if any
  * @returns Object containing preserved hooks (keyed by event type)
  */
-function extractPreservedHooks(existingHooksJson) {
-    const generatedFiles = new Set(existingHooksJson.__generated?.files ?? []);
+function extractPreservedHooks(existingHooksJson, meta) {
+    const generatedFiles = new Set(meta?.files ?? []);
     const preserved = {};
     for (const [eventType, entries] of Object.entries(existingHooksJson.hooks)) {
         if (!entries)
@@ -1155,28 +1209,24 @@ function mergeHooksJson(newHooksJson, preservedHooks) {
         // Combine preserved and generated entries
         mergedHooks[eventType] = [...preserved, ...generated];
     }
-    return {
-        hooks: mergedHooks,
-        __generated: newHooksJson.__generated,
-    };
+    return { hooks: mergedHooks };
 }
 /**
- * Writes hooks.json to the specified path atomically.
- * Uses write-to-temp-then-rename pattern for atomicity.
- * @param hooksJson - The hooks.json content
- * @param outputPath - Path to write hooks.json
+ * Writes a JSON document atomically, using write-to-temp-then-rename.
+ * @param value - Value to serialize
+ * @param filePath - Destination path
  */
-function writeHooksJson(hooksJson, outputPath) {
-    const dir = path.dirname(outputPath);
+function writeJsonAtomic(value, filePath) {
+    const dir = path.dirname(filePath);
     if (!fs.existsSync(dir)) {
         fs.mkdirSync(dir, { recursive: true });
     }
     // Write to a temporary file first, then rename for atomicity
-    const tempPath = `${outputPath}.tmp.${process.pid}`;
-    const content = `${JSON.stringify(hooksJson, null, 2)}\n`;
+    const tempPath = `${filePath}.tmp.${process.pid}`;
+    const content = `${JSON.stringify(value, null, 2)}\n`;
     try {
         fs.writeFileSync(tempPath, content, "utf-8");
-        fs.renameSync(tempPath, outputPath);
+        fs.renameSync(tempPath, filePath);
     }
     catch (error) {
         // Clean up temp file if rename failed
@@ -1191,6 +1241,22 @@ function writeHooksJson(hooksJson, outputPath) {
         throw error;
     }
 }
+/**
+ * Writes hooks.json to the specified path atomically.
+ * @param hooksJson - The hooks.json content
+ * @param outputPath - Path to write hooks.json
+ */
+function writeHooksJson(hooksJson, outputPath) {
+    writeJsonAtomic(hooksJson, outputPath);
+}
+/**
+ * Writes the tracking sidecar beside hooks.json atomically.
+ * @param meta - Tracking metadata for this build
+ * @param outputPath - Path to the hooks.json the sidecar describes
+ */
+function writeHooksMeta(meta, outputPath) {
+    writeJsonAtomic(meta, hooksMetaPath(outputPath));
+}
 // ============================================================================
 // Main Entry Point
 // ============================================================================
@@ -1376,15 +1442,14 @@ async function main() {
             process.stderr.write(`Error: No hook files found matching pattern: ${args.input}\n`);
             process.exit(1);
         }
-        // Read existing hooks.json to preserve non-generated hooks
+        // Read existing hooks.json and its tracking sidecar to preserve non-generated hooks
         const existingHooksJson = readExistingHooksJson(outputPath);
+        const existingMeta = readHooksMeta(outputPath);
         let preservedHooks = {};
         if (existingHooksJson !== undefined) {
             log("info", "Found existing hooks.json, will preserve non-generated hooks");
             // Extract hooks that were NOT generated by this package
-            preservedHooks = extractPreservedHooks(existingHooksJson);
-            // Remove old generated files from disk
-            removeOldGeneratedFiles(existingHooksJson, buildDir);
+            preservedHooks = extractPreservedHooks(existingHooksJson, existingMeta);
             const preservedCount = Object.values(preservedHooks).reduce((sum, entries) => sum + (entries?.reduce((s, e) => s + e.hooks.length, 0) ?? 0), 0);
             log("info", `Preserved ${preservedCount} hooks from other sources`);
         }
@@ -1408,19 +1473,16 @@ async function main() {
         // Generate hooks.json for newly compiled hooks
         const executable = args.executable !== undefined && args.executable !== "" ? args.executable : "node";
         const newHooksJson = generateHooksJson(compiledHooks, buildDir, hookContext, executable);
-        // Preserve timestamp if generated files haven't changed
-        if (existingHooksJson !== undefined) {
-            const existingFiles = [...(existingHooksJson.__generated?.files ?? [])].sort();
-            const newFiles = [...newHooksJson.__generated.files].sort();
-            const filesUnchanged = existingFiles.length === newFiles.length && existingFiles.every((f, i) => f === newFiles[i]);
-            if (filesUnchanged && existingHooksJson.__generated?.timestamp) {
-                newHooksJson.__generated.timestamp = existingHooksJson.__generated.timestamp;
-                log("info", "Files unchanged, preserving existing timestamp");
-            }
-        }
         // Merge with preserved hooks
         const finalHooksJson = mergeHooksJson(newHooksJson, preservedHooks);
         writeHooksJson(finalHooksJson, outputPath);
+        // Drop the bundles the previous build produced that this one did not, then
+        // record what this build wrote. Stale files go only after the hooks.json
+        // that references the current set is on disk, so every state on disk
+        // between the two writes stays runnable.
+        const writtenFilenames = new Set(compiledHooks.map((hook) => hook.outputFilename));
+        removeStaleGeneratedFiles(existingMeta, buildDir, writtenFilenames);
+        writeHooksMeta({ files: [...writtenFilenames].sort() }, outputPath);
         log("info", "Compilation complete", {
             hooksCompiled: compiledHooks.length,
             outputPath,
@@ -1471,4 +1533,4 @@ if (isDirectExecution) {
 // Shared build primitives reused by the per-agent CLI branches (single
 // source for driver logic — the duplication check forbids re-deriving these
 // inside agents/*).
-export { analyzeHookFile, buildLoaderMap, buildLoaderMap as buildEsbuildLoaderMap, compileHook, detectHookContext, discoverHookFiles, discoverHookFiles as discoverHookSourceFiles, extractPreservedHooks, generateCommandPath, generateContentHash, generateContentHash as sha256Prefix8, generateHooksJson, groupHooksByEventAndMatcher, HOOK_FACTORY_TO_EVENT, mergeHooksJson, moduleWorkingDir, parseArgs, parseLoaderFlag, parseLoaderFlag as parseEsbuildLoaderFlag, pruneStaleHashedBundles, readExistingHooksJson, removeOldGeneratedFiles, symlinkVisiblePath, validateArgs, };
+export { analyzeHookFile, buildLoaderMap, buildLoaderMap as buildEsbuildLoaderMap, compileHook, detectHookContext, discoverHookFiles, discoverHookFiles as discoverHookSourceFiles, extractPreservedHooks, generateCommandPath, generateContentHash, generateContentHash as sha256Prefix8, generateHooksJson, groupHooksByEventAndMatcher, HOOK_FACTORY_TO_EVENT, hooksMetaPath, mergeHooksJson, moduleWorkingDir, parseArgs, parseLoaderFlag, parseLoaderFlag as parseEsbuildLoaderFlag, pruneStaleHashedBundles, readExistingHooksJson, readHooksMeta, removeStaleGeneratedFiles, symlinkVisiblePath, validateArgs, };

package/dist/core/transport.js

@@ -111,18 +111,29 @@ function classify(error, phase, policy, onUnexpectedError) {
     }
     return { kind: "handlerError", error, phase };
 }
+// A successful write return value only describes buffering; its callback confirms delivery.
+function writeStream(stream, content) {
+    return new Promise((resolve, reject) => {
+        stream.write(content, (error) => {
+            if (error)
+                reject(error);
+            else
+                resolve();
+        });
+    });
+}
 /**
  * Writes an unexpected (non-handler, runtime-owned) error's stacktrace to
  * stderr. Used for cleanup/finalize failures under the default `"error"`
  * policy, which exit with code 1 — these are not the handler's own
  * intentional signal.
  */
-function writeUnexpectedErrorStderr(error) {
+async function writeUnexpectedErrorStderr(error) {
     if (error instanceof Error) {
-        process.stderr.write(`${error.stack ?? error.message}\n`);
+        await writeStream(process.stderr, `${error.stack ?? error.message}\n`);
     }
     else {
-        process.stderr.write(`${String(error)}\n`);
+        await writeStream(process.stderr, `${String(error)}\n`);
     }
 }
 /**
@@ -198,7 +209,7 @@ export async function drive(transport, hookFn) {
             cleanupQuietly();
             process.exit(FALLBACK_EXIT_SUCCESS);
         }
-        writeUnexpectedErrorStderr(error);
+        await writeUnexpectedErrorStderr(error);
         cleanupQuietly();
         process.exit(FALLBACK_EXIT_ERROR);
     }
@@ -206,15 +217,15 @@ export async function drive(transport, hookFn) {
         cleanup(policy, onUnexpectedError);
     }
     catch (error) {
-        writeUnexpectedErrorStderr(error);
+        await writeUnexpectedErrorStderr(error);
         process.exit(FALLBACK_EXIT_ERROR);
     }
     if (finalized.stderr !== undefined) {
-        process.stderr.write(finalized.stderr);
+        await writeStream(process.stderr, finalized.stderr);
     }
     if (finalized.stdout !== undefined) {
         try {
-            process.stdout.write(finalized.stdout);
+            await writeStream(process.stdout, finalized.stdout);
         }
         catch (error) {
             if (policy === "continue") {
@@ -222,7 +233,7 @@ export async function drive(transport, hookFn) {
                 cleanupQuietly();
                 process.exit(FALLBACK_EXIT_SUCCESS);
             }
-            writeUnexpectedErrorStderr(error);
+            await writeUnexpectedErrorStderr(error);
             cleanupQuietly();
             process.exit(FALLBACK_EXIT_ERROR);
         }

package/dist/scaffold.js

@@ -131,7 +131,7 @@ function generatePackageJson(projectName, outputPath) {
             typecheck: "tsc --noEmit",
         },
         dependencies: {
-            "@goodfoot/agent-hooks": "^1.0.10",
+            "@goodfoot/agent-hooks": "^1.0.12",
         },
         devDependencies: {
             "@biomejs/biome": "2.4.16",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodfoot/agent-hooks",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "Unified agent hooks library: shared core runtime with per-agent entry points for Claude Code, Codex, and Antigravity",
   "homepage": "https://github.com/goodfoot-io/marketplace/tree/main/packages/agent-hooks",
   "repository": {
@@ -22,7 +22,7 @@
   "scripts": {
     "typecheck": "tsc --noEmit",
     "build": "tsc --build tsconfig.build.json",
-    "lint": "biome check --write --unsafe --max-diagnostics 500 ./src ./tests ./e2e ./scripts && node ./scripts/check-stale-imports.mjs",
+    "lint": "biome check --write --unsafe --max-diagnostics 500 ./src ./tests ./e2e ./scripts ./vitest.config.ts && node ./scripts/check-stale-imports.mjs",
     "test": "node ./scripts/check-stale-imports.mjs && node ./scripts/check-agent-duplication.mjs && vitest run",
     "release": "bash ../../scripts/release-package.sh agent-hooks",
     "release:dry-run": "bash ../../scripts/release-package.sh agent-hooks --dry-run"
@@ -56,7 +56,7 @@
     }
   },
   "dependencies": {
-    "esbuild": "^0.24.0",
+    "esbuild": "^0.28.2",
     "glob": "^11.0.0",
     "typescript": "^5.9.3"
   },
@@ -70,10 +70,15 @@
   },
   "devDependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.3.162",
+    "@anthropic-ai/sdk": "^0.133.0",
     "@biomejs/biome": "2.4.16",
+    "@goodfoot/vitest-cache": "workspace:*",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@opencode-ai/plugin": "1.18.23",
-    "@types/node": "^24",
+    "@types/node": "^26.6.5",
     "tsx": "^4.20.6",
-    "vitest": "4.0.13"
+    "vite": "8.3.4",
+    "vitest": "patch:vitest@npm%3A5.0.4#~/.yarn/patches/vitest-npm-5.0.4-2ab4bceca5.patch",
+    "zod": "^4.6.7"
   }
 }

package/types/cli.d.ts

@@ -106,17 +106,22 @@ interface MatcherEntry {
  * The complete hooks.json structure expected by Claude Code.
  *
  * Format: { hooks: { EventType: [ { matcher?, hooks: [...] } ] } }
+ *
+ * `hooks` is the only key that may appear here: the host validates hooks.json
+ * against its own schema and rejects files carrying unknown keys, so build
+ * tracking lives in the sidecar instead (see HooksMeta).
  */
 interface HooksJson {
     /** Object keyed by event type (PreToolUse, SessionStart, etc.). */
     hooks: Partial<Record<HookEventName, MatcherEntry[]>>;
-    /** Generated file tracking metadata. */
-    __generated: {
-        /** Array of generated filenames. */
-        files: string[];
-        /** ISO timestamp of generation. */
-        timestamp: string;
-    };
+}
+/**
+ * Build tracking metadata for a generated hooks.json, written to a sidecar
+ * file beside it (hooks.meta.json) rather than inside hooks.json itself.
+ */
+interface HooksMeta {
+    /** Bundle filenames this package generated, relative to the bin/ directory. */
+    files: string[];
 }
 /**
  * Parses command-line arguments.
@@ -301,19 +306,40 @@ declare function generateHooksJson(compiledHooks: CompiledHook[], buildDir: stri
  */
 declare function readExistingHooksJson(outputPath: string): HooksJson | undefined;
 /**
- * Removes previously generated hook files from disk.
- * Only removes files that were tracked in __generated.files.
- * @param existingHooksJson - The existing hooks.json content
+ * Absolute path of the tracking sidecar that sits beside hooks.json.
+ * @param outputPath - Path to hooks.json
+ * @returns Path to hooks.meta.json
+ */
+declare function hooksMetaPath(outputPath: string): string;
+/**
+ * Reads the tracking sidecar beside hooks.json if it exists.
+ *
+ * A missing or unreadable sidecar is not fatal: it only means no generated
+ * filenames are known, so every existing entry is treated as externally
+ * authored and preserved.
+ * @param outputPath - Path to the hooks.json the sidecar describes
+ * @returns Parsed HooksMeta or undefined if absent or unusable
+ */
+declare function readHooksMeta(outputPath: string): HooksMeta | undefined;
+/**
+ * Removes bundles a previous build generated that this build did not. Only
+ * filenames tracked in the sidecar are ever removed, and callers must run this
+ * after the new hooks.json is on disk so no reachable state loses a file it
+ * references.
+ * @param previousMeta - Tracking sidecar from the previous build, if any
  * @param outputDir - Directory containing the generated files
+ * @param keepFilenames - Filenames written by the current build
  */
-declare function removeOldGeneratedFiles(existingHooksJson: HooksJson, outputDir: string): void;
+declare function removeStaleGeneratedFiles(previousMeta: HooksMeta | undefined, outputDir: string, keepFilenames: Set<string>): void;
 /**
- * Extracts hooks from an existing hooks.json that were NOT generated by this package.
- * Identifies generated hooks by checking if their command path matches the generated file pattern.
+ * Extracts hooks from an existing hooks.json that were NOT generated by this
+ * package. Generated hooks are identified by the filenames tracked in the
+ * sidecar, so entries authored anywhere else survive a rebuild untouched.
  * @param existingHooksJson - The existing hooks.json content
+ * @param meta - Tracking sidecar from the previous build, if any
  * @returns Object containing preserved hooks (keyed by event type)
  */
-declare function extractPreservedHooks(existingHooksJson: HooksJson): Partial<Record<HookEventName, MatcherEntry[]>>;
+declare function extractPreservedHooks(existingHooksJson: HooksJson, meta: HooksMeta | undefined): Partial<Record<HookEventName, MatcherEntry[]>>;
 /**
  * Merges preserved hooks with newly generated hooks.
  * Preserved hooks are added first, then new hooks are appended.
@@ -323,4 +349,4 @@ declare function extractPreservedHooks(existingHooksJson: HooksJson): Partial<Re
  */
 declare function mergeHooksJson(newHooksJson: HooksJson, preservedHooks: Partial<Record<HookEventName, MatcherEntry[]>>): HooksJson;
 export type { CliArgs, CompiledHook, HookConfig, HookLoaderMap, HookMetadata, HooksJson, MatcherEntry };
-export { analyzeHookFile, buildLoaderMap, buildLoaderMap as buildEsbuildLoaderMap, compileHook, detectHookContext, discoverHookFiles, discoverHookFiles as discoverHookSourceFiles, extractPreservedHooks, generateCommandPath, generateContentHash, generateContentHash as sha256Prefix8, generateHooksJson, groupHooksByEventAndMatcher, HOOK_FACTORY_TO_EVENT, mergeHooksJson, moduleWorkingDir, parseArgs, parseLoaderFlag, parseLoaderFlag as parseEsbuildLoaderFlag, pruneStaleHashedBundles, readExistingHooksJson, removeOldGeneratedFiles, symlinkVisiblePath, validateArgs, };
+export { analyzeHookFile, buildLoaderMap, buildLoaderMap as buildEsbuildLoaderMap, compileHook, detectHookContext, discoverHookFiles, discoverHookFiles as discoverHookSourceFiles, extractPreservedHooks, generateCommandPath, generateContentHash, generateContentHash as sha256Prefix8, generateHooksJson, groupHooksByEventAndMatcher, HOOK_FACTORY_TO_EVENT, hooksMetaPath, mergeHooksJson, moduleWorkingDir, parseArgs, parseLoaderFlag, parseLoaderFlag as parseEsbuildLoaderFlag, pruneStaleHashedBundles, readExistingHooksJson, readHooksMeta, removeStaleGeneratedFiles, symlinkVisiblePath, validateArgs, };