CRASH Reference: Hooks¶

GENERATED FILE -- do not hand-edit. Produced from every item under src/gald3r_core/platform/pipeline/neutral_source/hooks/ by gald3r platform crash-reference. To regenerate: uv run gald3r platform crash-reference --apply.

Hooks are the one CRASH type that is real, executing code -- plain scripts (mostly .py) wired into your IDE's lifecycle events (session start, pre-tool-call, stop, ...) by a platform-specific registration file. You do not invoke a hook by name; it fires automatically when its registered event happens. This page documents what each hook does and when it fires -- never its internal implementation.

39 hooks total.

Browse by category¶

Tasks¶

Creating, updating, and tracking work in .gald3r/tasks/.

g-hk-ggo-stop-detect -- Python port of g-hk-ggo-stop-detect.

Pipelines & Autopilot (the g-go family)¶

Implement/review pipelines, swarms, autopilot loops, and agent hiring.

g-hk-agent-worktree-janitor -- Agent-worktree janitor hook.
g-hk-pre-tool-call-worktree-guard -- Worktree-primary containment guard.

Setup & Project Identity¶

First-time setup, PROJECT.md/CONSTRAINTS.md, ideas, and personality.

g-hk-component-tag-check -- Thin resolver+verb dispatcher for the g-rl-38 subsystem-tagging guard.
g-hk-goal-stop-detect -- Goal quit-condition stop hook.
g-hk-graph-update -- Python port of g-hk-graph-update.
g-hk-pre-tool-call -- Python port of g-hk-pre-tool-call.
g-hk-pre-tool-call-gald3r-guard -- Python port of g-hk-pre-tool-call-gald3r-guard.
g-hk-setup-user -- Python port of g-hk-setup-user; reconciled onto the unified home.

WPAC & Workspace Coordination¶

Cross-project topology, inbox triage, broadcasts, and Workspace-Control.

g-hk-pre-tool-call-member-gald3r-guard -- Thin resolver+verb dispatcher for the member-repo .gald3r/ guard.
g-hk-wpac-inbox-check -- Python port of g-hk-wpac-inbox-check.
raw-inbox-watcher -- Python port of raw-inbox-watcher.

Release & Versioning¶

CHANGELOG promotion, release records, ROADMAP, ship/ hotfix flow.

g-hk-pre-tool-call-prd-freeze -- Python port of g-hk-pre-tool-call-prd-freeze.

Vault & Research¶

The file-first knowledge vault, recon/ingest, and clean-room rewrites.

g-hk-vault-migrate -- Python port of g-hk-vault-migrate.
g-hk-vault-reindex -- Python port of g-hk-vault-reindex; dual-index regen.
g-hk-vault-resolve -- Python port of g-hk-vault-resolve.
g-hk-vault-verify -- Python port of g-hk-vault-verify.

Platforms & Providers¶

Cross-IDE install/parity, per-platform specs, PowerShell/CLI reference.

g-hk-encoding-normalize -- Python port of g-hk-encoding-normalize.
g-hk-on-session-end -- Canonical session-end event entrypoint.
g-hk-on-session-start -- Canonical session-start event entrypoint.
g-hk-on-stop -- Canonical stop event entrypoint.
g-hk-on-tool-end -- Canonical tool-end event entrypoint.
g-hk-on-tool-start -- Canonical tool-start event entrypoint.
g-hk-on-user-prompt-submit -- Canonical user-prompt-submit event entrypoint.
g-hk-tel-tap -- TEL host-CLI hook tap (Claude Code first).
g-hk-validate-shell -- Thin resolver+verb dispatcher for the dangerous-shell-command guard.

Security & Compliance¶

Secret scanning, license/dependency compliance, git-sanity gates.

g-hk-policy-check -- gald3r policy-as-code guardrail hook.
g-hk-pre-commit -- Python port of g-hk-pre-commit.
g-hk-pre-push -- gald3r optional pre-push gate hook (opt-in).

Memory & Knowledge¶

Session learning, memory recall, and knowledge-graph tooling.

g-hk-nightly-learn -- Python port of g-hk-nightly-learn; engine-verb dispatch.

Logging & Diagnostics¶

Activation stats, chat logs, and session diagnostics.

g-hk-agent-complete -- Python port of g-hk-agent-complete.
g-hk-crash-record -- Python port of g-hk-crash-record.
g-hk-post-session-trace -- Session-trace closer
g-hk-post-skill-timing -- Python port of g-hk-post-skill-timing.
g-hk-pre-session-trace -- Session-trace opener
g-hk-pre-skill-timing -- Python port of g-hk-pre-skill-timing.
g-hk-session-end -- Python port of g-hk-session-end.
g-hk-session-start -- Python port of g-hk-session-start.

Other¶

No subsystem group declared, or a declared group outside the canonical PRODUCT_SYSTEMS.md registry -- see each item's own card for which case applies.

g-hk-claude-chat-logger -- Persist Claude Code chat history to .gald3r/logs/

Full reference¶

`g-hk-agent-complete`¶

Hook ID: g-hk-agent-complete
Group: Logging & Diagnostics

Purpose: Python port of g-hk-agent-complete.

When to use: Python port of g-hk-agent-complete. Fires on: Stop.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: Stop
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-agent-complete.py

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-agent-complete.py

`g-hk-agent-worktree-janitor`¶

Hook ID: g-hk-agent-worktree-janitor
Group: Pipelines & Autopilot (the g-go family)

Purpose: Agent-worktree janitor hook.

When to use: Agent-worktree janitor hook. Fires on: SessionEnd.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: SessionEnd
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-agent-worktree-janitor.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-agent-worktree-janitor.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-agent-worktree-janitor.py

`g-hk-claude-chat-logger`¶

Hook ID: g-hk-claude-chat-logger
Group: Other (no subsystem group declared)

Purpose: Persist Claude Code chat history to .gald3r/logs/

When to use: Persist Claude Code chat history to .gald3r/logs/ — the Claude-side mirror of g-hk-cursor-chat-logger.py. Fires on: Stop, Scheduled/nightly.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: Stop, Scheduled/nightly
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-claude-chat-logger.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-claude-chat-logger.md

Related: none in the same group

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-claude-chat-logger.py

Metadata note: hooks/g-hk-claude-chat-logger: missing @subsystems: tag (and no subsystem_memberships: in companion .md)

`g-hk-component-tag-check`¶

Hook ID: g-hk-component-tag-check
Group: Setup & Project Identity

Purpose: Thin resolver+verb dispatcher for the g-rl-38 subsystem-tagging guard.

When to use: Thin resolver+verb dispatcher for the g-rl-38 subsystem-tagging guard. Fires on: PreToolUse, pre-commit (git hook), pre-push (git hook).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: PreToolUse, pre-commit (git hook), pre-push (git hook)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-component-tag-check.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-component-tag-check.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-component-tag-check.py

`g-hk-crash-record`¶

Hook ID: g-hk-crash-record
Group: Logging & Diagnostics

Purpose: Python port of g-hk-crash-record.

When to use: Python port of g-hk-crash-record. Fires on: PreToolUse.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: PreToolUse
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-crash-record.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-crash-record.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-crash-record.py

`g-hk-encoding-normalize`¶

Hook ID: g-hk-encoding-normalize
Group: Platforms & Providers

Purpose: Python port of g-hk-encoding-normalize.

When to use: Python port of g-hk-encoding-normalize. Fires on: pre-commit (git hook).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: pre-commit (git hook)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-encoding-normalize.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-encoding-normalize.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-encoding-normalize.py

`g-hk-ggo-stop-detect`¶

Hook ID: g-hk-ggo-stop-detect
Group: Tasks

Purpose: Python port of g-hk-ggo-stop-detect.

When to use: Python port of g-hk-ggo-stop-detect. Fires on: Stop, Scheduled/nightly.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: Stop, Scheduled/nightly
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-ggo-stop-detect.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-ggo-stop-detect.md

Related: none in the same group

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-ggo-stop-detect.py

`g-hk-goal-stop-detect`¶

Hook ID: g-hk-goal-stop-detect
Group: Setup & Project Identity

Purpose: Goal quit-condition stop hook.

When to use: Goal quit-condition stop hook. Fires on: Stop.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: Stop
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-goal-stop-detect.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-goal-stop-detect.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-goal-stop-detect.py

`g-hk-graph-update`¶

Hook ID: g-hk-graph-update
Group: Setup & Project Identity

Purpose: Python port of g-hk-graph-update.

When to use: Python port of g-hk-graph-update. Fires on: lifecycle event (see source for exact trigger).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: lifecycle event (see source for exact trigger)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-graph-update.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-graph-update.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-graph-update.py

`g-hk-nightly-learn`¶

Hook ID: g-hk-nightly-learn
Group: Memory & Knowledge

Purpose: Python port of g-hk-nightly-learn; engine-verb dispatch.

When to use: Python port of g-hk-nightly-learn; engine-verb dispatch. Fires on: Scheduled/nightly.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: Scheduled/nightly
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-nightly-learn.py

Related: none in the same group

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-nightly-learn.py

`g-hk-on-session-end`¶

Hook ID: g-hk-on-session-end
Group: Platforms & Providers

Purpose: Canonical session-end event entrypoint.

When to use: Canonical session-end event entrypoint. Fires on: lifecycle event (see source for exact trigger).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: lifecycle event (see source for exact trigger)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-on-session-end.py

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-on-session-end.py

`g-hk-on-session-start`¶

Hook ID: g-hk-on-session-start
Group: Platforms & Providers

Purpose: Canonical session-start event entrypoint.

When to use: Canonical session-start event entrypoint. Fires on: lifecycle event (see source for exact trigger).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: lifecycle event (see source for exact trigger)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-on-session-start.py

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-on-session-start.py

`g-hk-on-stop`¶

Hook ID: g-hk-on-stop
Group: Platforms & Providers

Purpose: Canonical stop event entrypoint.

When to use: Canonical stop event entrypoint. Fires on: lifecycle event (see source for exact trigger).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: lifecycle event (see source for exact trigger)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-on-stop.py

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-on-stop.py

`g-hk-on-tool-end`¶

Hook ID: g-hk-on-tool-end
Group: Platforms & Providers

Purpose: Canonical tool-end event entrypoint.

When to use: Canonical tool-end event entrypoint. Fires on: PostToolUse.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: PostToolUse
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-on-tool-end.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-on-tool-end.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-on-tool-end.py

`g-hk-on-tool-start`¶

Hook ID: g-hk-on-tool-start
Group: Platforms & Providers

Purpose: Canonical tool-start event entrypoint.

When to use: Canonical tool-start event entrypoint. Fires on: PreToolUse.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: PreToolUse
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-on-tool-start.py

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-on-tool-start.py

`g-hk-on-user-prompt-submit`¶

Hook ID: g-hk-on-user-prompt-submit
Group: Platforms & Providers

Purpose: Canonical user-prompt-submit event entrypoint.

When to use: Canonical user-prompt-submit event entrypoint. Fires on: UserPromptSubmit.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: UserPromptSubmit
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-on-user-prompt-submit.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-on-user-prompt-submit.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-on-user-prompt-submit.py

`g-hk-policy-check`¶

Hook ID: g-hk-policy-check
Group: Security & Compliance

Purpose: gald3r policy-as-code guardrail hook.

When to use: gald3r policy-as-code guardrail hook. Fires on: PreToolUse, pre-commit (git hook).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: PreToolUse, pre-commit (git hook)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-policy-check.py

Related: g-hk-pre-commit, g-hk-pre-push

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-policy-check.py

`g-hk-post-session-trace`¶

Hook ID: g-hk-post-session-trace
Group: Logging & Diagnostics

Purpose: Session-trace closer

When to use: Session-trace closer — fires on the canonical stop and session-end events. Fires on: lifecycle event (see source for exact trigger).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: lifecycle event (see source for exact trigger)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-post-session-trace.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-post-session-trace.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-post-session-trace.py

`g-hk-post-skill-timing`¶

Hook ID: g-hk-post-skill-timing
Group: Logging & Diagnostics

Purpose: Python port of g-hk-post-skill-timing.

When to use: Python port of g-hk-post-skill-timing. Fires on: lifecycle event (see source for exact trigger).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: lifecycle event (see source for exact trigger)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-post-skill-timing.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-post-skill-timing.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-post-skill-timing.py

`g-hk-pre-commit`¶

Hook ID: g-hk-pre-commit
Group: Security & Compliance

Purpose: Python port of g-hk-pre-commit.

When to use: Python port of g-hk-pre-commit. Fires on: pre-commit (git hook).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: pre-commit (git hook)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-commit.py

Related: g-hk-policy-check, g-hk-pre-push

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-commit.py

`g-hk-pre-push`¶

Hook ID: g-hk-pre-push
Group: Security & Compliance

Purpose: gald3r optional pre-push gate hook (opt-in).

When to use: gald3r optional pre-push gate hook (opt-in). Fires on: pre-push (git hook).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: pre-push (git hook)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-push.py

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-push.py

`g-hk-pre-session-trace`¶

Hook ID: g-hk-pre-session-trace
Group: Logging & Diagnostics

Purpose: Session-trace opener

When to use: Session-trace opener — fires on the canonical session-start event. Fires on: SessionStart.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: SessionStart
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-session-trace.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-session-trace.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-session-trace.py

`g-hk-pre-skill-timing`¶

Hook ID: g-hk-pre-skill-timing
Group: Logging & Diagnostics

Purpose: Python port of g-hk-pre-skill-timing.

When to use: Python port of g-hk-pre-skill-timing. Fires on: lifecycle event (see source for exact trigger).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: lifecycle event (see source for exact trigger)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-skill-timing.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-skill-timing.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-skill-timing.py

`g-hk-pre-tool-call`¶

Hook ID: g-hk-pre-tool-call
Group: Setup & Project Identity

Purpose: Python port of g-hk-pre-tool-call.

When to use: Python port of g-hk-pre-tool-call. Fires on: PreToolUse.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: PreToolUse
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-tool-call.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-tool-call.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-tool-call.py

`g-hk-pre-tool-call-gald3r-guard`¶

Hook ID: g-hk-pre-tool-call-gald3r-guard
Group: Setup & Project Identity

Purpose: Python port of g-hk-pre-tool-call-gald3r-guard.

When to use: Python port of g-hk-pre-tool-call-gald3r-guard. Fires on: PreToolUse.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: PreToolUse
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-tool-call-gald3r-guard.py

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-tool-call-gald3r-guard.py

`g-hk-pre-tool-call-member-gald3r-guard`¶

Hook ID: g-hk-pre-tool-call-member-gald3r-guard
Group: WPAC & Workspace Coordination

Purpose: Thin resolver+verb dispatcher for the member-repo .gald3r/ guard.

When to use: Thin resolver+verb dispatcher for the member-repo .gald3r/ guard. Fires on: PreToolUse.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: PreToolUse
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-tool-call-member-gald3r-guard.py

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-tool-call-member-gald3r-guard.py

`g-hk-pre-tool-call-prd-freeze`¶

Hook ID: g-hk-pre-tool-call-prd-freeze
Group: Release & Versioning

Purpose: Python port of g-hk-pre-tool-call-prd-freeze.

When to use: Python port of g-hk-pre-tool-call-prd-freeze. Fires on: PreToolUse.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: PreToolUse
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-tool-call-prd-freeze.py

Related: none in the same group

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-tool-call-prd-freeze.py

`g-hk-pre-tool-call-worktree-guard`¶

Hook ID: g-hk-pre-tool-call-worktree-guard
Group: Pipelines & Autopilot (the g-go family)

Purpose: Worktree-primary containment guard.

When to use: Worktree-primary containment guard. Fires on: PreToolUse.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: PreToolUse
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-tool-call-worktree-guard.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-tool-call-worktree-guard.md

Related: g-hk-agent-worktree-janitor

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-pre-tool-call-worktree-guard.py

`g-hk-session-end`¶

Hook ID: g-hk-session-end
Group: Logging & Diagnostics

Purpose: Python port of g-hk-session-end.

When to use: Python port of g-hk-session-end. Fires on: Stop, Scheduled/nightly.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: Stop, Scheduled/nightly
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-session-end.py

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-session-end.py

`g-hk-session-start`¶

Hook ID: g-hk-session-start
Group: Logging & Diagnostics

Purpose: Python port of g-hk-session-start.

When to use: Python port of g-hk-session-start. Fires on: lifecycle event (see source for exact trigger).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: lifecycle event (see source for exact trigger)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-session-start.py

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-session-start.py

`g-hk-setup-user`¶

Hook ID: g-hk-setup-user
Group: Setup & Project Identity

Purpose: Python port of g-hk-setup-user; reconciled onto the unified home.

When to use: Python port of g-hk-setup-user; reconciled onto the unified home. Fires on: lifecycle event (see source for exact trigger).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: lifecycle event (see source for exact trigger)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-setup-user.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-setup-user.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-setup-user.py

`g-hk-tel-tap`¶

Hook ID: g-hk-tel-tap
Group: Platforms & Providers

Purpose: TEL host-CLI hook tap (Claude Code first).

When to use: TEL host-CLI hook tap (Claude Code first). Fires on: PostToolUse.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: PostToolUse
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-tel-tap.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-tel-tap.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-tel-tap.py

`g-hk-validate-shell`¶

Hook ID: g-hk-validate-shell
Group: Platforms & Providers

Purpose: Thin resolver+verb dispatcher for the dangerous-shell-command guard.

When to use: Thin resolver+verb dispatcher for the dangerous-shell-command guard. Fires on: PreToolUse, pre-push (git hook).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: PreToolUse, pre-push (git hook)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-validate-shell.py

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-validate-shell.py

`g-hk-vault-migrate`¶

Hook ID: g-hk-vault-migrate
Group: Vault & Research

Purpose: Python port of g-hk-vault-migrate.

When to use: Python port of g-hk-vault-migrate. Fires on: lifecycle event (see source for exact trigger).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: lifecycle event (see source for exact trigger)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-vault-migrate.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-vault-migrate.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-vault-migrate.py

`g-hk-vault-reindex`¶

Hook ID: g-hk-vault-reindex
Group: Vault & Research

Purpose: Python port of g-hk-vault-reindex; dual-index regen.

When to use: Python port of g-hk-vault-reindex; dual-index regen. Fires on: lifecycle event (see source for exact trigger).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: lifecycle event (see source for exact trigger)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-vault-reindex.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-vault-reindex.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-vault-reindex.py

`g-hk-vault-resolve`¶

Hook ID: g-hk-vault-resolve
Group: Vault & Research

Purpose: Python port of g-hk-vault-resolve.

When to use: Python port of g-hk-vault-resolve. Fires on: lifecycle event (see source for exact trigger).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: lifecycle event (see source for exact trigger)
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-vault-resolve.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-vault-resolve.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-vault-resolve.py

`g-hk-vault-verify`¶

Hook ID: g-hk-vault-verify
Group: Vault & Research

Purpose: Python port of g-hk-vault-verify.

When to use: Python port of g-hk-vault-verify. Fires on: SessionStart.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: SessionStart
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-vault-verify.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-vault-verify.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-vault-verify.py

`g-hk-wpac-inbox-check`¶

Hook ID: g-hk-wpac-inbox-check
Group: WPAC & Workspace Coordination

Purpose: Python port of g-hk-wpac-inbox-check.

When to use: Python port of g-hk-wpac-inbox-check. Fires on: SessionStart.

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: SessionStart
Naming: standard g-hk- naming convention
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-wpac-inbox-check.py

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/g-hk-wpac-inbox-check.py

`raw-inbox-watcher`¶

Hook ID: raw-inbox-watcher
Group: WPAC & Workspace Coordination

Purpose: Python port of raw-inbox-watcher.

When to use: Python port of raw-inbox-watcher. Fires on: lifecycle event (see source for exact trigger).

Arguments: none

Example invocation:

Any platform: Registered automatically by gald3r platform install <platform>'s hook wiring -- not manually invoked.

Fires on: lifecycle event (see source for exact trigger)
Naming: pre-g-hk- naming exception, registered directly in platform hook tables
Source files: src/gald3r_core/platform/pipeline/neutral_source/hooks/raw-inbox-watcher.py, src/gald3r_core/platform/pipeline/neutral_source/hooks/raw-inbox-watcher.md

Source: src/gald3r_core/platform/pipeline/neutral_source/hooks/raw-inbox-watcher.py

CRASH Reference: Hooks¶

Browse by category¶

Tasks¶

Pipelines & Autopilot (the g-go family)¶

Setup & Project Identity¶

WPAC & Workspace Coordination¶

Release & Versioning¶

Vault & Research¶

Platforms & Providers¶

Security & Compliance¶

Memory & Knowledge¶

Logging & Diagnostics¶

Other¶

Full reference¶

g-hk-agent-complete¶

g-hk-agent-worktree-janitor¶

g-hk-claude-chat-logger¶

g-hk-component-tag-check¶

g-hk-crash-record¶

g-hk-encoding-normalize¶

g-hk-ggo-stop-detect¶

g-hk-goal-stop-detect¶

g-hk-graph-update¶

g-hk-nightly-learn¶

g-hk-on-session-end¶

g-hk-on-session-start¶

g-hk-on-stop¶

g-hk-on-tool-end¶

g-hk-on-tool-start¶

g-hk-on-user-prompt-submit¶

g-hk-policy-check¶

g-hk-post-session-trace¶

g-hk-post-skill-timing¶

g-hk-pre-commit¶

g-hk-pre-push¶

g-hk-pre-session-trace¶

g-hk-pre-skill-timing¶

g-hk-pre-tool-call¶

g-hk-pre-tool-call-gald3r-guard¶

g-hk-pre-tool-call-member-gald3r-guard¶

g-hk-pre-tool-call-prd-freeze¶

g-hk-pre-tool-call-worktree-guard¶

g-hk-session-end¶

g-hk-session-start¶

g-hk-setup-user¶

g-hk-tel-tap¶

g-hk-validate-shell¶

g-hk-vault-migrate¶

g-hk-vault-reindex¶

g-hk-vault-resolve¶

g-hk-vault-verify¶

g-hk-wpac-inbox-check¶

raw-inbox-watcher¶

`g-hk-agent-complete`¶

`g-hk-agent-worktree-janitor`¶

`g-hk-claude-chat-logger`¶

`g-hk-component-tag-check`¶

`g-hk-crash-record`¶

`g-hk-encoding-normalize`¶

`g-hk-ggo-stop-detect`¶

`g-hk-goal-stop-detect`¶

`g-hk-graph-update`¶

`g-hk-nightly-learn`¶

`g-hk-on-session-end`¶

`g-hk-on-session-start`¶

`g-hk-on-stop`¶

`g-hk-on-tool-end`¶

`g-hk-on-tool-start`¶

`g-hk-on-user-prompt-submit`¶

`g-hk-policy-check`¶

`g-hk-post-session-trace`¶

`g-hk-post-skill-timing`¶

`g-hk-pre-commit`¶

`g-hk-pre-push`¶

`g-hk-pre-session-trace`¶

`g-hk-pre-skill-timing`¶

`g-hk-pre-tool-call`¶

`g-hk-pre-tool-call-gald3r-guard`¶

`g-hk-pre-tool-call-member-gald3r-guard`¶

`g-hk-pre-tool-call-prd-freeze`¶

`g-hk-pre-tool-call-worktree-guard`¶

`g-hk-session-end`¶

`g-hk-session-start`¶

`g-hk-setup-user`¶

`g-hk-tel-tap`¶

`g-hk-validate-shell`¶

`g-hk-vault-migrate`¶

`g-hk-vault-reindex`¶

`g-hk-vault-resolve`¶

`g-hk-vault-verify`¶

`g-hk-wpac-inbox-check`¶

`raw-inbox-watcher`¶