feat(perf): benchmarks + expand cartographer FindFiles/SearchContent API

- Add perf_bench_test.go: 22 benchmarks covering recordCommit O(n²),
  co-change pipeline simulation, importCouldReferTo, shouldIgnore
- Add structural_bench_test.go (CGO): 11 benchmarks for call-site
  annotation pipeline with documented baselines
- Expand FindFiles to accept FindOptions (filter by mtime, size, depth)
- Expand SearchContentOptions with full ripgrep-parity fields
- Add FileCount, FilesWithMatches/WithoutMatch fields to SearchResult

Author: SimplyLiz

internal/cartographer/bridge.go

@@ -355,16 +355,26 @@ func SearchContent(path, pattern string, opts *SearchContentOptions) (*SearchRes
 }
 
 // FindFiles finds files whose repo-relative path matches a glob pattern.
-// limit=0 means unlimited.
-func FindFiles(path, pattern string, limit uint32) (*FindResult, error) {
+// limit=0 means unlimited. opts may be nil to use defaults.
+func FindFiles(path, pattern string, limit uint32, opts *FindOptions) (*FindResult, error) {
 	cPath := C.CString(path)
 	defer C.free(unsafe.Pointer(cPath))
 
 	cPattern := C.CString(pattern)
 	defer C.free(unsafe.Pointer(cPattern))
 
+	var cOpts *C.char
+	if opts != nil {
+		b, err := json.Marshal(opts)
+		if err != nil {
+			return nil, &CartographerError{err.Error()}
+		}
+		cOpts = C.CString(string(b))
+		defer C.free(unsafe.Pointer(cOpts))
+	}
+
 	resp, err := callFFI(func() *C.char {
-		return C.cartographer_find_files(cPath, cPattern, C.uint(limit))
+		return C.cartographer_find_files(cPath, cPattern, C.uint(limit), cOpts)
 	})
 	if err != nil {
 		return nil, err

internal/cartographer/bridge_stub.go

@@ -27,4 +27,4 @@ func Semidiff(_, _, _ string) ([]SemidiffFile, error)
 func RankedSkeleton(_ string, _ []string, _ uint32) (*RankedSkeletonResult, error)            { return nil, ErrUnavailable }
 func UnreferencedSymbols(_ string) (*UnreferencedSymbolsResult, error)                        { return nil, ErrUnavailable }
 func SearchContent(_, _ string, _ *SearchContentOptions) (*SearchResult, error)               { return nil, ErrUnavailable }
-func FindFiles(_, _ string, _ uint32) (*FindResult, error)                                    { return nil, ErrUnavailable }
+func FindFiles(_, _ string, _ uint32, _ *FindOptions) (*FindResult, error) { return nil, ErrUnavailable }

internal/cartographer/types.go

@@ -178,13 +178,35 @@ type SemidiffFile struct {
 	Removed []string `json:"removed"`
 }
 
-// SearchContentOptions configures a content search request.
+// SearchContentOptions configures a content search request (mirrors Rust SearchOptions).
 type SearchContentOptions struct {
-	Literal       bool   `json:"literal,omitempty"`
-	CaseSensitive *bool  `json:"caseSensitive,omitempty"` // default true
-	ContextLines  int    `json:"contextLines,omitempty"`
-	MaxResults    int    `json:"maxResults,omitempty"`
-	FileGlob      string `json:"fileGlob,omitempty"`
+	Literal            bool     `json:"literal,omitempty"`
+	CaseSensitive      *bool    `json:"caseSensitive,omitempty"` // default true
+	ContextLines       int      `json:"contextLines,omitempty"`
+	BeforeContext      int      `json:"beforeContext,omitempty"`
+	AfterContext       int      `json:"afterContext,omitempty"`
+	MaxResults         int      `json:"maxResults,omitempty"`
+	FileGlob           string   `json:"fileGlob,omitempty"`
+	ExcludeGlob        string   `json:"excludeGlob,omitempty"`
+	ExtraPatterns      []string `json:"extraPatterns,omitempty"`
+	InvertMatch        bool     `json:"invertMatch,omitempty"`
+	WordRegexp         bool     `json:"wordRegexp,omitempty"`
+	OnlyMatching       bool     `json:"onlyMatching,omitempty"`
+	FilesWithMatches   bool     `json:"filesWithMatches,omitempty"`
+	FilesWithoutMatch  bool     `json:"filesWithoutMatch,omitempty"`
+	CountOnly          bool     `json:"countOnly,omitempty"`
+	NoIgnore           bool     `json:"noIgnore,omitempty"`
+	SearchPath         string   `json:"searchPath,omitempty"`
+}
+
+// FindOptions configures a file-find request (mirrors Rust FindOptions).
+type FindOptions struct {
+	ModifiedSinceSecs *uint64 `json:"modifiedSinceSecs,omitempty"`
+	NewerThan         string  `json:"newerThan,omitempty"`
+	MinSizeBytes      *uint64 `json:"minSizeBytes,omitempty"`
+	MaxSizeBytes      *uint64 `json:"maxSizeBytes,omitempty"`
+	MaxDepth          *int    `json:"maxDepth,omitempty"`
+	NoIgnore          bool    `json:"noIgnore,omitempty"`
 }
 
 // ContextLine is one line of before/after context around a search match.
@@ -198,23 +220,34 @@ type ContentMatch struct {
 	Path          string        `json:"path"`
 	LineNumber    int           `json:"lineNumber"`
 	Line          string        `json:"line"`
+	MatchedTexts  []string      `json:"matchedTexts,omitempty"`
 	BeforeContext []ContextLine `json:"beforeContext,omitempty"`
 	AfterContext  []ContextLine `json:"afterContext,omitempty"`
 }
 
+// FileCount holds the match count for one file (count_only mode).
+type FileCount struct {
+	Path  string `json:"path"`
+	Count int    `json:"count"`
+}
+
 // SearchResult is returned by SearchContent.
 type SearchResult struct {
-	Matches      []ContentMatch `json:"matches"`
-	TotalMatches int            `json:"totalMatches"`
-	FilesSearched int           `json:"filesSearched"`
-	Truncated    bool           `json:"truncated"`
+	Matches            []ContentMatch `json:"matches"`
+	TotalMatches       int            `json:"totalMatches"`
+	FilesSearched      int            `json:"filesSearched"`
+	Truncated          bool           `json:"truncated"`
+	FilesWithMatches   []string       `json:"filesWithMatches,omitempty"`
+	FilesWithoutMatch  []string       `json:"filesWithoutMatch,omitempty"`
+	FileCounts         []FileCount    `json:"fileCounts,omitempty"`
 }
 
 // FindFile is one file returned by FindFiles.
 type FindFile struct {
 	Path      string  `json:"path"`
 	Language  *string `json:"language,omitempty"`
 	SizeBytes uint64  `json:"sizeBytes"`
+	Modified  *string `json:"modified,omitempty"`
 }
 
 // FindResult is returned by FindFiles.