Function removeHookCommandsMatching

src/installer/targets/claude.ts:334–378

* Remove stale codegraph auto-sync hooks from Claude `settings.json`. * * Surgical at the individual-command level: only entries matching * `isLegacyCodegraphHookCommand` are dropped, so a sibling hook sharing * a matcher group (or the Stop event) with ours survives. We prune a * matcher group

(
  loc: Location,
  match: (command: unknown) => boolean,
)

 * `install` (an upgrade self-heals) and `uninstall`.
 */
function removeHookCommandsMatching(
  loc: Location,
  match: (command: unknown) => boolean,
): WriteResult['files'][number] {
  const file = settingsJsonPath(loc);
  if (!fs.existsSync(file)) return { path: file, action: 'not-found' };

  const settings = readJsonFile(file);
  const hooks = settings.hooks;
  if (!hooks || typeof hooks !== 'object' || Array.isArray(hooks)) {
    return { path: file, action: 'unchanged' };
  }

  // Pass 1: drop matching command(s) from inside every matcher group.
  let removedAny = false;
  for (const event of Object.keys(hooks)) {
    const groups = hooks[event];
    if (!Array.isArray(groups)) continue;
    for (const group of groups) {
      if (!group || !Array.isArray(group.hooks)) continue;
      const before = group.hooks.length;
      group.hooks = group.hooks.filter((h: any) => !match(h?.command));
      if (group.hooks.length !== before) removedAny = true;
    }
  }

  if (!removedAny) return { path: file, action: 'unchanged' };

  // Pass 2: prune empty matcher groups, then events with no groups left,
  // then an empty top-level `hooks`. Guarded by `removedAny` so we never
  // restructure a settings.json that had no matching hooks. Sibling hooks
  // (a different command in the group, or a different event) survive.
  for (const event of Object.keys(hooks)) {
    const groups = hooks[event];
    if (!Array.isArray(groups)) continue;
    hooks[event] = groups.filter(
      (g: any) => !(g && Array.isArray(g.hooks) && g.hooks.length === 0),
    );
    if (hooks[event].length === 0) delete hooks[event];
  }
  if (Object.keys(hooks).length === 0) delete settings.hooks;

  writeJsonFile(file, settings);
  return { path: file, action: 'removed' };
}

/**
 * Remove stale codegraph auto-sync hooks (`mark-dirty` / `sync-if-dirty`) that a