gnapsis: Skill for Claude Code

Gnapsis Smoke Test

Run through every gnapsis MCP tool to verify the system is functional. This skill exercises the full feature set: project setup, taxonomy, entity CRUD, references, search, subgraph queries, document analysis, validation, and multi-source support.

Prerequisites

1. Database must be running: just db-up
2. gnapsis must be installed: cargo install --path .
3. MCP server must be connected: /mcp

Test Procedure

Run each phase sequentially. If any step fails, jump to Phase 10 (Cleanup) to restore the original config before reporting the failure. Track entity IDs, reference IDs, and category IDs created during the test for cleanup.

Phase 0: Config Isolation

The smoke test uses a separate project name (gnapsis_smoke_test) so it gets its own graph and does not interfere with the real project data.

0.1 Backup the real config:

cp .gnapsis.toml .gnapsis.toml.bak

0.2 Overwrite .gnapsis.toml with the smoke test config:

# Force local database — overrides global ~/.config/gnapsis/config.toml
[postgres]
uri = "postgresql://postgres:postgres@localhost:5432/gnapsis_dev"

[embedding]
provider = "fastembed"
model = "BAAI/bge-small-en-v1.5"
dimensions = 384

[project]
name = "smoke_test"

[[project.sources]]
id = "default"
path = "<absolute path to this repo>"

[[project.sources]]
id = "vault"
path = "<absolute path to vault source from the backup>"

Copy the source paths from the backup file. The key differences are:

• [postgres] and [embedding] force the local Docker database (overrides global config)
• name = "smoke_test" creates graph gnapsis_smoke_test instead of gnapsis_gnapsis

0.3 Reconnect the MCP server so it picks up the new config: /mcp

Phase 1: Database Reset & Init

1.1 Drop the smoke test graph so init starts fresh:

just db-reset
just db-up

Wait for the database to be ready before proceeding.

1.2 Run init_project (force: true) and verify:

• Response includes db_version and graph_version
• applied_db_migrations is non-empty
• applied_graph_migrations is non-empty
• was_initialized is false (fresh graph)