YeonGyu-Kim
499aff011a
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
36 lines
2.1 KiB
TypeScript
36 lines
2.1 KiB
TypeScript
export const AST_GREP_SEARCH_DESCRIPTION = [
|
|
"Search code by AST structure (25 languages). This is NOT regex.",
|
|
"",
|
|
"Meta-variables (the only wildcards ast-grep understands):",
|
|
" $VAR - one AST node (an identifier, expression, statement, ...)",
|
|
" $$$ - zero or more nodes (argument lists, function bodies, ...)",
|
|
" $$$VAR - same, captured by name",
|
|
"Patterns must be complete, parseable source code. Each meta-variable replaces a whole node, not a substring.",
|
|
"",
|
|
"Regex syntax does NOT work - never pass these to pattern:",
|
|
' "foo|bar" alternation → run separate calls, or switch to grep',
|
|
' ".*", ".+" wildcards → use $$$ between AST fragments',
|
|
' "\\w", "\\d" escapes → use $VAR to capture any identifier',
|
|
' "[a-z]" class ranges → no AST equivalent',
|
|
"For text search, cross-language search, or regex features, use the grep tool instead.",
|
|
"",
|
|
"Examples by language:",
|
|
' typescript/tsx "function $NAME($$$) { $$$ }", "console.log($$$)", "import { $$$ } from \'$MOD\'"',
|
|
' python "def $FUNC($$$)", "class $C($$$)" - no trailing colon',
|
|
' go "func $NAME($$$) { $$$ }", "if err != nil { $$$ }"',
|
|
' rust "fn $NAME($$$) -> $RET { $$$ }", "impl $TRAIT for $T { $$$ }"',
|
|
"",
|
|
"On empty results the tool returns a hint naming the exact mistake. If the pattern is fundamentally text-shaped, stop retrying and switch to grep.",
|
|
].join("\n")
|
|
|
|
export const AST_GREP_SEARCH_PATTERN_PARAM =
|
|
"AST pattern - valid, parseable code using $VAR (one node) and $$$ (many nodes). NOT regex: no `|`, no `.*`, no `\\w`, no `[a-z]`. For text or alternation, use grep instead."
|
|
|
|
export const AST_GREP_REPLACE_DESCRIPTION = [
|
|
"Rewrite code by AST pattern (25 languages). Dry-run by default.",
|
|
"Both pattern and rewrite use AST syntax ($VAR for one node, $$$ for many) - regex does NOT work.",
|
|
"Meta-variables captured in pattern can be reused in rewrite to preserve matched content.",
|
|
'Example: pattern="console.log($MSG)" rewrite="logger.info($MSG)"',
|
|
"For text-only replacement or regex features, use a text editor instead.",
|
|
].join("\n")
|