@webiny/mcp 6.0.0-rc.5 → 6.0.0-rc.7

package/skills/infrastructure-extensions/SKILL.md

@@ -25,19 +25,19 @@ import { Ui } from "webiny/infra";
 import { CorePulumi } from "webiny/infra/core";
 
 class MyCorePulumiHandlerImpl implements CorePulumi.Interface {
-    constructor(private ui: Ui.Interface) {}
+  constructor(private ui: Ui.Interface) {}
 
-    execute(app: any) {
-        this.ui.info("Executing MyCorePulumiHandler with environment:", app.env);
+  execute(app: any) {
+    this.ui.info("Executing MyCorePulumiHandler with environment:", app.env);
 
-        // Access and modify Pulumi resources here
-        // app.resources gives you access to all provisioned resources
-    }
+    // Access and modify Pulumi resources here
+    // app.resources gives you access to all provisioned resources
+  }
 }
 
 export default CorePulumi.createImplementation({
-    implementation: MyCorePulumiHandlerImpl,
-    dependencies: [Ui]
+  implementation: MyCorePulumiHandlerImpl,
+  dependencies: [Ui]
 });
 ```
 
@@ -72,30 +72,38 @@ These components go directly in `webiny.config.tsx` -- no separate extension fil
 ### Search & Networking
 
 ```tsx
-{/* Enable/disable OpenSearch */}
-<Infra.OpenSearch enabled={true} />
+{
+  /* Enable/disable OpenSearch */
+}
+<Infra.OpenSearch enabled={true} />;
 
-{/* Enable/disable VPC deployment */}
-<Infra.Vpc enabled={false} />
+{
+  /* Enable/disable VPC deployment */
+}
+<Infra.Vpc enabled={false} />;
 ```
 
 ### Resource Naming
 
 ```tsx
-{/* Prefix all Pulumi resource names */}
-<Infra.PulumiResourceNamePrefix prefix={"myproj-"} />
+{
+  /* Prefix all Pulumi resource names */
+}
+<Infra.PulumiResourceNamePrefix prefix={"myproj-"} />;
 
-{/* Define which environments use production-grade infrastructure */}
-<Infra.ProductionEnvironments environments={["prod", "staging"]} />
+{
+  /* Define which environments use production-grade infrastructure */
+}
+<Infra.ProductionEnvironments environments={["prod", "staging"]} />;
 ```
 
 ### Custom Domains
 
 ```tsx
 <Infra.Admin.CustomDomains
-    domains={["admin.example.com"]}
-    sslMethod="sni-only"
-    certificateArn="arn:aws:acm:us-east-1:123456789:certificate/abc-123"
+  domains={["admin.example.com"]}
+  sslMethod="sni-only"
+  certificateArn="arn:aws:acm:us-east-1:123456789:certificate/abc-123"
 />
 ```
 
@@ -103,21 +111,21 @@ These components go directly in `webiny.config.tsx` -- no separate extension fil
 
 ```tsx
 <Infra.BlueGreenDeployments
-    enabled={true}
-    domains={{
-        acmCertificateArn: "arn:aws:acm:us-east-1:123456789:certificate/abc-123",
-        sslSupportMethod: "sni-only",
-        domains: {
-            api: ["api.example.com"],
-            admin: ["admin.example.com"],
-            website: ["website.example.com"],
-            preview: ["preview.example.com"]
-        }
-    }}
-    deployments={[
-        { name: "green", env: "dev", variant: "green" },
-        { name: "blue", env: "dev", variant: "blue" }
-    ]}
+  enabled={true}
+  domains={{
+    acmCertificateArn: "arn:aws:acm:us-east-1:123456789:certificate/abc-123",
+    sslSupportMethod: "sni-only",
+    domains: {
+      api: ["api.example.com"],
+      admin: ["admin.example.com"],
+      website: ["website.example.com"],
+      preview: ["preview.example.com"]
+    }
+  }}
+  deployments={[
+    { name: "green", env: "dev", variant: "green" },
+    { name: "blue", env: "dev", variant: "blue" }
+  ]}
 />
 ```
 
@@ -126,54 +134,64 @@ These components go directly in `webiny.config.tsx` -- no separate extension fil
 Use `<Infra.Env.Is>` to apply settings only in specific environments:
 
 ```tsx
-{/* Production only */}
+{
+  /* Production only */
+}
 <Infra.Env.Is env="prod">
-    <Infra.Aws.Tags tags={{ ENV: "production" }} />
-    <Infra.OpenSearch enabled={true} />
-</Infra.Env.Is>
+  <Infra.Aws.Tags tags={{ ENV: "production" }} />
+  <Infra.OpenSearch enabled={true} />
+</Infra.Env.Is>;
 
-{/* Non-production (accepts array) */}
+{
+  /* Non-production (accepts array) */
+}
 <Infra.Env.Is env={["dev", "staging"]}>
-    <Infra.Aws.Tags tags={{ ENV: "non-production" }} />
-    <Infra.OpenSearch enabled={false} />
-</Infra.Env.Is>
+  <Infra.Aws.Tags tags={{ ENV: "non-production" }} />
+  <Infra.OpenSearch enabled={false} />
+</Infra.Env.Is>;
 ```
 
 ## Project-Level Settings
 
 ```tsx
-{/* Disable telemetry */}
-<Project.Telemetry enabled={false} />
+{
+  /* Disable telemetry */
+}
+<Project.Telemetry enabled={false} />;
 
-{/* Auto-install for CI/CD (skip the installation wizard) */}
-{process.env.WEBINY_CLI_AUTO_INSTALL && (
+{
+  /* Auto-install for CI/CD (skip the installation wizard) */
+}
+{
+  process.env.WEBINY_CLI_AUTO_INSTALL && (
     <Project.AutoInstall
-        adminUser={{
-            firstName: "Ad",
-            lastName: "Min",
-            email: "admin@webiny.com",
-            password: "12345678"
-        }}
+      adminUser={{
+        firstName: "Ad",
+        lastName: "Min",
+        email: "admin@webiny.com",
+        password: "12345678"
+      }}
     />
-)}
+  );
+}
 ```
 
 ## All Infrastructure Components Reference
 
-| Component | Purpose |
-|---|---|
-| `<Infra.Aws.DefaultRegion name="..." />` | Set the AWS region |
-| `<Infra.Aws.Tags tags={{ ... }} />` | Tag all AWS resources |
-| `<Infra.OpenSearch enabled={bool} />` | Enable/disable OpenSearch cluster |
-| `<Infra.Vpc enabled={bool} />` | Enable/disable VPC deployment |
-| `<Infra.PulumiResourceNamePrefix prefix="..." />` | Prefix Pulumi resource names |
+| Component                                               | Purpose                              |
+| ------------------------------------------------------- | ------------------------------------ |
+| `<Infra.Aws.DefaultRegion name="..." />`                | Set the AWS region                   |
+| `<Infra.Aws.Tags tags={{ ... }} />`                     | Tag all AWS resources                |
+| `<Infra.OpenSearch enabled={bool} />`                   | Enable/disable OpenSearch cluster    |
+| `<Infra.Vpc enabled={bool} />`                          | Enable/disable VPC deployment        |
+| `<Infra.PulumiResourceNamePrefix prefix="..." />`       | Prefix Pulumi resource names         |
 | `<Infra.ProductionEnvironments environments={[...]} />` | Define production-grade environments |
-| `<Infra.Admin.CustomDomains ... />` | Custom domains for Admin app |
-| `<Infra.BlueGreenDeployments ... />` | Blue-green deployment configuration |
-| `<Infra.Env.Is env="..." />` | Conditional config per environment |
-| `<Infra.Core.Pulumi src="..." />` | Register a custom Pulumi handler |
-| `<Project.Telemetry enabled={bool} />` | Enable/disable telemetry |
-| `<Project.AutoInstall adminUser={{ ... }} />` | Auto-install for CI/CD |
+| `<Infra.Admin.CustomDomains ... />`                     | Custom domains for Admin app         |
+| `<Infra.BlueGreenDeployments ... />`                    | Blue-green deployment configuration  |
+| `<Infra.Env.Is env="..." />`                            | Conditional config per environment   |
+| `<Infra.Core.Pulumi src="..." />`                       | Register a custom Pulumi handler     |
+| `<Project.Telemetry enabled={bool} />`                  | Enable/disable telemetry             |
+| `<Project.AutoInstall adminUser={{ ... }} />`           | Auto-install for CI/CD               |
 
 ## Quick Reference
 

package/skills/lifecycle-events/SKILL.md

@@ -37,7 +37,7 @@ Every handler receives an `event` with:
 
 - `event.modelId` -- The model ID string (e.g., `"contactSubmission"`)
 - `event.payload` -- The entry data object
-  - `event.payload.values` -- The field values (can be mutated in `before` hooks)
+- `event.payload.values` -- The field values (can be mutated in `before` hooks)
 
 ### Pattern
 
@@ -153,11 +153,11 @@ export default Handler.createImplementation({
 
 ```typescript
 // extensions/MyApiKeyAfterUpdate.ts
-import { ApiKeyAfterUpdateHandler } from "webiny/api/security/api-key";
+import { ApiKeyAfterUpdateEventHandler } from "webiny/api/security/api-key";
 import { Logger } from "webiny/api/logger";
 import { BuildParams } from "webiny/api/build-params";
 
-class MyApiKeyAfterUpdateImpl implements ApiKeyAfterUpdateHandler.Interface {
+class MyApiKeyAfterUpdateImpl implements ApiKeyAfterUpdateEventHandler.Interface {
     constructor(
         private logger: Logger.Interface,
         private buildParams: BuildParams.Interface
@@ -171,7 +171,7 @@ class MyApiKeyAfterUpdateImpl implements ApiKeyAfterUpdateHandler.Interface {
     }
 }
 
-const MyApiKeyAfterUpdate = ApiKeyAfterUpdateHandler.createImplementation({
+const MyApiKeyAfterUpdate = ApiKeyAfterUpdateEventHandler.createImplementation({
     implementation: MyApiKeyAfterUpdateImpl,
     dependencies: [Logger, BuildParams]
 });
@@ -185,11 +185,156 @@ Register with a dedicated JSX element:
 <Security.ApiKey.AfterUpdate src={"/extensions/MyApiKeyAfterUpdate.ts"} />
 ```
 
+## All Available Event Handlers
+
+### `webiny/api/cms/entry`
+
+| Handler | Fires When |
+| --- | --- |
+| `EntryBeforeCreateEventHandler` | Before a new entry is saved |
+| `EntryAfterCreateEventHandler` | After a new entry is saved |
+| `EntryRevisionBeforeCreateEventHandler` | Before a revision is created |
+| `EntryRevisionAfterCreateEventHandler` | After a revision is created |
+| `EntryBeforeUpdateEventHandler` | Before an entry is updated |
+| `EntryAfterUpdateEventHandler` | After an entry is updated |
+| `EntryBeforeDeleteEventHandler` | Before an entry is deleted |
+| `EntryAfterDeleteEventHandler` | After an entry is deleted |
+| `EntryRevisionBeforeDeleteEventHandler` | Before a revision is deleted |
+| `EntryRevisionAfterDeleteEventHandler` | After a revision is deleted |
+| `EntryBeforeDeleteMultipleEventHandler` | Before multiple entries are deleted |
+| `EntryAfterDeleteMultipleEventHandler` | After multiple entries are deleted |
+| `EntryBeforeMoveEventHandler` | Before an entry is moved |
+| `EntryAfterMoveEventHandler` | After an entry is moved |
+| `EntryBeforePublishEventHandler` | Before an entry is published |
+| `EntryAfterPublishEventHandler` | After an entry is published |
+| `EntryBeforeRepublishEventHandler` | Before an entry is republished |
+| `EntryAfterRepublishEventHandler` | After an entry is republished |
+| `EntryBeforeRestoreFromBinEventHandler` | Before an entry is restored from bin |
+| `EntryAfterRestoreFromBinEventHandler` | After an entry is restored from bin |
+| `EntryBeforeUnpublishEventHandler` | Before an entry is unpublished |
+| `EntryAfterUnpublishEventHandler` | After an entry is unpublished |
+
+### `webiny/api/cms/model`
+
+| Handler | Fires When |
+| --- | --- |
+| `ModelBeforeCreateEventHandler` | Before a model is created |
+| `ModelAfterCreateEventHandler` | After a model is created |
+| `ModelBeforeCreateFromEventHandler` | Before a model is cloned |
+| `ModelAfterCreateFromEventHandler` | After a model is cloned |
+| `ModelBeforeUpdateEventHandler` | Before a model is updated |
+| `ModelAfterUpdateEventHandler` | After a model is updated |
+| `ModelBeforeDeleteEventHandler` | Before a model is deleted |
+| `ModelAfterDeleteEventHandler` | After a model is deleted |
+
+### `webiny/api/cms/group`
+
+| Handler | Fires When |
+| --- | --- |
+| `GroupBeforeCreateEventHandler` | Before a group is created |
+| `GroupAfterCreateEventHandler` | After a group is created |
+| `GroupBeforeUpdateEventHandler` | Before a group is updated |
+| `GroupAfterUpdateEventHandler` | After a group is updated |
+| `GroupBeforeDeleteEventHandler` | Before a group is deleted |
+| `GroupAfterDeleteEventHandler` | After a group is deleted |
+
+### `webiny/api/security/authentication`
+
+| Handler | Fires When |
+| --- | --- |
+| `BeforeAuthenticationEventHandler` | Before authentication |
+| `AfterAuthenticationEventHandler` | After authentication |
+
+### `webiny/api/security/api-key`
+
+| Handler | Fires When |
+| --- | --- |
+| `ApiKeyBeforeCreateEventHandler` | Before an API key is created |
+| `ApiKeyAfterCreateEventHandler` | After an API key is created |
+| `ApiKeyBeforeDeleteEventHandler` | Before an API key is deleted |
+| `ApiKeyAfterDeleteEventHandler` | After an API key is deleted |
+| `ApiKeyBeforeUpdateEventHandler` | Before an API key is updated |
+| `ApiKeyAfterUpdateEventHandler` | After an API key is updated |
+
+### `webiny/api/security/role`
+
+| Handler | Fires When |
+| --- | --- |
+| `RoleBeforeCreateEventHandler` | Before a role is created |
+| `RoleAfterCreateEventHandler` | After a role is created |
+| `RoleBeforeDeleteEventHandler` | Before a role is deleted |
+| `RoleAfterDeleteEventHandler` | After a role is deleted |
+| `RoleBeforeUpdateEventHandler` | Before a role is updated |
+| `RoleAfterUpdateEventHandler` | After a role is updated |
+
+### `webiny/api/security/user`
+
+| Handler | Fires When |
+| --- | --- |
+| `UserBeforeCreateEventHandler` | Before a user is created |
+| `UserAfterCreateEventHandler` | After a user is created |
+| `UserBeforeDeleteEventHandler` | Before a user is deleted |
+| `UserAfterDeleteEventHandler` | After a user is deleted |
+| `UserBeforeUpdateEventHandler` | Before a user is updated |
+| `UserAfterUpdateEventHandler` | After a user is updated |
+
+### `webiny/api/tenancy`
+
+| Handler | Fires When |
+| --- | --- |
+| `TenantBeforeCreateEventHandler` | Before a tenant is created |
+| `TenantAfterCreateEventHandler` | After a tenant is created |
+| `TenantBeforeUpdateEventHandler` | Before a tenant is updated |
+| `TenantAfterUpdateEventHandler` | After a tenant is updated |
+| `TenantBeforeDeleteEventHandler` | Before a tenant is deleted |
+| `TenantAfterDeleteEventHandler` | After a tenant is deleted |
+| `TenantInstalledEventHandler` | After a tenant is installed |
+
+### `webiny/api/system`
+
+| Handler | Fires When |
+| --- | --- |
+| `SystemInstalledEventHandler` | After the system is installed |
+
+### `webiny/api/website-builder/page`
+
+| Handler | Fires When |
+| --- | --- |
+| `PageBeforeCreateEventHandler` | Before a page is created |
+| `PageAfterCreateEventHandler` | After a page is created |
+| `PageBeforeCreateRevisionFromEventHandler` | Before a page revision is created |
+| `PageAfterCreateRevisionFromEventHandler` | After a page revision is created |
+| `PageBeforeDeleteEventHandler` | Before a page is deleted |
+| `PageAfterDeleteEventHandler` | After a page is deleted |
+| `PageBeforeDuplicateEventHandler` | Before a page is duplicated |
+| `PageAfterDuplicateEventHandler` | After a page is duplicated |
+| `PageBeforeMoveEventHandler` | Before a page is moved |
+| `PageAfterMoveEventHandler` | After a page is moved |
+| `PageBeforePublishEventHandler` | Before a page is published |
+| `PageAfterPublishEventHandler` | After a page is published |
+| `PageBeforeUnpublishEventHandler` | Before a page is unpublished |
+| `PageAfterUnpublishEventHandler` | After a page is unpublished |
+| `PageBeforeUpdateEventHandler` | Before a page is updated |
+| `PageAfterUpdateEventHandler` | After a page is updated |
+
+### `webiny/api/website-builder/redirect`
+
+| Handler | Fires When |
+| --- | --- |
+| `RedirectBeforeCreateEventHandler` | Before a redirect is created |
+| `RedirectAfterCreateEventHandler` | After a redirect is created |
+| `RedirectBeforeDeleteEventHandler` | Before a redirect is deleted |
+| `RedirectAfterDeleteEventHandler` | After a redirect is deleted |
+| `RedirectBeforeMoveEventHandler` | Before a redirect is moved |
+| `RedirectAfterMoveEventHandler` | After a redirect is moved |
+| `RedirectBeforeUpdateEventHandler` | Before a redirect is updated |
+| `RedirectAfterUpdateEventHandler` | After a redirect is updated |
+
 ## Quick Reference
 
 ```
 CMS hooks import:   import { EntryBeforeCreateEventHandler } from "webiny/api/cms/entry";
-Security import:    import { ApiKeyAfterUpdateHandler } from "webiny/api/security/apiKey";
+Security import:    import { ApiKeyAfterUpdateEventHandler } from "webiny/api/security/api-key";
 Event shape:        event.modelId (string), event.payload (object), event.payload.values (object)
 Export:             Handler.createImplementation({ implementation, dependencies })
 Register CMS:       <Api.Extension src={"/extensions/MyHook.ts"} />
@@ -200,4 +345,4 @@ Deploy:             yarn webiny deploy api
 ## Related Skills
 
 - `content-models` -- Define the models your hooks target
-- `dependency-injection` -- Inject Logger, BuildParams, and other services
+- `dependency-injection` -- Inject Logger, BuildParams, and other services into event handlers

package/skills/local-development/SKILL.md

@@ -75,12 +75,14 @@ yarn webiny watch api
 ```
 
 How it works:
+
 1. **Lambda stubs deployed** -- real Lambda functions are replaced with stubs that forward events
 2. **Events forwarded** -- requests to AWS get forwarded to your local machine
 3. **Local execution** -- your code runs locally with full AWS Lambda environment
 4. **Response routing** -- responses sent back through the Lambda stub
 
 Benefits:
+
 - See backend code changes instantly (no redeployment)
 - Debug locally with standard Node.js tools
 - Console logs appear directly in your terminal
@@ -112,6 +114,7 @@ yarn webiny watch admin
 ### Long-Lived Environments
 
 Persistent environments maintained over time:
+
 - **dev** -- daily development
 - **staging** -- pre-production testing
 - **prod** -- production
@@ -121,6 +124,7 @@ Best practice: manage via CI/CD pipelines.
 ### Short-Lived Environments
 
 Temporary environments for specific purposes:
+
 - Feature branch testing
 - PR previews
 - Experimentation
@@ -136,6 +140,7 @@ yarn webiny destroy --env feature-123
 ### Deployment Modes
 
 Webiny has two deployment templates:
+
 - **dev** -- smaller, cheaper infrastructure for development
 - **prod** -- production-grade infrastructure with HA, backups, auto-scaling
 
@@ -149,6 +154,7 @@ The mode is determined by whether the environment name is in the `ProductionEnvi
 ## State Files
 
 State files are JSON files that track the current state of your deployment:
+
 - Store infrastructure resource info, configurations, and metadata
 - Essential for managing environments and tracking changes
 - Stored in S3 by default
@@ -170,12 +176,12 @@ Access in API extensions:
 import { BuildParams } from "webiny/api/build-params";
 
 class MyExtension implements SomeFactory.Interface {
-    constructor(private buildParams: BuildParams.Interface) {}
+  constructor(private buildParams: BuildParams.Interface) {}
 
-    execute() {
-        const value = this.buildParams.get<string>("MY_PARAM");
-        const config = this.buildParams.get<{ myKey: number }>("MY_CONFIG");
-    }
+  execute() {
+    const value = this.buildParams.get<string>("MY_PARAM");
+    const config = this.buildParams.get<{ myKey: number }>("MY_CONFIG");
+  }
 }
 ```
 
@@ -184,6 +190,7 @@ class MyExtension implements SomeFactory.Interface {
 ### API Errors
 
 During `yarn webiny watch api`:
+
 - **Console logs** appear directly in the terminal
 - Use `console.log()` for quick debugging
 - Use `Logger` (DI-injected) for production logging to CloudWatch
@@ -200,6 +207,7 @@ this.logger.error("Something failed");
 ### Admin Errors
 
 Use browser DevTools:
+
 - **Console** -- view logs and errors
 - **Network tab** -- inspect GraphQL requests/responses
 - **React Developer Tools** -- debug component state/props
@@ -208,6 +216,7 @@ Use browser DevTools:
 ### Infrastructure Errors
 
 Deployment errors from Pulumi typically relate to:
+
 - IAM permission issues
 - AWS service quotas
 - Resource configuration problems
@@ -216,17 +225,17 @@ Check the deployment output for specific error messages.
 
 ## CLI Commands Reference
 
-| Command | Purpose |
-|---|---|
-| `yarn webiny deploy` | Deploy all applications |
-| `yarn webiny deploy [core\|api\|admin]` | Deploy specific application |
-| `yarn webiny deploy --env <name>` | Deploy to specific environment |
-| `yarn webiny destroy --env <name>` | Destroy an environment |
-| `yarn webiny watch api` | Start local API development |
-| `yarn webiny watch admin` | Start local Admin development |
-| `yarn webiny info` | Show deployment info and URLs |
-| `yarn webiny info --env <name>` | Show info for specific environment |
-| `yarn webiny extension <name>` | Install a pre-built extension |
+| Command                                 | Purpose                            |
+| --------------------------------------- | ---------------------------------- |
+| `yarn webiny deploy`                    | Deploy all applications            |
+| `yarn webiny deploy [core\|api\|admin]` | Deploy specific application        |
+| `yarn webiny deploy --env <name>`       | Deploy to specific environment     |
+| `yarn webiny destroy --env <name>`      | Destroy an environment             |
+| `yarn webiny watch api`                 | Start local API development        |
+| `yarn webiny watch admin`               | Start local Admin development      |
+| `yarn webiny info`                      | Show deployment info and URLs      |
+| `yarn webiny info --env <name>`         | Show info for specific environment |
+| `yarn webiny extension <name>`          | Install a pre-built extension      |
 
 ## Quick Reference