Documentation
¶
Overview ¶
Package hooks knows how seamark's Claude Code hooks are spelled in .claude/settings.json: the marker strings, the ownership rule, and gate-mode detection live here once — init writes hooks, status reads them, and two copies of the matching logic would drift.
Index ¶
- Constants
- func ForEachCommand(pre []any, fn func(matcher string, h map[string]any, cmd string))
- func GateMarker(mode string) string
- func InstalledGateMode(settings map[string]any) string
- func InstalledGateModeAt(root string) (string, error)
- func IsSeamarkBinary(command string) bool
- func LessonsHookInstalled(settings map[string]any) bool
- func OwnedBySeamark(cmd string, markers []string) bool
- func ReadSettings(root string) (map[string]any, error)
Constants ¶
const ( ModeWarn = "warn" ModeEnforce = "enforce" )
Gate hook modes. Warn installs a hook that follows .seamark/policy.yaml and never blocks by itself; enforce bakes --enforce into the hook, so blocking verdicts exit 2 and the gate's own failures fail closed.
const LessonsMarker = "lessons --hook"
LessonsMarker is the edit-lessons hook's argument tail.
const LessonsResetMarker = "lessons --hook-reset"
LessonsResetMarker is the PostCompact hook that starts a new lesson delivery generation for the provider session.
Variables ¶
This section is empty.
Functions ¶
func ForEachCommand ¶
ForEachCommand visits every command hook under one hook-event array, passing each entry's matcher alongside the hook.
func GateMarker ¶
GateMarker returns the gate hook's argument tail for a mode. Warn omits --enforce so .seamark/policy.yaml stays the single source of truth for blocking; enforce bakes the flag in, which also makes the gate's own failures block (fail closed).
func InstalledGateMode ¶
InstalledGateMode reports the mode of an OPERATIONAL gate hook in a parsed settings map: enforce, warn, or "" when none is present. A gate command only counts when wired the way Claude Code will actually run it — a "command"-typed hook whose matcher covers Bash; the same command under another matcher never fires on shell commands and must not report as installed.
func InstalledGateModeAt ¶
InstalledGateModeAt reads <root>/.claude/settings.json and reports the installed gate-hook mode; "" with a nil error when the file is absent or simply carries no seamark gate hook. An unreadable or unparseable file is an error — "your hook configuration cannot be read" and "no hook installed" are different findings and must not be conflated.
func IsSeamarkBinary ¶ added in v0.6.0
IsSeamarkBinary reports whether a command path names the seamark binary: exact basename "seamark", tolerating the Windows suffix. The hook owner, the Claude Code registration, and the Codex registration all use this one rule, so they agree on what is seamark's.
func LessonsHookInstalled ¶
LessonsHookInstalled reports whether seamark's edit-lessons hook is operational in a parsed settings map: a "command"-typed hook under a matcher covering Edit tools.
func OwnedBySeamark ¶
OwnedBySeamark reports whether cmd is one of seamark's own hook commands: a marker suffix AND a binary whose basename is exactly seamark (allowing the Windows .exe suffix). The binary check keeps the marker from claiming someone else's hook — `company-security gate --hook` (or a lookalike such as `seamark2`) must never be treated as ours.
Types ¶
This section is empty.
Source Files