diff --git a/plugin/skills/smart-explore/SKILL.md b/plugin/skills/smart-explore/SKILL.md index 0f3777e6..19799d86 100644 --- a/plugin/skills/smart-explore/SKILL.md +++ b/plugin/skills/smart-explore/SKILL.md @@ -143,3 +143,24 @@ Use smart_* tools for code exploration, Read for non-code files. Mix freely. | Explore agent | ~39,000-59,000 | Cross-file synthesis with narrative | **4-8x savings** on file understanding (outline + unfold vs Read). **11-18x savings** on codebase exploration vs Explore agent. The narrower the query, the wider the gap — a 27-line function costs 55x less to read via unfold than via an Explore agent, because the agent still reads the entire file. + +## Language Support + +Smart-explore uses **tree-sitter AST parsing** for structural analysis. Unsupported file types fall back to text-based search. + +### Bundled Languages + +| Language | Extensions | +|----------|-----------| +| JavaScript | `.js`, `.mjs`, `.cjs` | +| TypeScript | `.ts` | +| TSX / JSX | `.tsx`, `.jsx` | +| Python | `.py`, `.pyw` | +| Go | `.go` | +| Rust | `.rs` | +| Ruby | `.rb` | +| Java | `.java` | +| C | `.c`, `.h` | +| C++ | `.cpp`, `.cc`, `.cxx`, `.hpp`, `.hh` | + +Files with unrecognized extensions are parsed as plain text — `smart_search` still works (grep-style), but `smart_outline` and `smart_unfold` will not extract structured symbols. diff --git a/tests/utils/skill-docs-placement.test.ts b/tests/utils/skill-docs-placement.test.ts new file mode 100644 index 00000000..f3b46d6c --- /dev/null +++ b/tests/utils/skill-docs-placement.test.ts @@ -0,0 +1,43 @@ +/** + * Regression test for misplaced smart-explore language docs (#1651) + * + * The smart-explore language support section was missing from smart-explore/SKILL.md + * and had previously been in mem-search/SKILL.md (where it doesn't belong). + */ +import { describe, it, expect } from 'bun:test'; +import { existsSync, readFileSync } from 'fs'; +import { join } from 'path'; + +const SKILLS_DIR = join(import.meta.dir, '../../plugin/skills'); + +describe('skill docs placement (#1651)', () => { + it('smart-explore/SKILL.md contains Language Support section', () => { + const path = join(SKILLS_DIR, 'smart-explore/SKILL.md'); + expect(existsSync(path)).toBe(true); + const content = readFileSync(path, 'utf-8'); + + expect(content).toContain('Language Support'); + expect(content).toContain('tree-sitter'); + }); + + it('smart-explore/SKILL.md lists bundled languages', () => { + const content = readFileSync(join(SKILLS_DIR, 'smart-explore/SKILL.md'), 'utf-8'); + + // Core languages must be documented + expect(content).toContain('JavaScript'); + expect(content).toContain('TypeScript'); + expect(content).toContain('Python'); + expect(content).toContain('Go'); + expect(content).toContain('Rust'); + }); + + it('mem-search/SKILL.md does NOT contain tree-sitter or language grammar docs', () => { + const path = join(SKILLS_DIR, 'mem-search/SKILL.md'); + expect(existsSync(path)).toBe(true); + const content = readFileSync(path, 'utf-8'); + + // Language support docs belong in smart-explore, not mem-search + expect(content).not.toContain('tree-sitter'); + expect(content).not.toContain('Bundled Languages'); + }); +});