jonnaWikiSearch

Example Query

query ExampleQuery($query: String!, $scope: WikiScopeInputGql, $locationId: String, $groupIds: [String!], $includeAll: Boolean!, $limit: Int!, $offset: Int!, $minSimilarity: Float!, $frontmatter: JSON, $sectionChars: Int!) {
  jonnaWikiSearch(query: $query, scope: $scope, locationId: $locationId, groupIds: $groupIds, includeAll: $includeAll, limit: $limit, offset: $offset, minSimilarity: $minSimilarity, frontmatter: $frontmatter, sectionChars: $sectionChars) {
    count
    hits {
      page
      score
      matchKind
      ftsScore
      semanticScore
      sectionHeading
      sectionBody
    }
  }
}

Variables

{
  "query": "example",
  "scope": null,
  "locationId": null,
  "groupIds": null,
  "includeAll": false,
  "limit": 10,
  "offset": 0,
  "minSimilarity": 0,
  "frontmatter": null,
  "sectionChars": 1200
}

Example response

{
  "data": {
    "jonnaWikiSearch": {
      "count": 0,
      "hits": [
        {
          "page": {
            "id": null,
            "scopeType": null,
            "scopeId": null,
            "namespace": null,
            "path": null,
            "title": null,
            "summary": null,
            "frontmatter": null,
            "version": null,
            "updatedAt": null
          },
          "score": 0,
          "matchKind": "HYBRID",
          "ftsScore": 0,
          "semanticScore": 0,
          "sectionHeading": "example",
          "sectionBody": "example"
        }
      ]
    }
  }
}

Hybrid semantic search (FTS + vector + trigram) over title, summary, and body. Use this for natural-language lookups; use jonnaWikiGrep for literal/regex matching.

Arguments

queryStringRequired

Free-text query. Matched against title, summary, and body via FTS, vector, and trigram retrieval.

scopeWikiScopeInputGqlOptional

Scope to one bucket. Mutually exclusive with locationId/groupIds.

locationIdStringOptional

Location UUID. Combined with groupIds produces the union (location → groups).

groupIdslist of StringsOptional

Wiki group UUIDs to include in the union.

includeAllBooleanRequired

Bypass scoping and search across all tenant data. Use sparingly.

limitIntegerRequired

Max hits to return. Default 10.

offsetIntegerRequired

Pagination offset. Default 0.

minSimilarityDoubleRequired

Cosine cutoff (0.0-1.0) applied to SEMANTIC-only hits, to drop the long tail of weak matches. Default 0.0 (keep everything).

frontmatteranyOptional

JSONB filter on typed page metadata, e.g. {"type": "policy"}. Narrows results to pages whose frontmatter matches every key given.

sectionCharsIntegerRequired

Max characters of the matched markdown section per hit. Default 1200.

Returns

a WikiSearchResults

countInteger

Number of hits returned.

hitslist of WikiSearchHits

Hits, ordered by score descending.