Function _resolve_doc_identifier

openkb/cli.py:1190–1217

Find registry entries matching ``identifier``. Match precedence (returns immediately on the first non-empty bucket): 1. Exact match on ``metadata['name']`` (the original filename). 2. Exact match on ``metadata['doc_name']`` (the slug). 3. Case-insensitive substring match on ei

(registry, identifier: str)

def _resolve_doc_identifier(registry, identifier: str) -> list[tuple[str, dict]]:
    """Find registry entries matching ``identifier``.

    Match precedence (returns immediately on the first non-empty bucket):
      1. Exact match on ``metadata['name']`` (the original filename).
      2. Exact match on ``metadata['doc_name']`` (the slug).
      3. Case-insensitive substring match on either field.

    Returns ``[(file_hash, metadata), ...]``. Callers handle the empty,
    single, and multi-match cases.
    """
    entries = registry.all_entries()

    exact_name = [(h, m) for h, m in entries.items() if m.get("name") == identifier]
    if exact_name:
        return exact_name

    exact_slug = [(h, m) for h, m in entries.items() if m.get("doc_name") == identifier]
    if exact_slug:
        return exact_slug

    needle = identifier.lower()
    fuzzy = [
        (h, m)
        for h, m in entries.items()
        if needle in (m.get("name") or "").lower() or needle in (m.get("doc_name") or "").lower()
    ]
    return fuzzy


@cli.command()