kanvas-ecosystem-api

Add `@search` to a GraphQL list query — pick `DatabaseSearchableTrait` vs `DynamicSearchableTrait`, implement `searchableAs()`/`toSearchableArray()`/`shouldBeSearchable()`, and (critical) override `search()` to scope by `apps_id` + `companies_id` so search doesn't leak across tenants. Load when adding `search: String @search` to a query, adding a searchable trait to a model, or auditing/fixing multi-tenant search scoping.

Build a new external-service integration under `src/Domains/Connectors/{ConnectorName}/` — Handler + Client + DTO + Enums + Webhook job + Workflow activity + GraphQL setup mutation + `integrations` row. Load when adding/editing a connector (Shopify, Stripe, WaSender, Microsoft, OpenClaw, Hermes, etc.) or its associated `app/GraphQL/Connector/` / `graphql/schemas/Connector/` files. **NOTE**: `AgentRuntime` is a primary domain at `src/Domains/Intelligence/AgentRuntime/`, NOT a connector — see the "AgentRuntime is a primary domain" section before touching it.

Canonical pattern for building a new domain CRUD in Kanvas (DTO + Create/Update Actions + GraphQL Mutation + schema + tests). Load when scaffolding a new entity under `src/Domains/{Domain}/{Entity}/` or its GraphQL surface in `app/GraphQL/{Domain}/Mutations/{Entity}/` and `graphql/schemas/{Domain}/`. Skip for connectors (use kanvas-connector) or when only editing existing CRUD code.