@modyo/mcp 0.1.0

package/build/tools/customers/users/ManageUser.js

@@ -0,0 +1,277 @@
+import { RealmsRepository } from "../../../repositories/customers/realms/RealmsRepository.js";
+import { UsersRepository } from "../../../repositories/customers/users/UsersRepository.js";
+import { cleanObject, ToolBase } from "../../../shared/index.js";
+import { z } from "zod";
+const customFieldSchema = z.object({
+    user_custom_field_id: z.number().min(1).describe("Custom field ID"),
+    value: z
+        .union([
+        z.string(),
+        z.number(),
+        z.boolean(),
+    ])
+        .describe("Custom field value"),
+});
+const paramsSchema = z
+    .object({
+    realmUid: z.string().min(2).max(100).describe("Realm UID"),
+    userId: z
+        .number()
+        .optional()
+        .describe("User ID for direct update (skips search)"),
+    email: z.string().email().optional().describe("Email (used as lookup key)"),
+    username: z
+        .string()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe("Username (required for new users)"),
+    first_name: z.string().min(1).optional().describe("First name"),
+    last_name: z.string().min(1).optional().describe("Last name"),
+    second_last_name: z.string().min(1).optional().describe("Second last name"),
+    password: z
+        .string()
+        .min(8)
+        .optional()
+        .describe("Password (required for new users, min 8 chars)"),
+    birth_at: z.string().optional().describe("Birth date (YYYY-MM-DD)"),
+    sex: z
+        .enum([
+        "0",
+        "1",
+        "2",
+        "3",
+        "4",
+    ])
+        .optional()
+        .describe("0=male 1=female 2=non_binary 3=other 4=prefer_not_to_say"),
+    external_id: z.string().optional().describe("External integration ID"),
+    tag_list: z.string().optional().describe("Comma-separated tags"),
+    activate: z.boolean().optional().describe("Activate or deactivate user"),
+    custom_fields: z
+        .array(customFieldSchema)
+        .optional()
+        .describe("Array of custom field values"),
+    time_zone: z.string().optional().describe("User time zone"),
+    locale: z.string().optional().describe("Locale (e.g., 'en', 'es')"),
+    verify: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Refetch to verify (default: true)"),
+})
+    .refine((data) => data.userId || data.username || data.email, {
+    message: "At least one of userId, username, or email must be provided",
+});
+class ManageRealmUserTool extends ToolBase {
+    config = {
+        name: "customers-users-manage",
+        description: `Idempotent user create/update. Lookup priority: userId > username > email. Creates if not found, updates if exists. password + username required for new users.
+📚 modyo://docs/tools/customers-users-manage`,
+        annotations: {
+            title: "Manage Customer Users",
+            readOnlyHint: false,
+            idempotentHint: true,
+            destructiveHint: false,
+        },
+        isPublic: false,
+    };
+    getParamsSchema() {
+        return paramsSchema;
+    }
+    async execute(params) {
+        const { realmUid, userId, username, email, verify, activate, ...userFields } = params;
+        const usersRepo = await this.getRepository(UsersRepository);
+        const realmsRepo = await this.getRepository(RealmsRepository);
+        // Convert sex from string to number if provided
+        const processedFields = {
+            ...userFields,
+            username,
+            sex: userFields.sex ? Number.parseInt(userFields.sex, 10) : undefined,
+        };
+        // Priority 1: Direct update by userId
+        if (userId) {
+            const cleanedFields = cleanObject(processedFields);
+            this.debug("Updating user by ID", {
+                realmUid,
+                userId,
+                fields: Object.keys(cleanedFields),
+            });
+            // Handle activation/deactivation via dedicated endpoints
+            if (activate === true) {
+                await usersRepo.activateUser(realmUid, userId);
+            }
+            else if (activate === false) {
+                await usersRepo.deactivateUser(realmUid, userId);
+            }
+            // Update other fields if any were provided
+            let updatedUser;
+            if (Object.keys(cleanedFields).length > 0) {
+                updatedUser = await usersRepo.updateUser(realmUid, userId, cleanedFields);
+            }
+            // Verify or fetch final state
+            if (verify || !updatedUser) {
+                const fetchedUser = await usersRepo.getUser(realmUid, userId);
+                return this.success({
+                    id: fetchedUser.id,
+                    uuid: fetchedUser.uuid,
+                    username: fetchedUser.username,
+                    email: fetchedUser.email,
+                    name: fetchedUser.name,
+                    active: fetchedUser.active,
+                    action: "updated",
+                    ...(verify
+                        ? {
+                            verified: true,
+                        }
+                        : {}),
+                });
+            }
+            this.logger("Updated user by ID", {
+                realmUid,
+                userId: updatedUser.id,
+                username: updatedUser.username,
+                email: updatedUser.email,
+            });
+            return this.success({
+                id: updatedUser.id,
+                uuid: updatedUser.uuid,
+                username: updatedUser.username,
+                email: updatedUser.email,
+                name: updatedUser.name,
+                active: updatedUser.active,
+                action: "updated",
+            });
+        }
+        // Priority 2: Search by username
+        if (username) {
+            this.debug("Searching for existing user by username", {
+                realmUid,
+                username,
+            });
+            const existingUsers = await realmsRepo.getAllRealmUsers(realmUid, {
+                query: username,
+            });
+            // Filter to exact username match (query searches multiple fields)
+            const existingUser = existingUsers.find((u) => u.username.toLowerCase() === username.toLowerCase());
+            if (existingUser) {
+                return this.updateExistingUser(realmUid, existingUser.id, processedFields, activate, verify, usersRepo);
+            }
+            // Username not found — fall through to creation
+            if (!email) {
+                throw new Error("email is required when creating a new user");
+            }
+            if (!userFields.password) {
+                throw new Error("password is required when creating a new user");
+            }
+            return this.createNewUser(realmUid, {
+                email,
+                ...processedFields,
+            }, activate, verify, usersRepo);
+        }
+        // Priority 3: Search by email
+        if (!email) {
+            throw new Error("At least one of userId, username, or email must be provided");
+        }
+        this.debug("Searching for existing user by email", {
+            realmUid,
+            email,
+        });
+        const existingUsers = await realmsRepo.getAllRealmUsers(realmUid, {
+            query: email,
+        });
+        // Filter to exact email match (query searches multiple fields)
+        const existingUser = existingUsers.find((u) => u.email.toLowerCase() === email.toLowerCase());
+        if (existingUser) {
+            return this.updateExistingUser(realmUid, existingUser.id, processedFields, activate, verify, usersRepo);
+        }
+        // Email not found — create new user
+        if (!username) {
+            throw new Error("username is required when creating a new user");
+        }
+        if (!userFields.password) {
+            throw new Error("password is required when creating a new user");
+        }
+        return this.createNewUser(realmUid, {
+            email,
+            ...processedFields,
+        }, activate, verify, usersRepo);
+    }
+    async updateExistingUser(realmUid, existingUserId, processedFields, activate, _verify, usersRepo) {
+        const cleanedFields = cleanObject(processedFields);
+        // Handle activation/deactivation via dedicated endpoints
+        if (activate === true) {
+            await usersRepo.activateUser(realmUid, existingUserId);
+        }
+        else if (activate === false) {
+            await usersRepo.deactivateUser(realmUid, existingUserId);
+        }
+        this.debug("Updating existing user", {
+            realmUid,
+            userId: existingUserId,
+            fields: Object.keys(cleanedFields),
+        });
+        const updatedUser = await usersRepo.updateUser(realmUid, existingUserId, cleanedFields);
+        this.logger("Updated existing user", {
+            realmUid,
+            userId: updatedUser.id,
+            username: updatedUser.username,
+            email: updatedUser.email,
+        });
+        return this.success({
+            id: updatedUser.id,
+            uuid: updatedUser.uuid,
+            username: updatedUser.username,
+            email: updatedUser.email,
+            name: updatedUser.name,
+            active: updatedUser.active,
+            action: "updated",
+        });
+    }
+    async createNewUser(realmUid, fields, activate, verify, usersRepo) {
+        const cleanedFields = cleanObject(fields);
+        this.debug("Creating new user", {
+            realmUid,
+            email: fields.email,
+            username: fields.username,
+        });
+        const newUser = await usersRepo.createUser(realmUid, cleanedFields);
+        // Handle activation after creation if requested
+        if (activate === true) {
+            await usersRepo.activateUser(realmUid, newUser.id);
+        }
+        else if (activate === false) {
+            await usersRepo.deactivateUser(realmUid, newUser.id);
+        }
+        this.logger("Created new user", {
+            realmUid,
+            userId: newUser.id,
+            username: newUser.username,
+            email: newUser.email,
+        });
+        if (verify) {
+            const verifiedUser = await usersRepo.getUser(realmUid, newUser.id);
+            return this.success({
+                id: verifiedUser.id,
+                uuid: verifiedUser.uuid,
+                username: verifiedUser.username,
+                email: verifiedUser.email,
+                name: verifiedUser.name,
+                active: verifiedUser.active,
+                action: "created",
+                verified: true,
+            });
+        }
+        return this.success({
+            id: newUser.id,
+            uuid: newUser.uuid,
+            username: newUser.username,
+            email: newUser.email,
+            name: newUser.name,
+            active: newUser.active,
+            action: "created",
+        });
+    }
+}
+export const ManageUser = new ManageRealmUserTool();
+//# sourceMappingURL=ManageUser.js.map

package/build/tools/customers/users/ManageUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManageUser.js","sourceRoot":"","sources":["../../../../src/tools/customers/users/ManageUser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACnE,KAAK,EAAE,CAAC;SACL,KAAK,CAAC;QACL,CAAC,CAAC,MAAM,EAAE;QACV,CAAC,CAAC,MAAM,EAAE;QACV,CAAC,CAAC,OAAO,EAAE;KACZ,CAAC;SACD,QAAQ,CAAC,oBAAoB,CAAC;CAClC,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC;KACnB,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;IAC1D,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0CAA0C,CAAC;IACvD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC3E,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mCAAmC,CAAC;IAChD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC/D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;IAC7D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAC3E,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACnE,GAAG,EAAE,CAAC;SACH,IAAI,CAAC;QACJ,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;KACJ,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;IACvE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACtE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAChE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACxE,aAAa,EAAE,CAAC;SACb,KAAK,CAAC,iBAAiB,CAAC;SACxB,QAAQ,EAAE;SACV,QAAQ,CAAC,8BAA8B,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC3D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACnE,MAAM,EAAE,CAAC;SACN,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,mCAAmC,CAAC;CACjD,CAAC;KACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,EAAE;IAC5D,OAAO,EAAE,6DAA6D;CACvE,CAAC,CAAC;AAIL,MAAM,mBAAoB,SAAQ,QAAsB;IAC5C,MAAM,GAAG;QACjB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE;6CAC4B;QACzC,WAAW,EAAE;YACX,KAAK,EAAE,uBAAuB;YAC9B,YAAY,EAAE,KAAK;YACnB,cAAc,EAAE,IAAI;YACpB,eAAe,EAAE,KAAK;SACvB;QACD,QAAQ,EAAE,KAAK;KAChB,CAAC;IAEQ,eAAe;QACvB,OAAO,YAAY,CAAC;IACtB,CAAC;IAES,KAAK,CAAC,OAAO,CAAC,MAAoB;QAC1C,MAAM,EACJ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,KAAK,EACL,MAAM,EACN,QAAQ,EACR,GAAG,UAAU,EACd,GAAG,MAAM,CAAC;QACX,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;QAE9D,gDAAgD;QAChD,MAAM,eAAe,GAAG;YACtB,GAAG,UAAU;YACb,QAAQ;YACR,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;SACtE,CAAC;QAEF,sCAAsC;QACtC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,aAAa,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;YAEnD,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE;gBAChC,QAAQ;gBACR,MAAM;gBACN,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;aACnC,CAAC,CAAC;YAEH,yDAAyD;YACzD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,MAAM,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACjD,CAAC;iBAAM,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;gBAC9B,MAAM,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC;YAED,2CAA2C;YAC3C,IAAI,WAAW,CAAC;YAChB,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1C,WAAW,GAAG,MAAM,SAAS,CAAC,UAAU,CACtC,QAAQ,EACR,MAAM,EACN,aAAa,CACd,CAAC;YACJ,CAAC;YAED,8BAA8B;YAC9B,IAAI,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC3B,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAC9D,OAAO,IAAI,CAAC,OAAO,CAAC;oBAClB,EAAE,EAAE,WAAW,CAAC,EAAE;oBAClB,IAAI,EAAE,WAAW,CAAC,IAAI;oBACtB,QAAQ,EAAE,WAAW,CAAC,QAAQ;oBAC9B,KAAK,EAAE,WAAW,CAAC,KAAK;oBACxB,IAAI,EAAE,WAAW,CAAC,IAAI;oBACtB,MAAM,EAAE,WAAW,CAAC,MAAM;oBAC1B,MAAM,EAAE,SAAS;oBACjB,GAAG,CAAC,MAAM;wBACR,CAAC,CAAC;4BACE,QAAQ,EAAE,IAAI;yBACf;wBACH,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC,CAAC;YACL,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE;gBAChC,QAAQ;gBACR,MAAM,EAAE,WAAW,CAAC,EAAE;gBACtB,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC9B,KAAK,EAAE,WAAW,CAAC,KAAK;aACzB,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC,OAAO,CAAC;gBAClB,EAAE,EAAE,WAAW,CAAC,EAAE;gBAClB,IAAI,EAAE,WAAW,CAAC,IAAI;gBACtB,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC9B,KAAK,EAAE,WAAW,CAAC,KAAK;gBACxB,IAAI,EAAE,WAAW,CAAC,IAAI;gBACtB,MAAM,EAAE,WAAW,CAAC,MAAM;gBAC1B,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;QACL,CAAC;QAED,iCAAiC;QACjC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,yCAAyC,EAAE;gBACpD,QAAQ;gBACR,QAAQ;aACT,CAAC,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC,gBAAgB,CAAC,QAAQ,EAAE;gBAChE,KAAK,EAAE,QAAQ;aAChB,CAAC,CAAC;YAEH,kEAAkE;YAClE,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,CACrC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,WAAW,EAAE,CAC3D,CAAC;YAEF,IAAI,YAAY,EAAE,CAAC;gBACjB,OAAO,IAAI,CAAC,kBAAkB,CAC5B,QAAQ,EACR,YAAY,CAAC,EAAE,EACf,eAAe,EACf,QAAQ,EACR,MAAM,EACN,SAAS,CACV,CAAC;YACJ,CAAC;YAED,gDAAgD;YAChD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAChE,CAAC;YAED,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACnE,CAAC;YAED,OAAO,IAAI,CAAC,aAAa,CACvB,QAAQ,EACR;gBACE,KAAK;gBACL,GAAG,eAAe;aACnB,EACD,QAAQ,EACR,MAAM,EACN,SAAS,CACV,CAAC;QACJ,CAAC;QAED,8BAA8B;QAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,6DAA6D,CAC9D,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,sCAAsC,EAAE;YACjD,QAAQ;YACR,KAAK;SACN,CAAC,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC,gBAAgB,CAAC,QAAQ,EAAE;YAChE,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QAEH,+DAA+D;QAC/D,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,CACrC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CACrD,CAAC;QAEF,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,kBAAkB,CAC5B,QAAQ,EACR,YAAY,CAAC,EAAE,EACf,eAAe,EACf,QAAQ,EACR,MAAM,EACN,SAAS,CACV,CAAC;QACJ,CAAC;QAED,oCAAoC;QACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CACvB,QAAQ,EACR;YACE,KAAK;YACL,GAAG,eAAe;SACnB,EACD,QAAQ,EACR,MAAM,EACN,SAAS,CACV,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAC9B,QAAgB,EAChB,cAAsB,EACtB,eAAwC,EACxC,QAA6B,EAC7B,OAA4B,EAC5B,SAA0B;QAE1B,MAAM,aAAa,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;QAEnD,yDAAyD;QACzD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACzD,CAAC;aAAM,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC9B,MAAM,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,wBAAwB,EAAE;YACnC,QAAQ;YACR,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;SACnC,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,UAAU,CAC5C,QAAQ,EACR,cAAc,EACd,aAAa,CACd,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,uBAAuB,EAAE;YACnC,QAAQ;YACR,MAAM,EAAE,WAAW,CAAC,EAAE;YACtB,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,KAAK,EAAE,WAAW,CAAC,KAAK;SACzB,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,OAAO,CAAC;YAClB,EAAE,EAAE,WAAW,CAAC,EAAE;YAClB,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,MAAM,EAAE,WAAW,CAAC,MAAM;YAC1B,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,QAAgB,EAChB,MAA+B,EAC/B,QAA6B,EAC7B,MAA2B,EAC3B,SAA0B;QAE1B,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAE1C,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE;YAC9B,QAAQ;YACR,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAEpE,gDAAgD;QAChD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACrD,CAAC;aAAM,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC9B,MAAM,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE;YAC9B,QAAQ;YACR,MAAM,EAAE,OAAO,CAAC,EAAE;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YACnE,OAAO,IAAI,CAAC,OAAO,CAAC;gBAClB,EAAE,EAAE,YAAY,CAAC,EAAE;gBACnB,IAAI,EAAE,YAAY,CAAC,IAAI;gBACvB,QAAQ,EAAE,YAAY,CAAC,QAAQ;gBAC/B,KAAK,EAAE,YAAY,CAAC,KAAK;gBACzB,IAAI,EAAE,YAAY,CAAC,IAAI;gBACvB,MAAM,EAAE,YAAY,CAAC,MAAM;gBAC3B,MAAM,EAAE,SAAS;gBACjB,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC;YAClB,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,CAAC,MAAM,UAAU,GAAS,IAAI,mBAAmB,EAAE,CAAC"}

package/build/tools/customers/users/UsersTools.d.ts

@@ -0,0 +1,2 @@
+export declare const UsersTools: Tool[];
+//# sourceMappingURL=UsersTools.d.ts.map

package/build/tools/customers/users/UsersTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsersTools.d.ts","sourceRoot":"","sources":["../../../../src/tools/customers/users/UsersTools.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,EAAE,IAAI,EAI5B,CAAC"}

package/build/tools/customers/users/UsersTools.js

@@ -0,0 +1,9 @@
+import { BulkManageUsers } from "./BulkManageUsers.js";
+import { ListRealmUsers } from "./ListRealmUsers.js";
+import { ManageUser } from "./ManageUser.js";
+export const UsersTools = [
+    ManageUser,
+    BulkManageUsers,
+    ListRealmUsers,
+];
+//# sourceMappingURL=UsersTools.js.map

package/build/tools/customers/users/UsersTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsersTools.js","sourceRoot":"","sources":["../../../../src/tools/customers/users/UsersTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,CAAC,MAAM,UAAU,GAAW;IAChC,UAAU;IACV,eAAe;IACf,cAAc;CACf,CAAC"}

package/build/tools/tools.d.ts

@@ -0,0 +1,3 @@
+declare const tools: Tool[];
+export default tools;
+//# sourceMappingURL=tools.d.ts.map

package/build/tools/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/tools/tools.ts"],"names":[],"mappings":"AAmCA,QAAA,MAAM,KAAK,EAAE,IAAI,EAkChB,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/build/tools/tools.js

@@ -0,0 +1,70 @@
+// Core tools
+// Channels tools
+import { AccountTemplatesTools } from "./channels/accountTemplates/AccountTemplatesTools.js";
+import { DownloadTools } from "./channels/download/DownloadTools.js";
+import { GlobalVariablesTools } from "./channels/globalVariables/GlobalVariablesTools.js";
+import { LocksTools } from "./channels/locks/LocksTools.js";
+import { NavigationTools } from "./channels/navigation/NavigationTools.js";
+import { PagesTools } from "./channels/pages/PagesTools.js";
+import { PreviewTools } from "./channels/preview/PreviewTools.js";
+import { ReleasesTools } from "./channels/releases/ReleasesTools.js";
+import { SitesTools } from "./channels/sites/SitesTools.js";
+import { TemplatesTools } from "./channels/templates/TemplatesTools.js";
+import { WidgetDefinitionsTools } from "./channels/widgetDefinitions/WidgetDefinitionsTools.js";
+// Content tools
+import { AssetTools } from "./content/assets/AssetTools.js";
+import { CategoriesTools } from "./content/categories/CategoriesTools.js";
+import { EntriesTools } from "./content/entries/EntriesTools.js";
+import { JobsTools } from "./content/jobs/JobsTools.js";
+import { SpacesTools } from "./content/spaces/SpacesTools.js";
+import { TypesTools } from "./content/types/TypesTools.js";
+import { GroupsTools } from "./core/groups/GroupsTools.js";
+import { RolesTools } from "./core/roles/RolesTools.js";
+import { SettingsTools as CoreSettingsTools } from "./core/settings/SettingsTools.js";
+import { TeamTools } from "./core/team/TeamTools.js";
+import { TeamMembersTools } from "./core/teamMembers/TeamMembersTools.js";
+import { FormsTools } from "./customers/forms/FormsTools.js";
+import { OriginationsTools } from "./customers/originations/OriginationsTools.js";
+// Customers tools
+import { RealmsTools } from "./customers/realms/RealmsTools.js";
+import { SegmentsTools } from "./customers/segments/SegmentsTools.js";
+import { SettingsTools as CustomersSettingsTools } from "./customers/settings/SettingsTools.js";
+import { SubmissionsTools } from "./customers/submissions/SubmissionsTools.js";
+import { UsersTools } from "./customers/users/UsersTools.js";
+const tools = [
+    // Core
+    ...GroupsTools,
+    ...RolesTools,
+    ...CoreSettingsTools,
+    ...TeamTools,
+    ...TeamMembersTools,
+    // Content
+    ...SpacesTools,
+    ...TypesTools,
+    ...CategoriesTools,
+    ...EntriesTools,
+    ...AssetTools,
+    ...JobsTools,
+    // Channels
+    ...SitesTools,
+    ...PagesTools,
+    ...TemplatesTools,
+    ...AccountTemplatesTools,
+    ...WidgetDefinitionsTools,
+    ...GlobalVariablesTools,
+    ...ReleasesTools,
+    ...NavigationTools,
+    ...LocksTools,
+    ...DownloadTools,
+    ...PreviewTools,
+    // Customers
+    ...RealmsTools,
+    ...OriginationsTools,
+    ...SubmissionsTools,
+    ...UsersTools,
+    ...CustomersSettingsTools,
+    ...FormsTools,
+    ...SegmentsTools,
+];
+export default tools;
+//# sourceMappingURL=tools.js.map

package/build/tools/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/tools/tools.ts"],"names":[],"mappings":"AAAA,aAAa;AAEb,iBAAiB;AACjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,sDAAsD,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAChG,gBAAgB;AAChB,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAClF,kBAAkB;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EAAE,aAAa,IAAI,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,MAAM,KAAK,GAAW;IACpB,OAAO;IACP,GAAG,WAAW;IACd,GAAG,UAAU;IACb,GAAG,iBAAiB;IACpB,GAAG,SAAS;IACZ,GAAG,gBAAgB;IACnB,UAAU;IACV,GAAG,WAAW;IACd,GAAG,UAAU;IACb,GAAG,eAAe;IAClB,GAAG,YAAY;IACf,GAAG,UAAU;IACb,GAAG,SAAS;IACZ,WAAW;IACX,GAAG,UAAU;IACb,GAAG,UAAU;IACb,GAAG,cAAc;IACjB,GAAG,qBAAqB;IACxB,GAAG,sBAAsB;IACzB,GAAG,oBAAoB;IACvB,GAAG,aAAa;IAChB,GAAG,eAAe;IAClB,GAAG,UAAU;IACb,GAAG,aAAa;IAChB,GAAG,YAAY;IACf,YAAY;IACZ,GAAG,WAAW;IACd,GAAG,iBAAiB;IACpB,GAAG,gBAAgB;IACnB,GAAG,UAAU;IACb,GAAG,sBAAsB;IACzB,GAAG,UAAU;IACb,GAAG,aAAa;CACjB,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/docs/INDEX.md

@@ -0,0 +1,72 @@
+# Modyo MCP Server — Documentation Index
+
+> Entry point para toda la documentación del proyecto.
+> Referenciado desde `CLAUDE.md` (raíz del repo).
+
+## Platform — Dominio Modyo
+
+Arquitectura y conceptos de la plataforma Modyo.
+
+| Documento | Descripción |
+|-----------|-------------|
+| [platform/architecture.md](platform/architecture.md) | Arquitectura general de la plataforma |
+| [platform/content.md](platform/content.md) | Módulo Content (spaces, types, entries) |
+| [platform/channels.md](platform/channels.md) | Módulo Channels (sites, pages, widgets) |
+| [platform/customers.md](platform/customers.md) | Módulo Customers (realms, users, forms) |
+| [platform/core.md](platform/core.md) | Módulo Core (team, groups, roles) |
+| [platform/api-quirks.md](platform/api-quirks.md) | Quirks y particularidades de la API |
+
+## Channels — Sites, Liquid, Templates
+
+Documentación detallada del módulo Channels.
+
+| Documento | Descripción |
+|-----------|-------------|
+| [channels/site-architecture.md](channels/site-architecture.md) | Arquitectura de sitios |
+| [channels/page-types.md](channels/page-types.md) | Tipos de página |
+| [channels/snippets/](channels/snippets/) | Sistema de snippets |
+| [channels/liquid/](channels/liquid/) | Liquid: referencia, drops, filtros |
+| [channels/templates/](channels/templates/) | Templates: estados, workflows |
+| [channels/css-js/](channels/css-js/) | CSS y JavaScript en sitios |
+| [channels/publishing-workflow.md](channels/publishing-workflow.md) | Workflow de publicación |
+| [channels/versioning-system.md](channels/versioning-system.md) | Sistema de versionamiento |
+| [channels/best-practices.md](channels/best-practices.md) | Best practices de Channels |
+| [channels/site-setup-checklist.md](channels/site-setup-checklist.md) | Checklist post-creación de sitios |
+
+## Widgets — Desarrollo en plataforma Modyo
+
+Conocimiento de plataforma sobre widgets. El contexto de generación IA se integrará desde dynamic-context en una fase posterior.
+
+| Documento | Descripción |
+|-----------|-------------|
+| [widgets/platform/development.md](widgets/platform/development.md) | Best practices de desarrollo |
+| [widgets/platform/workflows.md](widgets/platform/workflows.md) | Workflows de widgets |
+| [widgets/platform/editing-published.md](widgets/platform/editing-published.md) | Edición de widgets publicados |
+
+## Development — Patrones del MCP Server
+
+Guías para contribuir al MCP server.
+
+| Documento | Descripción |
+|-----------|-------------|
+| [development/tool-patterns.md](development/tool-patterns.md) | Patrones de desarrollo de tools |
+| [development/test-utilities.md](development/test-utilities.md) | Utilidades de testing |
+| [development/e2e-test-guide.md](development/e2e-test-guide.md) | Guía de tests E2E |
+| [development/mcp-overview.md](development/mcp-overview.md) | Overview del protocolo MCP |
+
+## Tools — Documentación de las 68 herramientas
+
+| Documento | Descripción |
+|-----------|-------------|
+| [tools/TOOLS_SUMMARY.md](tools/TOOLS_SUMMARY.md) | Resumen de todas las tools |
+| [tools/PAGE_WIDGET_TOOLS.md](tools/PAGE_WIDGET_TOOLS.md) | Tools de páginas y widgets |
+| [tools/WIDGET_TOOLS.md](tools/WIDGET_TOOLS.md) | Tools de widget definitions |
+| [tools/RELEASE_TOOLS.md](tools/RELEASE_TOOLS.md) | Tools de releases |
+| [tools/PAGE_PARAMETERS_EXPLAINED.md](tools/PAGE_PARAMETERS_EXPLAINED.md) | Parámetros de páginas |
+| [tools/channels/](tools/channels/) | Docs específicos por tool |
+
+## Workflows
+
+| Documento | Descripción |
+|-----------|-------------|
+| [workflows/published-page-deletion.md](workflows/published-page-deletion.md) | Eliminación de páginas publicadas |

package/docs/channels/best-practices.md

@@ -0,0 +1,149 @@
+# Modyo Platform Best Practices
+
+Essential rules for all Modyo development work. Follow these principles consistently.
+
+## Content Security Policy (CSP)
+
+1. **ALWAYS** include `nonce="{{csp_nonce}}"` on inline `<style>` and `<script>` tags
+2. **NEVER** use inline `style=""` or event attributes (`onclick`, `onload`, etc.)
+3. **ALWAYS** include `nonce: csp_nonce` parameter in `stylesheet_tag` and `script_tag` filters
+4. Use event listeners in `<script>` tags instead of inline event handlers
+
+## CSS and JavaScript Organization
+
+### Hierarchy (Preference Order)
+
+1. **CSS/JS Templates** - For global, reusable code (CDN-cached)
+2. **Widget CSS/JS Properties** - For widget-specific code
+3. **Snippet `<style>`/`<script>` Tags** - For component-specific code only
+
+### Decision Rules
+
+- If used across multiple pages → CSS/JS Template
+- If part of a widget → Widget CSS/JS properties
+- If component-specific and not reused → Snippet tags with nonce
+- Never use inline `style=""` or event attributes
+
+## URL Management
+
+1. **ALWAYS** use site-relative URLs (`/products`, not `https://site.com/products`)
+2. **PREFER** Modyo URL helpers (`{{ site.url }}`, `{{ asset.url }}`)
+3. **NEVER** hardcode domain names in templates
+
+## Liquid Templates
+
+### Defensive Programming
+
+1. **ALWAYS** check variable existence before use (`{% if variable %}`)
+2. **ALWAYS** filter by visibility (`menu.items | visible_items`)
+3. **ALWAYS** assign repeated expressions to variables (cache)
+4. Handle `nil` cases gracefully with fallbacks
+
+### Global Drops
+
+Available everywhere: `site`, `request`, `menus`, `spaces`, `current_user`, `csp_nonce`
+
+### Field Names
+
+1. **ALWAYS** use exact field names from type schema (case-sensitive)
+2. **VERIFY** field names with `type-get` before using in templates
+3. Remember Modyo uses `snake_case` (not `camelCase`)
+
+## Navigation Menus
+
+1. Access via `menus['slug']` (case-sensitive slug, not name)
+2. **ALWAYS** check menu exists before iterating
+3. **ALWAYS** filter items by visibility (`| visible_items`)
+4. Use `| active_page: request.url` for active state
+5. Use `| item_rel` filter for external link `rel` attributes
+
+## Content Pages
+
+1. **NEVER** use leading slash in `path` parameter (`"blog"` not `"/blog"`)
+2. Set `has_router: true` to enable dynamic slug routing
+3. Provide `content_type_id` for content/entry pages
+4. Use two templates: `index` (list) and `show` (detail)
+
+## Widget Development
+
+1. **ALWAYS** include all three properties: `html`, `css`, `js` (empty string if not needed)
+2. **PREFER** `sync: false` (async loading) except for critical above-the-fold content
+3. **ALWAYS** publish widget before adding to pages
+4. Use `definition_uuid` (not `id`) when adding widgets to pages
+
+## Publishing Workflow
+
+1. **ALWAYS** use two-step process: `release-get-elements-to-publish` → `release-create`
+2. Publish related changes together (template + menu, widget + page, etc.)
+3. **NEVER** publish partially if changes depend on each other
+4. Widget IDs change after publishing; UUIDs remain stable
+
+## Performance
+
+1. Use `defer: 'defer'` for non-critical JavaScript
+2. Cache filtered/computed values in variables
+3. Prefer CSS/JS templates (CDN-cached) over inline code
+4. Limit menu nesting to 3 levels maximum
+
+## Accessibility
+
+1. Use semantic HTML (`<nav>`, `<main>`, `<article>`)
+2. Include ARIA attributes (`role`, `aria-label`, `aria-current`)
+3. Indicate active page state (`aria-current="page"`)
+4. Mark external links visually and with `aria-label`
+5. Provide skip navigation links
+
+## Testing Requirements
+
+Before deploying, verify:
+
+- [ ] All inline styles/scripts have `nonce="{{csp_nonce}}"`
+- [ ] No hardcoded domains in URLs
+- [ ] All variables checked for existence
+- [ ] Visibility filters applied to menus/items
+- [ ] Field names match type schema exactly
+- [ ] Content page paths have no leading slash
+- [ ] External links have proper `target` and `rel`
+- [ ] Widget CSS/JS properties included (even if empty)
+- [ ] Related changes published together
+
+## Common Violations to Avoid
+
+| Violation | Impact | Fix |
+|-----------|--------|-----|
+| Missing nonce | CSP blocks code | Add `nonce="{{csp_nonce}}"` |
+| Inline style/onclick | CSP blocks code | Use classes + event listeners |
+| Hardcoded URLs | Breaks in other environments | Use site-relative paths |
+| No existence checks | Liquid errors | Add `{% if variable %}` |
+| Wrong field names | Missing content | Verify with `type-get` |
+| Leading slash in path | Broken routing | Remove leading `/` |
+| Partial publishing | Inconsistent state | Publish related changes together |
+| Omitting widget properties | Update fails | Include all: html, css, js |
+
+## Priority Rules
+
+**CRITICAL** (Must never violate):
+- CSP nonce on inline code
+- No inline style/event attributes
+- No hardcoded domains
+- Exact field name matching
+
+**HIGH** (Follow consistently):
+- Existence checks
+- Visibility filtering
+- Site-relative URLs
+- Two-step publishing
+
+**MEDIUM** (Best practice):
+- CSS/JS template preference
+- Async widget loading
+- Variable caching
+- Semantic HTML
+
+## Resources
+
+For implementation details ("how to"), see:
+- [Navigation Liquid Guide](./resources/modyo-tools/channels/navigation/navigation-menus-liquid-guide.md)
+- [CSS/JS Templates Guide](./CSS_JS_TEMPLATES.md)
+- [Channels Module Guide](../src/tools/channels/CLAUDE.md)
+- [Content Module Guide](../src/tools/content/CLAUDE.md)