Skip to content

docs(serena): make code-search routing language-agnostic#533

Merged
stevensacks merged 1 commit into
mainfrom
serena-language-agnostic-routing
Jul 3, 2026
Merged

docs(serena): make code-search routing language-agnostic#533
stevensacks merged 1 commit into
mainfrom
serena-language-agnostic-routing

Conversation

@stevensacks

Copy link
Copy Markdown
Contributor

What

Makes GAIA's Serena code-search routing language-agnostic instead of hardcoded to TypeScript. An adopter who configures another language server (Python, Go, Rust, ...) now gets the same Serena routing nudge, where before a GAIA-owned advisory surface pinned routing to TS + app//test/.

Changes

  • .claude/rules/code-search.md generalized:
    • Frontmatter paths: swapped from the TS-only app/**/test/** pins to a broad multi-language source glob (ts,tsx,js,jsx,mjs,cjs,py,go,rs,java,rb,php,cs,cpp,cc,c,h,hpp,kt,swift,scala), so the rule activates for any language Serena might index, repo-wide.
    • Prose no longer says "TS/TSX files" or "files outside app/** and test/**"; it prefers Serena's symbol tools for any language Serena indexes for the project. The note that grep is still right for prose / comments / non-code files is preserved.
    • The ## Enforcement section now states the split explicitly.
  • Guard intentionally left untouched. .claude/hooks/serena-code-search-guard.sh stays TypeScript-conservative and tsconfig-gated. The guard is a hard BLOCK; a wrong block on a non-TS grep is worse than a miss, whereas the rule only nudges (zero false-block risk). Rule generalizes; guard stays conservative.
  • Wiki (wiki/concepts/Serena Integration.md, wiki/dependencies/Serena.md) updated in present tense to state the split: the advisory routing rule is language-agnostic (multi-language trigger, not TS/app/test-only) while the enforcement guard remains TS-conservative, so code and docs agree.
  • CHANGELOG ## [Unreleased] → Changed entry recording the routing generalization and the deliberately conservative guard.

Markdown-only change (rule + wiki + CHANGELOG); no source touched. Wiki-style audit greps on the two touched pages returned clean.

🤖 Generated with Claude Code

@github-actions

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

code-review-audit skipped: no audit-relevant files changed in the un-audited delta (since the last clean audit); GAIA-Audit commit status stamped on HEAD so the merge gate is satisfied with no local audit run

The advisory code-search rule now nudges toward Serena's symbol tools
for any language Serena indexes for the project, not only TS/TSX and no
longer scoped to app/ or test/. The rule frontmatter triggers on a broad
multi-language source glob. The enforcement guard is left untouched and
stays TypeScript-conservative and tsconfig-gated, since a wrong hard-block
on a non-TS search is worse than a miss while the rule only nudges. The
two Serena wiki pages document the split and a CHANGELOG entry records it.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@stevensacks stevensacks force-pushed the serena-language-agnostic-routing branch from c597746 to bdb69f9 Compare July 3, 2026 06:47
@github-actions

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

code-review-audit skipped: no audit-relevant files changed in the un-audited delta (since the last clean audit); GAIA-Audit commit status stamped on HEAD so the merge gate is satisfied with no local audit run

@stevensacks stevensacks enabled auto-merge (squash) July 3, 2026 06:47
@stevensacks stevensacks merged commit 95fb9b5 into main Jul 3, 2026
7 checks passed
@stevensacks stevensacks deleted the serena-language-agnostic-routing branch July 3, 2026 06:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant