Skip to content

fix(preamble): probe gbrain engine liveness before recommending it #2321

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
syong wants to merge 1 commit into
base: main
Choose a base branch
from
Open

fix(preamble): probe gbrain engine liveness before recommending it #2321

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -356,10 +356,29 @@ if [ -f "$_GBRAIN_CONFIG" ] && command -v gbrain >/dev/null 2>&1; then
_GBRAIN_PIN_PATH="$_REPO_TOP/.gbrain-source"
fi
if [ -n "$_GBRAIN_PIN_PATH" ]; then
# Liveness probe. A config file + `--version` + a pin only prove gbrain is
# INSTALLED; none of them prove its engine is reachable. When the engine is
# down (disk full, container stopped, pooler unreachable, autopilot wedged)
# this block would still tell the agent to "prefer gbrain search" — so the
# agent keeps reaching for a tool whose every query fails, instead of
# falling back to Grep. One bounded probe closes that gap; the timeout
# keeps a hung engine from stalling the preamble of every skill.
_GBRAIN_ALIVE=0
if command -v timeout >/dev/null 2>&1; then
timeout 5 gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
else
gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
fi
if [ "$_GBRAIN_ALIVE" -eq 1 ]; then
echo "GBrain configured. Prefer \`gbrain search\`/\`gbrain query\` over Grep for"
echo "semantic questions; use \`gbrain code-def\`/\`code-refs\`/\`code-callers\` for"
echo "symbol-aware code lookup. See \"## GBrain Search Guidance\" in CLAUDE.md."
echo "Run /sync-gbrain to refresh."
else
echo "GBrain DOWN — this worktree is pinned, but a probe query failed, so"
echo "the engine is unreachable. Do NOT rely on \`gbrain search\`/\`code-def\`"
echo "this session; use Grep instead. Diagnose with \`gbrain doctor --fast\`."
fi
else
echo "GBrain configured but this worktree isn't pinned yet. Run \`/sync-gbrain --full\`"
echo "before relying on \`gbrain search\` for code questions in this worktree."
Expand Down
19 changes: 19 additions & 0 deletions autoplan/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -491,10 +491,29 @@ if [ -f "$_GBRAIN_CONFIG" ] && command -v gbrain >/dev/null 2>&1; then
_GBRAIN_PIN_PATH="$_REPO_TOP/.gbrain-source"
fi
if [ -n "$_GBRAIN_PIN_PATH" ]; then
# Liveness probe. A config file + `--version` + a pin only prove gbrain is
# INSTALLED; none of them prove its engine is reachable. When the engine is
# down (disk full, container stopped, pooler unreachable, autopilot wedged)
# this block would still tell the agent to "prefer gbrain search" — so the
# agent keeps reaching for a tool whose every query fails, instead of
# falling back to Grep. One bounded probe closes that gap; the timeout
# keeps a hung engine from stalling the preamble of every skill.
_GBRAIN_ALIVE=0
if command -v timeout >/dev/null 2>&1; then
timeout 5 gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
else
gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
fi
if [ "$_GBRAIN_ALIVE" -eq 1 ]; then
echo "GBrain configured. Prefer \`gbrain search\`/\`gbrain query\` over Grep for"
echo "semantic questions; use \`gbrain code-def\`/\`code-refs\`/\`code-callers\` for"
echo "symbol-aware code lookup. See \"## GBrain Search Guidance\" in CLAUDE.md."
echo "Run /sync-gbrain to refresh."
else
echo "GBrain DOWN — this worktree is pinned, but a probe query failed, so"
echo "the engine is unreachable. Do NOT rely on \`gbrain search\`/\`code-def\`"
echo "this session; use Grep instead. Diagnose with \`gbrain doctor --fast\`."
fi
else
echo "GBrain configured but this worktree isn't pinned yet. Run \`/sync-gbrain --full\`"
echo "before relying on \`gbrain search\` for code questions in this worktree."
Expand Down
19 changes: 19 additions & 0 deletions benchmark-models/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -360,10 +360,29 @@ if [ -f "$_GBRAIN_CONFIG" ] && command -v gbrain >/dev/null 2>&1; then
_GBRAIN_PIN_PATH="$_REPO_TOP/.gbrain-source"
fi
if [ -n "$_GBRAIN_PIN_PATH" ]; then
# Liveness probe. A config file + `--version` + a pin only prove gbrain is
# INSTALLED; none of them prove its engine is reachable. When the engine is
# down (disk full, container stopped, pooler unreachable, autopilot wedged)
# this block would still tell the agent to "prefer gbrain search" — so the
# agent keeps reaching for a tool whose every query fails, instead of
# falling back to Grep. One bounded probe closes that gap; the timeout
# keeps a hung engine from stalling the preamble of every skill.
_GBRAIN_ALIVE=0
if command -v timeout >/dev/null 2>&1; then
timeout 5 gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
else
gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
fi
if [ "$_GBRAIN_ALIVE" -eq 1 ]; then
echo "GBrain configured. Prefer \`gbrain search\`/\`gbrain query\` over Grep for"
echo "semantic questions; use \`gbrain code-def\`/\`code-refs\`/\`code-callers\` for"
echo "symbol-aware code lookup. See \"## GBrain Search Guidance\" in CLAUDE.md."
echo "Run /sync-gbrain to refresh."
else
echo "GBrain DOWN — this worktree is pinned, but a probe query failed, so"
echo "the engine is unreachable. Do NOT rely on \`gbrain search\`/\`code-def\`"
echo "this session; use Grep instead. Diagnose with \`gbrain doctor --fast\`."
fi
else
echo "GBrain configured but this worktree isn't pinned yet. Run \`/sync-gbrain --full\`"
echo "before relying on \`gbrain search\` for code questions in this worktree."
Expand Down
19 changes: 19 additions & 0 deletions benchmark/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -360,10 +360,29 @@ if [ -f "$_GBRAIN_CONFIG" ] && command -v gbrain >/dev/null 2>&1; then
_GBRAIN_PIN_PATH="$_REPO_TOP/.gbrain-source"
fi
if [ -n "$_GBRAIN_PIN_PATH" ]; then
# Liveness probe. A config file + `--version` + a pin only prove gbrain is
# INSTALLED; none of them prove its engine is reachable. When the engine is
# down (disk full, container stopped, pooler unreachable, autopilot wedged)
# this block would still tell the agent to "prefer gbrain search" — so the
# agent keeps reaching for a tool whose every query fails, instead of
# falling back to Grep. One bounded probe closes that gap; the timeout
# keeps a hung engine from stalling the preamble of every skill.
_GBRAIN_ALIVE=0
if command -v timeout >/dev/null 2>&1; then
timeout 5 gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
else
gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
fi
if [ "$_GBRAIN_ALIVE" -eq 1 ]; then
echo "GBrain configured. Prefer \`gbrain search\`/\`gbrain query\` over Grep for"
echo "semantic questions; use \`gbrain code-def\`/\`code-refs\`/\`code-callers\` for"
echo "symbol-aware code lookup. See \"## GBrain Search Guidance\" in CLAUDE.md."
echo "Run /sync-gbrain to refresh."
else
echo "GBrain DOWN — this worktree is pinned, but a probe query failed, so"
echo "the engine is unreachable. Do NOT rely on \`gbrain search\`/\`code-def\`"
echo "this session; use Grep instead. Diagnose with \`gbrain doctor --fast\`."
fi
else
echo "GBrain configured but this worktree isn't pinned yet. Run \`/sync-gbrain --full\`"
echo "before relying on \`gbrain search\` for code questions in this worktree."
Expand Down
19 changes: 19 additions & 0 deletions browse/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -358,10 +358,29 @@ if [ -f "$_GBRAIN_CONFIG" ] && command -v gbrain >/dev/null 2>&1; then
_GBRAIN_PIN_PATH="$_REPO_TOP/.gbrain-source"
fi
if [ -n "$_GBRAIN_PIN_PATH" ]; then
# Liveness probe. A config file + `--version` + a pin only prove gbrain is
# INSTALLED; none of them prove its engine is reachable. When the engine is
# down (disk full, container stopped, pooler unreachable, autopilot wedged)
# this block would still tell the agent to "prefer gbrain search" — so the
# agent keeps reaching for a tool whose every query fails, instead of
# falling back to Grep. One bounded probe closes that gap; the timeout
# keeps a hung engine from stalling the preamble of every skill.
_GBRAIN_ALIVE=0
if command -v timeout >/dev/null 2>&1; then
timeout 5 gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
else
gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
fi
if [ "$_GBRAIN_ALIVE" -eq 1 ]; then
echo "GBrain configured. Prefer \`gbrain search\`/\`gbrain query\` over Grep for"
echo "semantic questions; use \`gbrain code-def\`/\`code-refs\`/\`code-callers\` for"
echo "symbol-aware code lookup. See \"## GBrain Search Guidance\" in CLAUDE.md."
echo "Run /sync-gbrain to refresh."
else
echo "GBrain DOWN — this worktree is pinned, but a probe query failed, so"
echo "the engine is unreachable. Do NOT rely on \`gbrain search\`/\`code-def\`"
echo "this session; use Grep instead. Diagnose with \`gbrain doctor --fast\`."
fi
else
echo "GBrain configured but this worktree isn't pinned yet. Run \`/sync-gbrain --full\`"
echo "before relying on \`gbrain search\` for code questions in this worktree."
Expand Down
19 changes: 19 additions & 0 deletions canary/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -483,10 +483,29 @@ if [ -f "$_GBRAIN_CONFIG" ] && command -v gbrain >/dev/null 2>&1; then
_GBRAIN_PIN_PATH="$_REPO_TOP/.gbrain-source"
fi
if [ -n "$_GBRAIN_PIN_PATH" ]; then
# Liveness probe. A config file + `--version` + a pin only prove gbrain is
# INSTALLED; none of them prove its engine is reachable. When the engine is
# down (disk full, container stopped, pooler unreachable, autopilot wedged)
# this block would still tell the agent to "prefer gbrain search" — so the
# agent keeps reaching for a tool whose every query fails, instead of
# falling back to Grep. One bounded probe closes that gap; the timeout
# keeps a hung engine from stalling the preamble of every skill.
_GBRAIN_ALIVE=0
if command -v timeout >/dev/null 2>&1; then
timeout 5 gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
else
gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
fi
if [ "$_GBRAIN_ALIVE" -eq 1 ]; then
echo "GBrain configured. Prefer \`gbrain search\`/\`gbrain query\` over Grep for"
echo "semantic questions; use \`gbrain code-def\`/\`code-refs\`/\`code-callers\` for"
echo "symbol-aware code lookup. See \"## GBrain Search Guidance\" in CLAUDE.md."
echo "Run /sync-gbrain to refresh."
else
echo "GBrain DOWN — this worktree is pinned, but a probe query failed, so"
echo "the engine is unreachable. Do NOT rely on \`gbrain search\`/\`code-def\`"
echo "this session; use Grep instead. Diagnose with \`gbrain doctor --fast\`."
fi
else
echo "GBrain configured but this worktree isn't pinned yet. Run \`/sync-gbrain --full\`"
echo "before relying on \`gbrain search\` for code questions in this worktree."
Expand Down
19 changes: 19 additions & 0 deletions codex/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -486,10 +486,29 @@ if [ -f "$_GBRAIN_CONFIG" ] && command -v gbrain >/dev/null 2>&1; then
_GBRAIN_PIN_PATH="$_REPO_TOP/.gbrain-source"
fi
if [ -n "$_GBRAIN_PIN_PATH" ]; then
# Liveness probe. A config file + `--version` + a pin only prove gbrain is
# INSTALLED; none of them prove its engine is reachable. When the engine is
# down (disk full, container stopped, pooler unreachable, autopilot wedged)
# this block would still tell the agent to "prefer gbrain search" — so the
# agent keeps reaching for a tool whose every query fails, instead of
# falling back to Grep. One bounded probe closes that gap; the timeout
# keeps a hung engine from stalling the preamble of every skill.
_GBRAIN_ALIVE=0
if command -v timeout >/dev/null 2>&1; then
timeout 5 gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
else
gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
fi
if [ "$_GBRAIN_ALIVE" -eq 1 ]; then
echo "GBrain configured. Prefer \`gbrain search\`/\`gbrain query\` over Grep for"
echo "semantic questions; use \`gbrain code-def\`/\`code-refs\`/\`code-callers\` for"
echo "symbol-aware code lookup. See \"## GBrain Search Guidance\" in CLAUDE.md."
echo "Run /sync-gbrain to refresh."
else
echo "GBrain DOWN — this worktree is pinned, but a probe query failed, so"
echo "the engine is unreachable. Do NOT rely on \`gbrain search\`/\`code-def\`"
echo "this session; use Grep instead. Diagnose with \`gbrain doctor --fast\`."
fi
else
echo "GBrain configured but this worktree isn't pinned yet. Run \`/sync-gbrain --full\`"
echo "before relying on \`gbrain search\` for code questions in this worktree."
Expand Down
19 changes: 19 additions & 0 deletions context-restore/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -487,10 +487,29 @@ if [ -f "$_GBRAIN_CONFIG" ] && command -v gbrain >/dev/null 2>&1; then
_GBRAIN_PIN_PATH="$_REPO_TOP/.gbrain-source"
fi
if [ -n "$_GBRAIN_PIN_PATH" ]; then
# Liveness probe. A config file + `--version` + a pin only prove gbrain is
# INSTALLED; none of them prove its engine is reachable. When the engine is
# down (disk full, container stopped, pooler unreachable, autopilot wedged)
# this block would still tell the agent to "prefer gbrain search" — so the
# agent keeps reaching for a tool whose every query fails, instead of
# falling back to Grep. One bounded probe closes that gap; the timeout
# keeps a hung engine from stalling the preamble of every skill.
_GBRAIN_ALIVE=0
if command -v timeout >/dev/null 2>&1; then
timeout 5 gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
else
gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
fi
if [ "$_GBRAIN_ALIVE" -eq 1 ]; then
echo "GBrain configured. Prefer \`gbrain search\`/\`gbrain query\` over Grep for"
echo "semantic questions; use \`gbrain code-def\`/\`code-refs\`/\`code-callers\` for"
echo "symbol-aware code lookup. See \"## GBrain Search Guidance\" in CLAUDE.md."
echo "Run /sync-gbrain to refresh."
else
echo "GBrain DOWN — this worktree is pinned, but a probe query failed, so"
echo "the engine is unreachable. Do NOT rely on \`gbrain search\`/\`code-def\`"
echo "this session; use Grep instead. Diagnose with \`gbrain doctor --fast\`."
fi
else
echo "GBrain configured but this worktree isn't pinned yet. Run \`/sync-gbrain --full\`"
echo "before relying on \`gbrain search\` for code questions in this worktree."
Expand Down
19 changes: 19 additions & 0 deletions context-save/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -486,10 +486,29 @@ if [ -f "$_GBRAIN_CONFIG" ] && command -v gbrain >/dev/null 2>&1; then
_GBRAIN_PIN_PATH="$_REPO_TOP/.gbrain-source"
fi
if [ -n "$_GBRAIN_PIN_PATH" ]; then
# Liveness probe. A config file + `--version` + a pin only prove gbrain is
# INSTALLED; none of them prove its engine is reachable. When the engine is
# down (disk full, container stopped, pooler unreachable, autopilot wedged)
# this block would still tell the agent to "prefer gbrain search" — so the
# agent keeps reaching for a tool whose every query fails, instead of
# falling back to Grep. One bounded probe closes that gap; the timeout
# keeps a hung engine from stalling the preamble of every skill.
_GBRAIN_ALIVE=0
if command -v timeout >/dev/null 2>&1; then
timeout 5 gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
else
gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
fi
if [ "$_GBRAIN_ALIVE" -eq 1 ]; then
echo "GBrain configured. Prefer \`gbrain search\`/\`gbrain query\` over Grep for"
echo "semantic questions; use \`gbrain code-def\`/\`code-refs\`/\`code-callers\` for"
echo "symbol-aware code lookup. See \"## GBrain Search Guidance\" in CLAUDE.md."
echo "Run /sync-gbrain to refresh."
else
echo "GBrain DOWN — this worktree is pinned, but a probe query failed, so"
echo "the engine is unreachable. Do NOT rely on \`gbrain search\`/\`code-def\`"
echo "this session; use Grep instead. Diagnose with \`gbrain doctor --fast\`."
fi
else
echo "GBrain configured but this worktree isn't pinned yet. Run \`/sync-gbrain --full\`"
echo "before relying on \`gbrain search\` for code questions in this worktree."
Expand Down
19 changes: 19 additions & 0 deletions cso/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -489,10 +489,29 @@ if [ -f "$_GBRAIN_CONFIG" ] && command -v gbrain >/dev/null 2>&1; then
_GBRAIN_PIN_PATH="$_REPO_TOP/.gbrain-source"
fi
if [ -n "$_GBRAIN_PIN_PATH" ]; then
# Liveness probe. A config file + `--version` + a pin only prove gbrain is
# INSTALLED; none of them prove its engine is reachable. When the engine is
# down (disk full, container stopped, pooler unreachable, autopilot wedged)
# this block would still tell the agent to "prefer gbrain search" — so the
# agent keeps reaching for a tool whose every query fails, instead of
# falling back to Grep. One bounded probe closes that gap; the timeout
# keeps a hung engine from stalling the preamble of every skill.
_GBRAIN_ALIVE=0
if command -v timeout >/dev/null 2>&1; then
timeout 5 gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
else
gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
fi
if [ "$_GBRAIN_ALIVE" -eq 1 ]; then
echo "GBrain configured. Prefer \`gbrain search\`/\`gbrain query\` over Grep for"
echo "semantic questions; use \`gbrain code-def\`/\`code-refs\`/\`code-callers\` for"
echo "symbol-aware code lookup. See \"## GBrain Search Guidance\" in CLAUDE.md."
echo "Run /sync-gbrain to refresh."
else
echo "GBrain DOWN — this worktree is pinned, but a probe query failed, so"
echo "the engine is unreachable. Do NOT rely on \`gbrain search\`/\`code-def\`"
echo "this session; use Grep instead. Diagnose with \`gbrain doctor --fast\`."
fi
else
echo "GBrain configured but this worktree isn't pinned yet. Run \`/sync-gbrain --full\`"
echo "before relying on \`gbrain search\` for code questions in this worktree."
Expand Down
19 changes: 19 additions & 0 deletions design-consultation/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -509,10 +509,29 @@ if [ -f "$_GBRAIN_CONFIG" ] && command -v gbrain >/dev/null 2>&1; then
_GBRAIN_PIN_PATH="$_REPO_TOP/.gbrain-source"
fi
if [ -n "$_GBRAIN_PIN_PATH" ]; then
# Liveness probe. A config file + `--version` + a pin only prove gbrain is
# INSTALLED; none of them prove its engine is reachable. When the engine is
# down (disk full, container stopped, pooler unreachable, autopilot wedged)
# this block would still tell the agent to "prefer gbrain search" — so the
# agent keeps reaching for a tool whose every query fails, instead of
# falling back to Grep. One bounded probe closes that gap; the timeout
# keeps a hung engine from stalling the preamble of every skill.
_GBRAIN_ALIVE=0
if command -v timeout >/dev/null 2>&1; then
timeout 5 gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
else
gbrain sources list >/dev/null 2>&1 && _GBRAIN_ALIVE=1
fi
if [ "$_GBRAIN_ALIVE" -eq 1 ]; then
echo "GBrain configured. Prefer \`gbrain search\`/\`gbrain query\` over Grep for"
echo "semantic questions; use \`gbrain code-def\`/\`code-refs\`/\`code-callers\` for"
echo "symbol-aware code lookup. See \"## GBrain Search Guidance\" in CLAUDE.md."
echo "Run /sync-gbrain to refresh."
else
echo "GBrain DOWN — this worktree is pinned, but a probe query failed, so"
echo "the engine is unreachable. Do NOT rely on \`gbrain search\`/\`code-def\`"
echo "this session; use Grep instead. Diagnose with \`gbrain doctor --fast\`."
fi
else
echo "GBrain configured but this worktree isn't pinned yet. Run \`/sync-gbrain --full\`"
echo "before relying on \`gbrain search\` for code questions in this worktree."
Expand Down
Loading