guild-wiki-query

guild:wiki-query

Implements the knowledge layer query contract: wiki structure + filterable frontmatter, load-by-role categorization, scale-transition (rg/filesystem under ~200 pages, guild-memory MCP above), and the read side of the memory write path that all specialists depend on.

Read-only counterpart to guild:wiki-ingest. Every page that skill writes carries a source_refs: [<slug>] back-citation into .guild/raw/sources/<slug>/; this skill honors it so "where does this come from" always returns the original URL or file path, not just the LLM summary.

Input

• query (required) — free-text, matched against page body and frontmatter. An empty query is allowed only when at least one filter is set.
• filters (optional, combinable):
  • category — context | standard | product | entity | concept | decision | source (the type: enum). Mapped internally to the plural directory (standard → standards/). Reject plural forms with an error pointing at the singular enum.
  • owner — specialist slug; matches owner:.
  • confidence — low | medium | high; matches exactly.
  • updated_since — ISO-8601 date; returns pages with updated_at: on or after it.
  • tag — matched against a tags: array if present, else against body headings.
• source_resolve (optional, default true) — dereference each result's source_refs: to .guild/raw/sources/<slug>/metadata.json and include the original URL/path.

If the caller passes an unknown category, reject the query with the list of valid categories — never silently fall back to a full-wiki walk.

Search strategy

Two paths, chosen by scale; pick one per invocation (no mid-query switching):

• Under ~200 pages — ripgrep + filesystem (default). Search root = .guild/wiki/<category>/ if category set, else .guild/wiki/ (excluding index.md, log.md, lint-*.md). Full-text match via Grep (case-insensitive by default), Glob to enumerate when only filters are set. Extract the frontmatter block and filter on owner/confidence/updated_since/tag — never regex-parse YAML. Rank exact-phrase > bag-of-words > frontmatter-only, tie-break updated_at desc then confidence high→low. Cap 20 (raise via limit).
• Above ~200 pages — guild-memory MCP (optional, P6). First check mcp.stdio_available (resolved config) — see ## MCP-availability gate: when false, the MCP stdio transport is declared unavailable, so do not attempt the MCP call; route to fsScan instead. When true, delegate to its BM25 search; post-filter confidence/updated_since if unsupported; on an unreachable MCP despite stdio_available: true, fall back to fsScan (or ripgrep) and note the degradation.