Unified cross-catalog semantic or keyword search across sovereign countries and strategic cities in the Statesman comparative geopolitics manifold.

Find nearest geopolitical or urban counterparts to a specified country or city using 1024-dimensional pgvector cosine distance.

List world continents registered in Statesman with sovereign country counts.

Retrieve details of a single continent including its sovereign countries.

Create a new continent record in the catalog.

Update an existing continent's name or description.

Delete a continent and its cascaded countries and cities.

Batch insert or update continents matching case-insensitively on name.

Trigger LLM discovery to populate all 7 standard continents with geopolitical descriptions.

Discover and populate sovereign countries for a specific continent via LLM generation.

List and filter sovereign countries with statecraft themes, city counts, and vector embedding status.

Retrieve full profile of a sovereign country including continent, thematic statecraft tags, and strategic cities.

Create a new sovereign country record associated with a continent.

Update an existing country's attributes, continent, or thematic tags.

Delete a country and its cascaded strategic cities.

Batch insert or update sovereign countries scoped to a specific continent.

Calculate 1024-dimensional vector embedding for a country using the configured embedding model.

Discover and generate 8-10 strategic cities for a country via LLM extraction.

Trigger bulk LLM country discovery across all continents or a single continent.

List and filter strategic urban power centers with civic/economic themes and embedding metadata.

Retrieve details of a strategic city including its structured themes and associated country/continent.

Create a new strategic city record associated with a sovereign country.

Update an existing city's attributes, country, or thematic tags.

Delete a city record.

Batch insert or update strategic cities scoped to a specific country.

Calculate 1024-dimensional vector embedding for a city record.

Trigger bulk LLM city discovery across all countries or a single country.

Compute live connected-components vector clusters for Countries or Cities across continents without modifying the database.

Compute connected-components clustering and freeze it immediately into an immutable database snapshot.

List frozen archetype cluster snapshots.

Retrieve details of a frozen cluster snapshot including member groups and generated reports.

Delete a frozen cluster snapshot along with its cascaded cluster groups and synthesis reports.

List all archetype cluster groups belonging to a specific frozen snapshot.

Retrieve details of a specific archetype cluster group with all member countries or cities.

List generated multi-phase comparative geopolitics and urban power synthesis reports.

Retrieve complete scholarly report content, progress percentage, markdown monograph, and intermediate summaries.

Initiate a 2-Phase Map-Reduce synthesis report on a frozen cluster snapshot.

Delete a synthesis report along with its intermediate summaries and sub-reports.

Initiate a 3-Phase Hierarchical Deep Synthesis monograph, reusing Phase 1 summaries from a completed parent report.

List all Phase 1 per-cluster analyses belonging to a synthesis report.

Retrieve a single Phase 1 per-cluster scholarly summary.

List all Phase 2 intermediate batch analyses belonging to a detailed synthesis report.

Retrieve a single Phase 2 batch analysis.

List recent asynchronous background jobs (embedding calculations, LLM discoveries, synthesis reports).

Check the status, progress, and result of an ActiveJob/Sidekiq background task.

Poll a background job until completion or failure with configurable timeout.

Get overall platform health, catalog entity counts, embedding coverage stats, and active LLM configuration.

Get embedding completion metrics for Countries and Cities, active embedding/LLM parameters, and context window presets.

Dynamically update the active LLM context window token size.

Enqueue bulk embedding generation for all Countries or Cities.

Retrieve the raw OpenAPI 3.1 specification for the Statesman API.