import type { EventResult } from 'claude-code'

import { heldKind } from './held-kind.js'

/**
 * What a person reads, once for each plugin and kind in a session, when a
 * plugin they installed answered more permissively than what holds over it.
 *
 * It names the option an administrator sets to let such plugins override.
 *
 * @param plugin the plugin's name, or its batch's, as the trace names it
 * @param tool the tool the call named
 * @param held the verdict that holds, naming the rule behind it if one is
 * @returns the line
 */
export function heldNotice(
  plugin: string,
  tool: string,
  held: EventResult<'tool.check'>,
) {
  const kind = heldKind(held)
  const isRuled = held.rule !== undefined

  return (
    `${plugin} tried to lift ${kind.startsWith('a') ? 'an' : 'a'} ${kind}` +
    `${isRuled ? ' in your settings' : ''} from a ${tool} call` +
    `${isRuled ? ` (${held.rule})` : ''}; the ${kind} holds over the ` +
    'plugins you install (allowModsToOverrideDenyRules)'
  )
}