Search - HexxlaDB

SearchCells

Convenience wrapper over QueryCells for backward compatibility. Returns []CellSearchResult sorted by score; each result includes a Coord for use as a context-pack seed.

results, err := tx.SearchCells(ctx, hexxladb.CellSearchConfig{
    Query:         "integration test",
    RequireTags:   []string{"fact"},
    MinConfidence: 0.5,
    SourceID:      "session-2",
    Center:        &centerCoord,
    MaxScanRadius: 5,
    Embedding:     queryVector,
    MaxResults:    10,
})

For ExcludeTags, SortBy, Explain, or temporal filters, use QueryCells directly.

CellSearchConfig fields

Field	Description
`Query`	Full-text search query
`RequireTags`	Tags that must all be present (AND)
`AnyTags`	Tags where at least one must be present (OR)
`MinConfidence`	Minimum confidence threshold
`MaxConfidence`	Maximum confidence threshold
`SourceID`	Filter by source ID
`Center`	Spatial query center coordinate
`MaxScanRadius`	Maximum ring radius to scan
`Embedding`	Vector for ANN-accelerated seed selection
`MaxResults`	Maximum results to return

Content search scoring

Condition	Score contribution
Query matches a tag exactly (case-insensitive)	+1.0
Query is a prefix of a tag	+0.8
Query found verbatim in `RawContent`	+0.6
Query found case-insensitively in `RawContent`	+0.5
Query matches `SourceID` exactly	+0.3
Confidence bonus	+0.1 × Confidence

CellSearchResult

type CellSearchResult struct {
    Cell  CellView
    Score float64
}

Each result’s Cell.Coord can be used as a seed for context assembly.

Multi-seed context assembly

A seed is a Coord — the centre point of a ring-walk expansion. SearchCells returns CellSearchResult values each carrying a Coord; those coords are the seeds passed to the assembly APIs, which expand each matched location’s neighbourhood into context. One query → N matched coords → N seeds → one merged ContextPack.

// Search for relevant cells
results, err := tx.SearchCells(ctx, config)

// Extract seeds
seeds := make([]hexxladb.Coord, len(results))
for i, result := range results {
    seeds[i] = result.Cell.Coord
}

// Assemble context from multiple seeds
pack, err := tx.LoadContextPackFrom(ctx, 2, 4096, hexxladb.ByteLenBudgeter{}, hexxladb.LoadContextBudgetConfig{}, seeds...)

See also

Query — Full query engine with more options
Context — Context assembly from seeds