Module validation 

Localized validation messages for memory fields. Localized validation messages for memory fields and CLI guards.

Modules

app_error_pt

Portuguese translations for AppError Display messages.

runtime_pt

Portuguese translations for runtime startup progress messages.

Functions

agent_surface_filter_empty_key

GAP-SG-142: --filter expression has an empty key on the left-hand side.

agent_surface_filter_invalid

GAP-SG-142: --filter expression carries no recognised operator.

api_key_cannot_be_empty

API key empty after read.

api_key_fingerprint_not_found

No stored API key matches the given fingerprint.

batch_line_invalid_json

Batch line: invalid JSON.

batch_line_name_empty

Batch line: name normalizes empty.

batch_line_type_description_required

Batch line: type/description required.

body_exceeds

Localized message for body_exceeds.

body_is_empty

The memory body is empty, so there is nothing to extract from.

chat_client_not_initialised

The chat client was dispatched before it had been initialised.

child_name_exceeds_max

Child name derived from parent exceeds MAX_MEMORY_NAME_LEN.

child_name_not_kebab

Child name is not kebab-case ASCII.

chunk_id_not_found_in_namespace

A chunk id did not resolve inside a specific namespace.

chunk_text_is_empty

The chunk text is empty, so there is nothing to embed.

config_file_is_symlink

Config file is a symlink (potential attack).

config_file_wrong_owner

Config file owned by a different uid; refuse overwrite.

config_key_retired

Rejects a config set key that was advertised historically but never read.

config_key_unknown

Rejects a config set key that is not in the canonical registry.

config_parse_error

Config parse error at path.

config_path_no_parent

Config path has no parent directory component.

config_value_expectation

Localized description of the domain a crate::config::ValueKind accepts.

config_value_invalid

Config value outside the domain the key accepts.

count_only_over_a_page

GAP-SG-201: --count-only over an incomplete universe emits a bare number that reads as an inventory.

deep_research_output_empty

Deep-research output file is empty.

deep_research_output_missing

Deep-research output path missing after atomic write.

description_exceeds

Localized message for description_exceeds.

description_returned_empty

The model returned a description made only of whitespace.

description_returned_null

The model returned an explicit null where a description was expected.

directory_not_found

Directory path does not exist.

edge_not_found_in_namespace

Both endpoints resolved but no edge carries relation between them.

embedded_schema_invalid_json

Embedded schema JSON is invalid.

embedding_backend_returned_empty_vector

The embedding chain resolved to no backend and produced no vector.

embedding_detail

Wrap an external / dynamic error detail as an embedding payload.

embedding_dimension_less_than_requested

Provider returned fewer dimensions than requested.

embedding_empty_response_from_openrouter

Empty data array in a successful OpenRouter embedding response.

embedding_entity_cache_null

Entity embed cache produced a null slot.

embedding_expected_count

Batch response length mismatch.

embedding_failed_to_parse_response

Failed to parse embedding JSON body.

embedding_failed_to_read_response_body

Failed to read embedding response body.

embedding_http_client_build_failed

Failed to build the reqwest HTTP client for OpenRouter embeddings.

embedding_http_request_failed

Transient network failure during embedding HTTP.

embedding_knn_search_chunks_dim_mismatch

KNN search dim mismatch (chunks).

embedding_knn_search_dim_mismatch

KNN search dim mismatch (memories / entities).

embedding_openrouter_200_neither_data_nor_error

HTTP 200 body had neither data nor error.

embedding_openrouter_chat_client_unavailable

OpenRouter chat client singleton missing after set.

embedding_openrouter_client_not_initialised

OpenRouter client not initialised for embed path.

embedding_openrouter_client_unavailable

OpenRouter embed client singleton missing after set.

embedding_openrouter_invalid_api_key_401

Invalid OpenRouter API key (HTTP 401).

embedding_openrouter_max_retries

Max retries exhausted for OpenRouter embedding request.

embedding_openrouter_probe_not_initialised

OpenRouter probe: client not initialised.

embedding_openrouter_request_timed_out

OpenRouter embedding request timed out.

embedding_openrouter_returned

OpenRouter hard-failure status with body.

embedding_openrouter_server_error

OpenRouter 5xx during embedding.

embedding_slot_exhausted

LLM slot semaphore exhausted (marker: slot exhausted).

embedding_task_join_error

JoinSet join error while embedding.

embedding_tokio_runtime_init_failed

Tokio multi-thread runtime failed to initialise.

embedding_tokio_runtime_unavailable

Tokio runtime missing after set.

embedding_unexpected_http

Unexpected HTTP status with body snippet.

empty_body

Localized message for empty_body.

empty_query

Localized message for empty_query.

enable_ner_skip_extraction_exclusive

--enable-ner and --skip-extraction conflict.

entity_id_not_found_in_namespace

An entity id did not resolve inside a specific namespace.

entity_name_all_caps_noise

Short ALL_CAPS entity name rejected as NER noise.

entity_name_already_exists

Entity rename target already exists.

entity_name_normalizes_too_short

Entity name normalizes too short.

entity_name_purely_numeric

Purely numeric entity name rejected.

entity_name_too_short

Entity name too short.

entity_named_not_found

An entity name did not resolve, in a context that has no namespace to report.

entity_named_not_found_in_namespace

An entity name did not resolve inside a specific namespace.

entity_named_not_found_with_suggestions

An entity name did not resolve, but near-matches exist.

entity_required_when_memory

–entity required when –memory is used.

entity_type_blank

Entity type label that is empty once trimmed.

entity_type_confirmed

GAP-SG-279: the model confirmed the type that was already stored.

entity_type_digits_only

Entity type label made only of digits.

entity_type_has_newline

Entity type label containing a line break.

entity_type_model_abstained

GAP-SG-279: the model read the evidence and declined to judge the type.

entity_type_no_evidence

GAP-SG-279: the entity carries no description, no linked corpus and no typed neighbour, so its type cannot be judged from anything but its name.

entity_type_suggestion_unusable

GAP-SG-279: the suggested label failed shape normalisation.

entity_type_too_long

Entity type label longer than the allowed character count.

failed_to_parse_chat_response

Failed to parse chat response JSON.

failed_to_parse_entities_array

Failed to parse entities array.

failed_to_parse_extraction

Failed to parse an ExtractionResult from a provider.

failed_to_parse_relationships_array

Failed to parse relationships array.

failed_to_read_names_file

Failed to read names file.

failed_to_read_response_body

Failed to read HTTP response body.

file_not_utf8

File bytes are not valid UTF-8.

filter_scope_is_a_page

GAP-SG-201: the predicate would observe only the page the query returned.

filter_would_desync_a_tally

GAP-SG-215: --filter on a stream would desynchronise the trailer’s tally.

from_required_without_entity_all

–from required when not using –entity/–all.

from_type_required_batch

Batch reclassify missing –from-type.

http_client_build_failed

Failed to build the HTTP client.

http_request_failed

HTTP request failed (transport-level).

ingest_aborted_on_first_failure

Ingest aborted on first failure (--fail-fast / default all-or-nothing path).

invalid_chunk_id_in_reembed_key

Invalid chunk id in re-embed key.

invalid_json_in_flag

Invalid JSON for a CLI flag that takes a file path (e.g. --entities-file).

invalid_json_payload_on_flag

Invalid JSON payload on a stdin flag (e.g. --graph-stdin).

invalid_json_schema_for_request

Invalid JSON schema for an OpenRouter request body.

invalid_link_weight

Localized message for invalid_link_weight.

invalid_memory_source

Invalid memory source string.

invalid_namespace_config

Localized message for invalid_namespace_config.

invalid_projects_mapping

Localized message for invalid_projects_mapping.

invalid_relationship_id

Invalid relationship id.

invalid_relationship_strength

Relationship strength outside [0.0, 1.0].

invalid_status_filter

Invalid pending-embeddings status filter.

invalid_tz

Localized message for invalid_tz.

key_absent

GAP-SG-202: a key given to --filter, --sort or --dedupe-by exists in no result element.

key_is_envelope_only

GAP-SG-203: the key names a member of the envelope, not a field of the elements the predicate would be applied to.

knob_needs_a_whole_set

GAP-SG-209: a knob that needs the whole set was aimed at a stream.

knob_without_target

GAP-SG-204: a knob was declared against an envelope that carries no result array, so it can have no effect at all.

legacy_embedding_backend_removed

The legacy ONNX-backed embedding extraction backend was removed in v1.0.79; extract on it is unreachable and reports why.

llm_found_no_relationship

The model read the pair and reported no relationship between them.

llm_missing_calibrated_weight

LLM result missing calibrated_weight.

llm_missing_description_field

LLM result missing description field.

llm_missing_enriched_body_field

LLM result missing enriched_body field.

llm_missing_relation

LLM result missing relation.

llm_slot_ceiling_must_be_positive

A concurrency ceiling of zero was handed to the LLM slot acquisition.

max_files_exceeded

--max-files cap exceeded (generic form used by ingest-claude/codex).

max_files_exceeded_all_or_nothing

--max-files cap exceeded with all-or-nothing abort (ingest-opencode).

max_files_exceeded_matching

--max-files cap exceeded with pattern-matching wording (ingest).

memory_id_in_other_namespace

A memory id exists but is owned by a different namespace than the one asked for. Distinct from a plain miss: the row is there, the caller is not entitled to it, and naming both namespaces is what makes that actionable.

memory_named_not_found

A memory name did not resolve, in a context that has no namespace to report.

memory_named_not_found_in_namespace

A memory name did not resolve inside a specific namespace.

missing_field

Generic “missing / required field” helper.

model_json_parse_failed

Model content could not be parsed even after JSON repair.

model_no_structured_content

Model returned no structured content.

model_non_object_json

Model returned non-object JSON after repair.

name_empty_after_normalization

Name normalized to empty (only hyphens/underscores/spaces).

name_kebab

Localized message for name_kebab.

name_length

Localized message for name_length.

name_must_not_be_empty

Empty name rejected.

name_or_id_required

Neither a name nor --id was supplied to a verb that accepts both.

name_prefix_kebab

--name-prefix must be kebab-case starting with a letter.

name_required_positional_or_flag

Memory/entity name required as positional or –name.

name_required_single_mode

Single-mode missing name.

namespace_format

Localized message for namespace_format.

namespace_length

Localized message for namespace_length.

new_name_kebab

Localized message for new_name_kebab.

new_name_length

Localized message for new_name_length.

no_input_blocks_stdin

A stdin-reading path was requested while --no-input was in force.

non_canonical_relation

Non-canonical relation under –strict-relations.

not_a_directory

Path exists but is not a directory.

openrouter_api_key_not_found

OpenRouter API key could not be resolved.

openrouter_chat_max_retries

Max retries exceeded for OpenRouter chat.

openrouter_chat_timed_out

OpenRouter chat timed out.

openrouter_invalid_api_key_401

Invalid OpenRouter API key HTTP 401.

openrouter_model_required

OpenRouter mode requires an explicit model flag.

openrouter_server_error

OpenRouter 5xx server error.

openrouter_status_error

OpenRouter returned a non-success status for a model.

pair_already_related

The entity pair already carries an edge in the graph.

pair_already_seen

The entity pair was already judged and recorded in entity_connect_seen.

path_no_valid_parent

Path has no valid parent component.

path_traversal

Localized message for path_traversal.

queue_clear_failed

Queue clear failed.

queue_insert_failed

Queue insert failed.

queue_namespace_migration_failed

Queue namespace migration failed.

queue_resume_failed

Queue resume (status=processing → pending) failed.

queue_retry_failed_reset_failed

Queue retry-failed reset failed.

reclassify_batch_no_targets

Batch reclassification whose --from-type matches no entity at all.

reclassify_needs_type_or_description

reclassify single mode: neither --new-type nor --description was given.

reembed_batch_no_outcome

The batched re-embed path produced no outcome for this key.

reembed_served_by_batch_path

Re-embed is claimed in batches, so the per-item path declines it.

reembed_target_only

--target only applies to re-embed operation.

refuse_delete_orphans_without_yes

Refusing orphan entity delete without –yes. Counts rows, not entities: the caller sums orphan entities, dangling relationships and every other foreign key violation in the file, and a message that named only one of the three would understate what is about to be deleted.

refuse_delete_vec_orphans_without_yes

Refusing vec orphan delete without –yes.

refuse_release_slot_without_yes

Refusing to release slot without –yes.

relation_format_for_relationship

Relation format error scoped to a source→target edge.

relationship_id_not_found

A relationship row id did not resolve.

requeue_dead_failed

Requeue-dead failed.

requeue_skipped_failed

Requeue-skipped failed.

reserved_name

Localized message for reserved_name.

select_fully_unresolved

GAP-SG-202: every key given to --select is unresolvable, so the projection would emit empty objects.

self_merge_id

Self-referential merge by id (generic).

self_merge_id_in_ids

Self-referential merge by id (pre-check with –ids hint).

self_merge_name

Self-referential merge by name (generic).

self_merge_name_in_names

Self-referential merge by name (pre-check with –names hint).

self_merge_name_resolves_to_target

Source name resolves to target id (self-merge).

self_referential_link

Localized message for self_referential_link.

slot_not_held

A concurrency slot was asked to be released but holds no lock file.

source_entity_not_found_in_namespace

The SOURCE endpoint of an edge did not resolve.

source_target_entity_names_identical

Source and target entity names identical.

source_target_names_identical

Source and target names identical.

split_body_needs_name_or_batch

split-body: neither a name nor --batch was supplied.

sqlite_busy_exhausted_on_dequeue

Bounded busy-retry gave up while CLAIMING the next item to work on.

sqlite_busy_exhausted_on_reembed_claim

Bounded busy-retry gave up while CLAIMING a batch for re-embedding.

strict_entity_type_folded

GAP-SG-216: --strict-entity-types refused a silent taxonomy rewrite.

strict_name_not_canonical

--strict-name refused auto-normalization.

sub_queries_file_empty

Sub-queries file has no usable lines.

sync_destination_equals_source

Localized message for sync_destination_equals_source.

system_load_exceeded

System load average exceeds 2× ncpus.

target_entity_not_found_in_namespace

The TARGET endpoint of an edge did not resolve.

target_inherited_from_config

A subcommand that changes durable state inherited its target from the XDG key db.path instead of the argv.

target_not_designated

GAP-SG-207: a subcommand that changes durable state reached path resolution without naming its target in the argv.

target_required_single_mode

Single-mode missing –target.

to_required_without_entity_all

–to required when not using –entity/–all.

to_type_required_batch

Batch reclassify missing –to-type.

too_many_name_collisions

Too many name collisions while generating a unique memory name.

type_and_description_required

CREATE path requires --type and --description.

unexpected_http_status

Unexpected HTTP status with body snippet.

unknown_pending_embeddings_status

Unknown pending_embeddings status string.

unknown_schema_id

schema --name <ID> was given an id that is not shipped in docs/schemas/.