# GhostCrab operator catalog (Personal)

> Generated by `node scripts/export-operator-catalog.mjs` — do not hand-edit the MCP tools table; re-run the script after tool changes.

Glossary: [explanation/glossary.md](../explanation/glossary.md). JTBD overview: [gcp-commands.md](gcp-commands.md).

**Rule:** `remember`, `upsert`, `learn`, `project`, `pack`, `search`, etc. are **MCP-only** (no `gcp` subcommands). Use `gcp brain up` then MCP tools for product operations.

---

## Impact matrix columns

| Column | Meaning |
|--------|---------|
| **Layer** | session, facets, graph, ontology (LinkML/OWL2), pragma, workspace, loadout, control-plane |
| **Access** | read, write, model, guide, session |
| **Impact** | SQLite tables or artefacts touched |

---

## A — `gcp` commands

### Start / diagnostics

| Surface | Command | Layer | Impact | Access | Prerequisites | Runbook |
|---------|---------|-------|--------|--------|---------------|-----------|
| gcp | brain up \| up \| start | control-plane | MCP stdio + backend | write | — | gcp-commands.md |
| gcp | smoke \| status \| tools list \| tools verify | control-plane | package/runtime/tool catalog | read | — | gcp-commands.md |
| gcp | brain db-who | control-plane | SQLite file holders via lsof | read | lsof on host | gcp-commands.md |
| gcp | maintenance ddl-approve \| ddl-execute | workspace | pending DDL | write | human approval | gcp-commands.md |

### Workspace

| Surface | Command | Layer | Impact | Access | Prerequisites | Runbook |
|---------|---------|-------|--------|--------|---------------|-----------|
| gcp | brain workspace create \| list | workspace | workspace registry | write/read | — | gcp-commands.md |
| ghostcrab | workspace reset \| delete | workspace | workspace-scoped data | write | explicit workspace id | gcp-commands.md |
| gcp | init (legacy) | workspace | workspace registry | write | — | gcp-commands.md |

### Schema registry (not LinkML OWL)

| Surface | Command | Layer | Impact | Access | Prerequisites | Runbook |
|---------|---------|-------|--------|--------|---------------|-----------|
| gcp | brain schema list \| pull \| show \| remove | facets | local schema packs | read/write | — | skillset-demo-import.md |
| gcp | ontologies … (legacy) | facets | local schema packs | read/write | — | gcp-commands.md |

### Ontology LinkML / OWL2

| Surface | Command | Layer | Impact | Access | Prerequisites | Runbook |
|---------|---------|-------|--------|--------|---------------|-----------|
| gcp | brain ontology compile | ontology | ontology_* (after --import-db) | write | stop MCP | 06-voies-import, ontology/README |
| gcp | brain ontology import \| export | ontology | ontology_* / N-Triples | write | stop MCP | ontology/linkml-owl2-pipeline.md |
| gcp | brain ontology export-linkml | ontology | YAML slice export | read | — | ontology/linkml-owl2-pipeline.md |

### Structured import

| Surface | Command | Layer | Impact | Access | Prerequisites | Runbook |
|---------|---------|-------|--------|--------|---------------|-----------|
| gcp | brain structured-import validate \| infer \| dry-run \| profile | control-plane | — | read | — | structured-import.md |
| gcp | brain structured-import register-semantics | ontology | table_semantics, source_mappings | write | stop MCP | structured-import.md |
| gcp | brain structured-import apply \| project | facets+graph | agent_facts, entities_raw, relations_raw | write | stop MCP | structured-import.md |
| gcp | brain structured-import reindex | graph+facets | graph_entity, facet_postings, FTS | write | stop MCP | structured-import.md |
| gcp | brain structured-import ddl-propose \| ddl-execute \| load-ws | workspace | ws_* staging | write | stop MCP | structured-import.md |

### Document import

| Surface | Command | Layer | Impact | Access | Prerequisites | Runbook |
|---------|---------|-------|--------|--------|---------------|-----------|
| gcp | brain document document-normalize \| document-profile | control-plane | files on disk | write | optional no DB | document-import.md |
| gcp | brain document document-ingest \| document-qualify | ontology+graph | documents_raw, facet_assignments_raw | write | stop MCP | document-import.md |
| gcp | brain document qualification-vocab-list | ontology | ontology_* taxonomies | read | — | document-import.md |

### Answer artifacts

| Surface | Command | Layer | Impact | Access | Prerequisites | Runbook |
|---------|---------|-------|--------|--------|---------------|-----------|
| gcp | brain artifact list \| get | pragma | mindbrain_answer_artifacts | read | backend running | gcp-commands.md |
| gcp | brain artifact refresh \| events | pragma | mindbrain_answer_artifacts, mindbrain_answer_events | write/read | backend running; refresh requires one exact live_answer_view id; no wildcards | gcp-commands.md |
| gcp | brain artifact migrate --dry-run \| --repair | pragma | mindbrain_answer_artifacts (offline backfill) | write | stop MCP | gcp-commands.md |

### Backup / demo / IDE

| Surface | Command | Layer | Impact | Access | Prerequisites | Runbook |
|---------|---------|-------|--------|--------|---------------|-----------|
| gcp | brain backup \| export \| load | workspace | SQLite file / bundles | write | stop MCP | skillset-demo-import.md |
| gcp | brain docs structured\|document\|import | control-plane | — | read | — | docs/setup/ |
| gcp | brain setup cursor\|codex\|claude\|generic | control-plane | IDE MCP config | write | — | gcp-client-setup.md |
| gcp | brain permissions print\|apply | control-plane | Cursor/Claude MCP allow rules | read/write | — | gcp-client-setup.md |
| gcp | agent skills … \| equip | control-plane | skills registry | read/write | — | skillset-demo-import.md |
| gcp | env … \| authorize \| bootstrap | control-plane | .ghostcrab config, native binary permissions, host project files | read/write | — | gcp-client-setup.md |
| gcp | path install\|print\|doctor | control-plane | ~/.ghostcrab/bin PATH shim | read/write | — | gcp-client-setup.md |


---

## B — MCP tools (64 registered)

| Tool | Basic | Subsystem | Access | Tables / impact |
|------|-------|-----------|--------|-----------------|
| `ghostcrab_artifact_get` | no | pragma | read | mindbrain_answer_artifacts |
| `ghostcrab_collection_facet_search` | no | graph | read | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_collection_reindex` | no | graph | write | documents_raw, search_fts, graph |
| `ghostcrab_combined_search` | yes | facets | read | agent_facts (+ facet_tables FTS when indexed) |
| `ghostcrab_count` | yes | facets | read | agent_facts (+ facet_tables FTS when indexed) |
| `ghostcrab_coverage` | no | graph | read | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_csearch` | no | facets | read | agent_facts (+ facet_tables FTS when indexed) |
| `ghostcrab_ddl_execute` | no | workspace | model | pending DDL metadata |
| `ghostcrab_ddl_list_pending` | no | workspace | model | pending DDL metadata |
| `ghostcrab_ddl_propose` | no | workspace | model | pending DDL metadata |
| `ghostcrab_entity_chunks` | no | graph | read | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_facet_catalog` | no | facets | read | facet catalog metadata |
| `ghostcrab_facet_inspect` | no | facets | read | facet catalog metadata |
| `ghostcrab_facet_register` | no | facets | write | facet catalog metadata |
| `ghostcrab_facet_validate` | no | facets | read | facet catalog metadata |
| `ghostcrab_graph_diagnostics` | no | graph | read | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_graph_gap_rules` | no | graph | read | gap_rules store |
| `ghostcrab_graph_gap_rules_delete` | no | graph | write | gap_rules store |
| `ghostcrab_graph_gap_rules_import` | no | graph | write | gap_rules store |
| `ghostcrab_graph_path` | no | graph | read | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_graph_reindex` | no | graph | write | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_graph_search` | no | graph | read | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_graph_subgraph` | no | graph | read | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_learn` | no | graph | write | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_live_refresh` | no | pragma | write | mindbrain_answer_artifacts, mindbrain_answer_events |
| `ghostcrab_loadout_apply` | no | loadout | write | bootstrap recipes / schemas seed |
| `ghostcrab_loadout_inspect` | no | loadout | read | bootstrap recipes / schemas seed |
| `ghostcrab_loadout_list` | no | loadout | read | bootstrap recipes / schemas seed |
| `ghostcrab_loadout_seed` | no | loadout | write | bootstrap recipes / schemas seed |
| `ghostcrab_loadout_suggest` | no | loadout | read | bootstrap recipes / schemas seed |
| `ghostcrab_modeling_guidance` | yes | pragma | guide | — (diagnostic) |
| `ghostcrab_onboarding_schemas` | no | facets | read | schema registry (agent_facts shapes; not LinkML ontology_*) |
| `ghostcrab_ontology_import` | no | ontology | write | ontology_* native tables; optional graph materialization for N-Triples |
| `ghostcrab_pack` | yes | pragma | read | projections + agent_facts |
| `ghostcrab_project` | yes | pragma | model | projections |
| `ghostcrab_projection_get` | no | pragma | model | graph_entity (ProjectionResult) |
| `ghostcrab_projections_list` | no | pragma | read | mindbrain_answer_artifacts, graph_entity (ProjectionResult) |
| `ghostcrab_quality_convergence_get` | no | graph | read | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_quality_convergence_list` | no | graph | read | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_quality_convergence_run` | no | graph | write | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_quality_remediation_actions` | no | graph | read | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_quality_remediation_apply` | no | graph | write | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_quality_remediation_decide` | no | graph | write | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_reindex_all` | no | facets | write | agent_facts (+ facet_tables FTS when indexed) |
| `ghostcrab_remember` | yes | facets | write | agent_facts (+ facet_tables FTS when indexed) |
| `ghostcrab_schema_get` | yes | facets | read | schema registry (agent_facts shapes; not LinkML ontology_*) |
| `ghostcrab_schema_inspect` | yes | facets | read | schema registry (agent_facts shapes; not LinkML ontology_*) |
| `ghostcrab_schema_list` | yes | facets | read | schema registry (agent_facts shapes; not LinkML ontology_*) |
| `ghostcrab_schema_register` | no | facets | write | schema registry (agent_facts shapes; not LinkML ontology_*) |
| `ghostcrab_schema_sync_apply` | no | facets | write | schema registry (agent_facts shapes; not LinkML ontology_*) |
| `ghostcrab_schema_sync_preview` | no | facets | read | schema registry (agent_facts shapes; not LinkML ontology_*) |
| `ghostcrab_search` | yes | facets | read | agent_facts (+ facet_tables FTS when indexed) |
| `ghostcrab_status` | yes | pragma | bootstrap | — (diagnostic) |
| `ghostcrab_tool_search` | yes | facets | read | agent_facts (+ facet_tables FTS when indexed) |
| `ghostcrab_traverse` | no | graph | read | entities_raw, relations_raw, graph_entity, graph_relation; facet_assignments_raw (docs) |
| `ghostcrab_upsert` | yes | facets | write | agent_facts (+ facet_tables FTS when indexed) |
| `ghostcrab_workspace_create` | no | workspace | write | workspace registry |
| `ghostcrab_workspace_delete` | no | workspace | write | workspace registry |
| `ghostcrab_workspace_export_model` | no | workspace | read | workspace registry |
| `ghostcrab_workspace_export_model_toon` | no | workspace | read | workspace registry |
| `ghostcrab_workspace_inspect` | no | workspace | read | workspace registry |
| `ghostcrab_workspace_list` | no | workspace | read | workspace registry |
| `ghostcrab_workspace_reset` | no | workspace | write | workspace registry |
| `ghostcrab_workspace_use` | no | session | session | — (routing only) |

---

## See also

- [projections-discovery.md](projections-discovery.md)
- [structured-import.md](../setup/structured-import.md)
- [document-import.md](../setup/document-import.md)
- [mcp-tools.md](mcp-tools.md)
- [ontology/README.md](../explanation/ontology/README.md)
- [StarterKit EDITIONS.md](https://gitlab.com/webigniter/starter-kit-ghostcrab-perso/-/blob/main/starterkit/EDITIONS.md)
