konecty-meta-doctor
Konecty Meta Doctor
Validate the health and integrity of Konecty metadata.
Prerequisites
Requires admin credentials from konecty-session. User must have admin: true.
Workflow
1. Run full health check
python3 scripts/meta_doctor.py check
python3 scripts/meta_doctor.py check --format json
This command uses backend POST /api/admin/meta/doctor as the source of truth.
2. Check a specific document
python3 scripts/meta_doctor.py check --document Contact
3. Check queue consistency (filtered from backend doctor report)
python3 scripts/meta_doctor.py check-queues
Checks performed by backend doctor
Schema and integrity
- Fields reference valid types
- Lookup fields reference existing documents
- InheritedFields reference valid fields on the target document
- Required fields have labels
Access integrity
- Field overrides reference fields that exist in the parent document
Queue consistency
document.eventsqueue resources exist inNamespace.QueueConfig.resources
Cross-references
- All metas reference existing parent documents
- Lookup targets reference existing
document/compositemetas - Hook static checks (syntax, blocked APIs, comments, return requirements)
Script reference
See scripts/meta_doctor.py. Stdlib only.
More from konecty/skills
konecty-meta-namespace
Manage Konecty Namespace global configuration: email servers, RabbitMQ queue config, storage, webhooks, plan settings, portal config. Use when the user wants to configure SMTP servers, add RabbitMQ queues, set up storage, configure global webhooks (onCreate/onUpdate/onDelete), manage Konsistent settings, or view global tenant configuration. Requires admin credentials.
9konecty-session
Opens a Konecty session via OTP login (request OTP, then verify OTP) and persists the access token in .env or ~/.konecty/credentials for use by other skills. Use when the user wants to log in to Konecty with OTP, store credentials, set up KONECTY_TOKEN, or establish a session so other Konecty skills can call the API. Only works when the namespace has OTP enabled (email or WhatsApp).
8konecty-create
Creates records in any Konecty module via POST /rest/data/:document. Guides through the full pre-creation workflow: discovering fields and types with konecty-modules, resolving lookup _ids with the built-in lookup command, checking picklist options, validating required fields, and submitting the payload. Use when the user wants to create a new record, insert data, send a message, add an activity, register a contact, create an opportunity, or create any document in Konecty. Requires an active konecty-session (KONECTY_URL and KONECTY_TOKEN in ~/.konecty/.env or ~/.konecty/credentials).
8konecty-meta-list
Manage Konecty list view metadata: show list definitions, manage columns, filters, sorters, calendars, and boards. Use when the user wants to create or modify list views, change column visibility or order, update default filters, or configure calendar/board views. Requires admin credentials.
8konecty-find
Searches and queries records in Konecty modules using the REST API. Supports simple document find (/rest/data/:document/find with GET or POST), cross-module JSON queries with relations and aggregators (/rest/query/json), and SQL queries (/rest/query/sql). Use when the user wants to search, list, filter, or query records in any Konecty module; needs to filter by field values (equals, contains, between, greater_than, in, exists, etc.); wants to join related documents and aggregate data (count, sum, avg); or needs pagination and sorting. Requires an active konecty-session (KONECTY_URL and KONECTY_TOKEN in ~/.konecty/.env). For unknown modules or field names, use konecty-modules first.
7konecty-update
Updates records in any Konecty module via PUT /rest/data/:document. Enforces the mandatory pre-update fetch workflow: always fetch the current record first to obtain its _updatedAt (optimistic locking guard), then PUT with ids=[{_id, _updatedAt}] and data={changed fields}. Use when the user wants to update, edit, change, or modify any record in Konecty. Requires an active konecty-session. Use konecty-modules to discover field names and types before updating.
6