feat(cartographer): add SearchContent/FindFiles FFI + structural perf tests

- Add SearchContent and FindFiles FFI calls with stub implementations
- Add structural perf tests split across CGO and non-CGO build tags

Author: SimplyLiz

internal/cartographer/bridge.go

@@ -321,6 +321,62 @@ func UnreferencedSymbols(path string) (*UnreferencedSymbolsResult, error) {
 	return &result, nil
 }
 
+// SearchContent searches for a regex or literal pattern across all non-noise project files.
+// opts may be nil to use defaults (case-sensitive, unlimited results, no glob filter).
+func SearchContent(path, pattern string, opts *SearchContentOptions) (*SearchResult, 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_search_content(cPath, cPattern, cOpts)
+	})
+	if err != nil {
+		return nil, err
+	}
+
+	var result SearchResult
+	if err := json.Unmarshal(resp.Data, &result); err != nil {
+		return nil, &CartographerError{err.Error()}
+	}
+	return &result, nil
+}
+
+// FindFiles finds files whose repo-relative path matches a glob pattern.
+// limit=0 means unlimited.
+func FindFiles(path, pattern string, limit uint32) (*FindResult, error) {
+	cPath := C.CString(path)
+	defer C.free(unsafe.Pointer(cPath))
+
+	cPattern := C.CString(pattern)
+	defer C.free(unsafe.Pointer(cPattern))
+
+	resp, err := callFFI(func() *C.char {
+		return C.cartographer_find_files(cPath, cPattern, C.uint(limit))
+	})
+	if err != nil {
+		return nil, err
+	}
+
+	var result FindResult
+	if err := json.Unmarshal(resp.Data, &result); err != nil {
+		return nil, &CartographerError{err.Error()}
+	}
+	return &result, nil
+}
+
 // GetModuleContext returns a single module's skeleton with dependency info.
 func GetModuleContext(path, moduleID string, depth uint32) (*ModuleContext, error) {
 	cPath := C.CString(path)

internal/cartographer/bridge_stub.go

@@ -26,3 +26,5 @@ func HiddenCoupling(_ string, _ uint32, _ uint32) ([]CoChangePair, error)  { ret
 func Semidiff(_, _, _ string) ([]SemidiffFile, error)                                         { return nil, ErrUnavailable }
 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 }

internal/cartographer/types.go

@@ -178,6 +178,52 @@ type SemidiffFile struct {
 	Removed []string `json:"removed"`
 }
 
+// SearchContentOptions configures a content search request.
+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"`
+}
+
+// ContextLine is one line of before/after context around a search match.
+type ContextLine struct {
+	LineNumber int    `json:"lineNumber"`
+	Line       string `json:"line"`
+}
+
+// ContentMatch is one matching line with optional surrounding context.
+type ContentMatch struct {
+	Path          string        `json:"path"`
+	LineNumber    int           `json:"lineNumber"`
+	Line          string        `json:"line"`
+	BeforeContext []ContextLine `json:"beforeContext,omitempty"`
+	AfterContext  []ContextLine `json:"afterContext,omitempty"`
+}
+
+// SearchResult is returned by SearchContent.
+type SearchResult struct {
+	Matches      []ContentMatch `json:"matches"`
+	TotalMatches int            `json:"totalMatches"`
+	FilesSearched int           `json:"filesSearched"`
+	Truncated    bool           `json:"truncated"`
+}
+
+// FindFile is one file returned by FindFiles.
+type FindFile struct {
+	Path      string  `json:"path"`
+	Language  *string `json:"language,omitempty"`
+	SizeBytes uint64  `json:"sizeBytes"`
+}
+
+// FindResult is returned by FindFiles.
+type FindResult struct {
+	Files        []FindFile `json:"files"`
+	TotalMatches int        `json:"totalMatches"`
+	Truncated    bool       `json:"truncated"`
+}
+
 // CartographerError is returned when a Cartographer FFI call fails.
 type CartographerError struct {
 	Message string