ghostcrab-evidence-discovery

name	ghostcrab-evidence-discovery
description	Discover which GhostCrab dimensions, facets, graph edges, projections, and evidence paths can support a natural-language answer via MCP. Use when a projection contract is not enough, when the user asks what data exists, or how to move from a business question to evidence-backed JSON.

GhostCrab Evidence Discovery (Personal)

Map a business question to MCP surfaces that can answer it on SQLite Personal.

References: RUNTIME_QUERY_PIPELINE.md, ARTIFACT_KINDS.md, PROJECTIONS_DISCOVERY.md, ENUM_BUSINESS_FACETS.md.

Delivery context (optional)

Resolve {starterkit} via STARTERKIT_PATHS.md — Phase B runtime section in {starterkit}/personal-mcp/SOP_SEQUENCE.md.

Workflow

1. ghostcrab_status + active workspace.
2. ghostcrab_projections_list when projection ids or scopes are unknown.
3. When the question filters on a domain enum (status, type, tier): ghostcrab_facet_catalog / ghostcrab_facet_inspect with <module>.<slot_snake_case> keys — see ENUM_BUSINESS_FACETS.md.
4. ghostcrab_search / ghostcrab_count on agent_facts.
5. ghostcrab_combined_search when graph-linked facts may matter.
6. ghostcrab_schema_list / ghostcrab_schema_inspect for registered ghostcrab:* shapes and target=facets module schemas.
7. ghostcrab_pack for active analysis_plan projections.
8. ghostcrab_graph_search / ghostcrab_traverse for graph paths.
9. ghostcrab_coverage for schema population overview.

Formal ontology dimensions (LinkML) live in ontology_* — discover via ghostcrab_ontology_list after ghostcrab_ontology_import or CLI compile, not via bare schema_register for LinkML source.

Output shape

{
  "question": "",
  "workspace_id": "",
  "evidence_paths": [],
  "pack_context": null,
  "graph_context": null,
  "projection_scopes": [],
  "gaps": [],
  "mcp_tools_used": []
}

Gap labels: no_facts, no_graph_path, projection_only, ontology_vocab_missing, tool_gap.

Guardrails

• Do not claim traversal without ghostcrab_traverse or ghostcrab_graph_search results.
• Route persistent tool failures to ghostcrab-gap-auditor.
• Personal SQLite only — no Pro PostgreSQL stack.