@structured-world/gitlab-mcp 4.0.0 → 4.1.1

package/dist/entities/utils.d.ts

@@ -1,3 +1,3 @@
 import { z } from 'zod';
-export declare const flexibleBoolean: z.ZodPipe<z.ZodTransform<boolean, unknown>, z.ZodBoolean>;
-export declare const flexibleBooleanNullable: z.ZodNullable<z.ZodPipe<z.ZodTransform<boolean, unknown>, z.ZodBoolean>> | z.ZodDefault<z.ZodNullable<z.ZodPipe<z.ZodTransform<boolean, unknown>, z.ZodBoolean>>>;
+export declare const flexibleBoolean: z.ZodEffects<z.ZodBoolean, boolean, unknown>;
+export declare const flexibleBooleanNullable: z.ZodNullable<z.ZodEffects<z.ZodBoolean, boolean, unknown>> | z.ZodDefault<z.ZodNullable<z.ZodEffects<z.ZodBoolean, boolean, unknown>>>;

package/dist/entities/variables/registry.js

@@ -8,20 +8,19 @@ const zod_to_json_schema_1 = require("zod-to-json-schema");
 const schema_readonly_1 = require("./schema-readonly");
 const schema_1 = require("./schema");
 const fetch_1 = require("../../utils/fetch");
+const namespace_1 = require("../../utils/namespace");
 exports.variablesToolRegistry = new Map([
     [
         'list_variables',
         {
             name: 'list_variables',
-            description: 'List all CI/CD variables for a project or group with their configuration and security settings. Supports both project-level and group-level variables',
+            description: 'View all CI/CD environment variables configured for pipelines. Use to audit secrets, review configuration, or understand pipeline environment. Shows variable keys (values are masked for security). Returns protection status, masking, and environment scopes. Group variables are inherited by all projects.',
             inputSchema: (0, zod_to_json_schema_1.zodToJsonSchema)(schema_readonly_1.ListVariablesSchema),
             handler: async (args) => {
                 const options = schema_readonly_1.ListVariablesSchema.parse(args);
-                const { project_id, group_id } = options;
-                const isProject = !!project_id;
-                const entityType = isProject ? 'projects' : 'groups';
-                const entityId = (isProject ? project_id : group_id);
-                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodeURIComponent(entityId)}/variables`;
+                const { namespacePath } = options;
+                const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(namespacePath);
+                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodedPath}/variables`;
                 const response = await (0, fetch_1.enhancedFetch)(apiUrl, {
                     headers: {
                         Authorization: `Bearer ${process.env.GITLAB_TOKEN}`,
@@ -39,19 +38,17 @@ exports.variablesToolRegistry = new Map([
         'get_variable',
         {
             name: 'get_variable',
-            description: 'Get a specific CI/CD variable by key from a project or group, optionally filtered by environment scope. Useful for checking variable configuration and troubleshooting pipeline issues',
+            description: 'Retrieve specific CI/CD variable details including value (if not masked), type, and security settings. Use for debugging pipeline issues, verifying configuration, or checking environment-specific values. Supports scoped variables for different environments (production/staging).',
             inputSchema: (0, zod_to_json_schema_1.zodToJsonSchema)(schema_readonly_1.GetVariableSchema),
             handler: async (args) => {
                 const options = schema_readonly_1.GetVariableSchema.parse(args);
-                const { project_id, group_id, key, filter } = options;
-                const isProject = !!project_id;
-                const entityType = isProject ? 'projects' : 'groups';
-                const entityId = (isProject ? project_id : group_id);
+                const { namespacePath, key, filter } = options;
+                const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(namespacePath);
                 const queryParams = new URLSearchParams();
                 if (filter?.environment_scope) {
                     queryParams.set('filter[environment_scope]', filter.environment_scope);
                 }
-                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodeURIComponent(entityId)}/variables/${encodeURIComponent(key)}?${queryParams}`;
+                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodedPath}/variables/${encodeURIComponent(key)}?${queryParams}`;
                 const response = await (0, fetch_1.enhancedFetch)(apiUrl, {
                     headers: {
                         Authorization: `Bearer ${process.env.GITLAB_TOKEN}`,
@@ -69,21 +66,19 @@ exports.variablesToolRegistry = new Map([
         'create_variable',
         {
             name: 'create_variable',
-            description: 'Create a new CI/CD variable for automated deployments and pipeline configuration in a project or group. Supports environment scoping, security settings (protected/masked), and different variable types (env_var/file)',
+            description: 'Add new CI/CD environment variable for pipeline configuration, secrets, or deployment settings. Use for API keys, database URLs, feature flags. Supports masking sensitive values, protection for specific branches, environment scoping, and file type for certificates/configs. Group variables apply to all child projects.',
             inputSchema: (0, zod_to_json_schema_1.zodToJsonSchema)(schema_1.CreateVariableSchema),
             handler: async (args) => {
                 const options = schema_1.CreateVariableSchema.parse(args);
-                const { project_id, group_id } = options;
-                const isProject = !!project_id;
-                const entityType = isProject ? 'projects' : 'groups';
-                const entityId = (isProject ? project_id : group_id);
+                const { namespacePath } = options;
+                const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(namespacePath);
                 const body = {};
                 Object.entries(options).forEach(([key, value]) => {
-                    if (value !== undefined && value !== null && key !== 'project_id' && key !== 'group_id') {
+                    if (value !== undefined && value !== null && key !== 'namespacePath') {
                         body[key] = value;
                     }
                 });
-                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodeURIComponent(entityId)}/variables`;
+                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodedPath}/variables`;
                 const response = await (0, fetch_1.enhancedFetch)(apiUrl, {
                     method: 'POST',
                     headers: {
@@ -104,20 +99,17 @@ exports.variablesToolRegistry = new Map([
         'update_variable',
         {
             name: 'update_variable',
-            description: "Update an existing CI/CD variable's value, security settings, or configuration in a project or group. Can modify variable type, environment scope, and protection settings",
+            description: 'Modify CI/CD variable value or configuration. Use to rotate secrets, update endpoints, change security settings, or adjust environment scopes. Can convert between env_var and file types. Changes take effect in next pipeline run. Be cautious with production variables.',
             inputSchema: (0, zod_to_json_schema_1.zodToJsonSchema)(schema_1.UpdateVariableSchema),
             handler: async (args) => {
                 const options = schema_1.UpdateVariableSchema.parse(args);
-                const { project_id, group_id, key, filter } = options;
-                const isProject = !!project_id;
-                const entityType = isProject ? 'projects' : 'groups';
-                const entityId = (isProject ? project_id : group_id);
+                const { namespacePath, key, filter } = options;
+                const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(namespacePath);
                 const body = {};
                 Object.entries(options).forEach(([k, value]) => {
                     if (value !== undefined &&
                         value !== null &&
-                        k !== 'project_id' &&
-                        k !== 'group_id' &&
+                        k !== 'namespacePath' &&
                         k !== 'key' &&
                         k !== 'filter') {
                         body[k] = value;
@@ -127,7 +119,7 @@ exports.variablesToolRegistry = new Map([
                 if (filter?.environment_scope) {
                     queryParams.set('filter[environment_scope]', filter.environment_scope);
                 }
-                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodeURIComponent(entityId)}/variables/${encodeURIComponent(key)}?${queryParams}`;
+                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodedPath}/variables/${encodeURIComponent(key)}?${queryParams}`;
                 const response = await (0, fetch_1.enhancedFetch)(apiUrl, {
                     method: 'PUT',
                     headers: {
@@ -148,19 +140,17 @@ exports.variablesToolRegistry = new Map([
         'delete_variable',
         {
             name: 'delete_variable',
-            description: 'Remove a CI/CD variable from a project or group. Can target specific environment scope variants when multiple variables exist with the same key',
+            description: 'Delete CI/CD variable permanently from configuration. Use to remove unused secrets, clean up after migrations, or revoke access. Can target specific environment-scoped variants. Warning: may break pipelines depending on the variable. Cannot be undone.',
             inputSchema: (0, zod_to_json_schema_1.zodToJsonSchema)(schema_1.DeleteVariableSchema),
             handler: async (args) => {
                 const options = schema_1.DeleteVariableSchema.parse(args);
-                const { project_id, group_id, key, filter } = options;
-                const isProject = !!project_id;
-                const entityType = isProject ? 'projects' : 'groups';
-                const entityId = (isProject ? project_id : group_id);
+                const { namespacePath, key, filter } = options;
+                const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(namespacePath);
                 const queryParams = new URLSearchParams();
                 if (filter?.environment_scope) {
                     queryParams.set('filter[environment_scope]', filter.environment_scope);
                 }
-                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodeURIComponent(entityId)}/variables/${encodeURIComponent(key)}?${queryParams}`;
+                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodedPath}/variables/${encodeURIComponent(key)}?${queryParams}`;
                 const response = await (0, fetch_1.enhancedFetch)(apiUrl, {
                     method: 'DELETE',
                     headers: {

package/dist/entities/variables/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/entities/variables/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/entities/variables/registry.ts"],"names":[],"mappings":"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"}

package/dist/entities/variables/schema-readonly.d.ts

@@ -1,17 +1,40 @@
 import { z } from 'zod';
 export declare const ListVariablesSchema: z.ZodObject<{
-    project_id: z.ZodOptional<z.ZodCoercedString<unknown>>;
-    group_id: z.ZodOptional<z.ZodCoercedString<unknown>>;
+    namespacePath: z.ZodString;
+} & {
     page: z.ZodOptional<z.ZodNumber>;
     per_page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    per_page: number;
+    namespacePath: string;
+    page?: number | undefined;
+}, {
+    namespacePath: string;
+    page?: number | undefined;
+    per_page?: number | undefined;
+}>;
 export declare const GetVariableSchema: z.ZodObject<{
-    project_id: z.ZodOptional<z.ZodCoercedString<unknown>>;
-    group_id: z.ZodOptional<z.ZodCoercedString<unknown>>;
+    namespacePath: z.ZodString;
     key: z.ZodString;
     filter: z.ZodOptional<z.ZodObject<{
         environment_scope: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
+    }, "strip", z.ZodTypeAny, {
+        environment_scope?: string | undefined;
+    }, {
+        environment_scope?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    namespacePath: string;
+    filter?: {
+        environment_scope?: string | undefined;
+    } | undefined;
+}, {
+    key: string;
+    namespacePath: string;
+    filter?: {
+        environment_scope?: string | undefined;
+    } | undefined;
+}>;
 export type ListVariablesOptions = z.infer<typeof ListVariablesSchema>;
 export type GetVariableOptions = z.infer<typeof GetVariableSchema>;

package/dist/entities/variables/schema-readonly.js

@@ -5,17 +5,11 @@ const zod_1 = require("zod");
 const shared_1 = require("../shared");
 exports.ListVariablesSchema = zod_1.z
     .object({
-    project_id: zod_1.z.coerce.string().optional().describe('Project ID or URL-encoded path'),
-    group_id: zod_1.z.coerce.string().optional().describe('Group ID or URL-encoded path'),
+    namespacePath: zod_1.z.string().describe('Namespace path (group or project) to list variables from'),
 })
-    .merge(shared_1.PaginationOptionsSchema)
-    .refine((data) => Boolean(data.project_id) !== Boolean(data.group_id), {
-    message: 'Exactly one of project_id or group_id must be provided',
-});
-exports.GetVariableSchema = zod_1.z
-    .object({
-    project_id: zod_1.z.coerce.string().optional().describe('Project ID or URL-encoded path'),
-    group_id: zod_1.z.coerce.string().optional().describe('Group ID or URL-encoded path'),
+    .merge(shared_1.PaginationOptionsSchema);
+exports.GetVariableSchema = zod_1.z.object({
+    namespacePath: zod_1.z.string().describe('Namespace path (group or project) containing the variable'),
     key: zod_1.z
         .string()
         .describe('The key of the CI/CD variable. Maximum 255 characters, alphanumeric and underscore only'),
@@ -28,8 +22,5 @@ exports.GetVariableSchema = zod_1.z
     })
         .optional()
         .describe('Filter parameters for the variable lookup'),
-})
-    .refine((data) => Boolean(data.project_id) !== Boolean(data.group_id), {
-    message: 'Exactly one of project_id or group_id must be provided',
 });
 //# sourceMappingURL=schema-readonly.js.map

package/dist/entities/variables/schema-readonly.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-readonly.js","sourceRoot":"","sources":["../../../src/entities/variables/schema-readonly.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,sCAAoD;AAKvC,QAAA,mBAAmB,GAAG,OAAC;KACjC,MAAM,CAAC;IACN,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACnF,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CAChF,CAAC;KACD,KAAK,CAAC,gCAAuB,CAAC;KAC9B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;IACrE,OAAO,EAAE,wDAAwD;CAClE,CAAC,CAAC;AAGQ,QAAA,iBAAiB,GAAG,OAAC;KAC/B,MAAM,CAAC;IACN,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACnF,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC/E,GAAG,EAAE,OAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACP,yFAAyF,CAC1F;IACH,MAAM,EAAE,OAAC;SACN,MAAM,CAAC;QACN,iBAAiB,EAAE,OAAC;aACjB,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,0GAA0G,CAC3G;KACJ,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,CAAC;CACzD,CAAC;KACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;IACrE,OAAO,EAAE,wDAAwD;CAClE,CAAC,CAAC"}
+{"version":3,"file":"schema-readonly.js","sourceRoot":"","sources":["../../../src/entities/variables/schema-readonly.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,sCAAoD;AAKvC,QAAA,mBAAmB,GAAG,OAAC;KACjC,MAAM,CAAC;IACN,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;CAC/F,CAAC;KACD,KAAK,CAAC,gCAAuB,CAAC,CAAC;AAGrB,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;IAC/F,GAAG,EAAE,OAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACP,yFAAyF,CAC1F;IACH,MAAM,EAAE,OAAC;SACN,MAAM,CAAC;QACN,iBAAiB,EAAE,OAAC;aACjB,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,0GAA0G,CAC3G;KACJ,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,CAAC;CACzD,CAAC,CAAC"}

package/dist/entities/variables/schema.d.ts

@@ -1,45 +1,102 @@
 import { z } from 'zod';
 export declare const CreateVariableSchema: z.ZodObject<{
-    project_id: z.ZodOptional<z.ZodCoercedString<unknown>>;
-    group_id: z.ZodOptional<z.ZodCoercedString<unknown>>;
-    key: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+    namespacePath: z.ZodString;
+    key: z.ZodEffects<z.ZodString, string, unknown>;
     value: z.ZodString;
-    variable_type: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodEnum<{
-        file: "file";
-        env_var: "env_var";
-    }>>>>;
+    variable_type: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodEnum<["env_var", "file"]>, "file" | "env_var", unknown>>>;
     environment_scope: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    protected: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodTransform<boolean, unknown>, z.ZodBoolean>>>;
-    masked: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodTransform<boolean, unknown>, z.ZodBoolean>>>;
-    raw: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodTransform<boolean, unknown>, z.ZodBoolean>>>;
+    protected: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodBoolean, boolean, unknown>>>;
+    masked: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodBoolean, boolean, unknown>>>;
+    raw: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodBoolean, boolean, unknown>>>;
     description: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    value: string;
+    namespacePath: string;
+    variable_type: "file" | "env_var";
+    environment_scope: string;
+    protected: boolean;
+    masked: boolean;
+    raw: boolean;
+    description?: string | undefined;
+}, {
+    value: string;
+    namespacePath: string;
+    key?: unknown;
+    description?: string | undefined;
+    variable_type?: unknown;
+    environment_scope?: string | undefined;
+    protected?: unknown;
+    masked?: unknown;
+    raw?: unknown;
+}>;
 export declare const UpdateVariableSchema: z.ZodObject<{
-    project_id: z.ZodOptional<z.ZodCoercedString<unknown>>;
-    group_id: z.ZodOptional<z.ZodCoercedString<unknown>>;
+    namespacePath: z.ZodString;
     key: z.ZodString;
     value: z.ZodString;
-    variable_type: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodEnum<{
-        file: "file";
-        env_var: "env_var";
-    }>>>;
+    variable_type: z.ZodOptional<z.ZodEffects<z.ZodEnum<["env_var", "file"]>, "file" | "env_var", unknown>>;
     environment_scope: z.ZodOptional<z.ZodString>;
-    protected: z.ZodOptional<z.ZodPipe<z.ZodTransform<boolean, unknown>, z.ZodBoolean>>;
-    masked: z.ZodOptional<z.ZodPipe<z.ZodTransform<boolean, unknown>, z.ZodBoolean>>;
-    raw: z.ZodOptional<z.ZodPipe<z.ZodTransform<boolean, unknown>, z.ZodBoolean>>;
+    protected: z.ZodOptional<z.ZodEffects<z.ZodBoolean, boolean, unknown>>;
+    masked: z.ZodOptional<z.ZodEffects<z.ZodBoolean, boolean, unknown>>;
+    raw: z.ZodOptional<z.ZodEffects<z.ZodBoolean, boolean, unknown>>;
     description: z.ZodOptional<z.ZodString>;
     filter: z.ZodOptional<z.ZodObject<{
         environment_scope: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
+    }, "strip", z.ZodTypeAny, {
+        environment_scope?: string | undefined;
+    }, {
+        environment_scope?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    value: string;
+    namespacePath: string;
+    filter?: {
+        environment_scope?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    variable_type?: "file" | "env_var" | undefined;
+    environment_scope?: string | undefined;
+    protected?: boolean | undefined;
+    masked?: boolean | undefined;
+    raw?: boolean | undefined;
+}, {
+    key: string;
+    value: string;
+    namespacePath: string;
+    filter?: {
+        environment_scope?: string | undefined;
+    } | undefined;
+    description?: string | undefined;
+    variable_type?: unknown;
+    environment_scope?: string | undefined;
+    protected?: unknown;
+    masked?: unknown;
+    raw?: unknown;
+}>;
 export declare const DeleteVariableSchema: z.ZodObject<{
-    project_id: z.ZodOptional<z.ZodCoercedString<unknown>>;
-    group_id: z.ZodOptional<z.ZodCoercedString<unknown>>;
+    namespacePath: z.ZodString;
     key: z.ZodString;
     filter: z.ZodOptional<z.ZodObject<{
         environment_scope: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
+    }, "strip", z.ZodTypeAny, {
+        environment_scope?: string | undefined;
+    }, {
+        environment_scope?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    namespacePath: string;
+    filter?: {
+        environment_scope?: string | undefined;
+    } | undefined;
+}, {
+    key: string;
+    namespacePath: string;
+    filter?: {
+        environment_scope?: string | undefined;
+    } | undefined;
+}>;
 export type CreateVariableOptions = z.infer<typeof CreateVariableSchema>;
 export type UpdateVariableOptions = z.infer<typeof UpdateVariableSchema>;
 export type DeleteVariableOptions = z.infer<typeof DeleteVariableSchema>;

package/dist/entities/variables/schema.js

@@ -24,10 +24,8 @@ const variableKey = zod_1.z.preprocess((val) => {
     .string()
     .max(255)
     .regex(/^[a-zA-Z0-9_]+$/, 'Key must contain only alphanumeric characters and underscores'));
-exports.CreateVariableSchema = zod_1.z
-    .object({
-    project_id: zod_1.z.coerce.string().optional().describe('Project ID or URL-encoded path'),
-    group_id: zod_1.z.coerce.string().optional().describe('Group ID or URL-encoded path'),
+exports.CreateVariableSchema = zod_1.z.object({
+    namespacePath: zod_1.z.string().describe('Namespace path (group or project) to create variable in'),
     key: variableKey.describe('The unique key for the CI/CD variable. Maximum 255 characters, only alphanumeric and underscore characters allowed. Used to reference the variable in CI/CD pipelines (e.g., $MY_API_KEY)'),
     value: zod_1.z
         .string()
@@ -57,14 +55,9 @@ exports.CreateVariableSchema = zod_1.z
         .string()
         .optional()
         .describe('Optional description explaining the purpose and usage of this variable. Helps team members understand what this variable is for and how it should be used (Available in GitLab 16.2+)'),
-})
-    .refine((data) => Boolean(data.project_id) !== Boolean(data.group_id), {
-    message: 'Exactly one of project_id or group_id must be provided',
 });
-exports.UpdateVariableSchema = zod_1.z
-    .object({
-    project_id: zod_1.z.coerce.string().optional().describe('Project ID or URL-encoded path'),
-    group_id: zod_1.z.coerce.string().optional().describe('Group ID or URL-encoded path'),
+exports.UpdateVariableSchema = zod_1.z.object({
+    namespacePath: zod_1.z.string().describe('Namespace path (group or project) containing the variable'),
     key: zod_1.z
         .string()
         .describe('The key of the existing CI/CD variable to update. Must match an existing variable key exactly'),
@@ -100,14 +93,9 @@ exports.UpdateVariableSchema = zod_1.z
     })
         .optional()
         .describe('Filter parameters to identify the specific variable to update'),
-})
-    .refine((data) => Boolean(data.project_id) !== Boolean(data.group_id), {
-    message: 'Exactly one of project_id or group_id must be provided',
 });
-exports.DeleteVariableSchema = zod_1.z
-    .object({
-    project_id: zod_1.z.coerce.string().optional().describe('Project ID or URL-encoded path'),
-    group_id: zod_1.z.coerce.string().optional().describe('Group ID or URL-encoded path'),
+exports.DeleteVariableSchema = zod_1.z.object({
+    namespacePath: zod_1.z.string().describe('Namespace path (group or project) containing the variable'),
     key: zod_1.z
         .string()
         .describe('The key of the CI/CD variable to delete. This will permanently remove the variable from the project'),
@@ -120,8 +108,5 @@ exports.DeleteVariableSchema = zod_1.z
     })
         .optional()
         .describe('Filter parameters to identify the specific variable to delete'),
-})
-    .refine((data) => Boolean(data.project_id) !== Boolean(data.group_id), {
-    message: 'Exactly one of project_id or group_id must be provided',
 });
 //# sourceMappingURL=schema.js.map

package/dist/entities/variables/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/entities/variables/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/entities/variables/schema.ts"],"names":[],"mappings":"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"}

package/dist/entities/wiki/registry.js

@@ -8,26 +8,25 @@ const zod_to_json_schema_1 = require("zod-to-json-schema");
 const schema_readonly_1 = require("./schema-readonly");
 const schema_1 = require("./schema");
 const fetch_1 = require("../../utils/fetch");
+const namespace_1 = require("../../utils/namespace");
 exports.wikiToolRegistry = new Map([
     [
         'list_wiki_pages',
         {
             name: 'list_wiki_pages',
-            description: 'List wiki pages in a GitLab project or group',
+            description: 'BROWSE: Explore all wiki pages in project or group documentation. Use when: Discovering available guides and documentation, Understanding project knowledge base structure, Finding existing pages before creating new ones. Wiki provides collaborative documentation separate from code repository. Returns page titles, slugs, content formats, and creation dates.',
             inputSchema: (0, zod_to_json_schema_1.zodToJsonSchema)(schema_readonly_1.ListWikiPagesSchema),
             handler: async (args) => {
                 const options = schema_readonly_1.ListWikiPagesSchema.parse(args);
-                const { project_id, group_id } = options;
-                const isProject = !!project_id;
-                const entityType = isProject ? 'projects' : 'groups';
-                const entityId = (isProject ? project_id : group_id);
+                const { namespacePath } = options;
+                const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(namespacePath);
                 const queryParams = new URLSearchParams();
                 Object.entries(options).forEach(([key, value]) => {
-                    if (value !== undefined && value !== null && key !== 'project_id' && key !== 'group_id') {
+                    if (value !== undefined && value !== null && key !== 'namespacePath') {
                         queryParams.set(key, String(value));
                     }
                 });
-                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodeURIComponent(entityId)}/wikis?${queryParams}`;
+                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodedPath}/wikis?${queryParams}`;
                 const response = await (0, fetch_1.enhancedFetch)(apiUrl, {
                     headers: {
                         Authorization: `Bearer ${process.env.GITLAB_TOKEN}`,
@@ -45,25 +44,19 @@ exports.wikiToolRegistry = new Map([
         'get_wiki_page',
         {
             name: 'get_wiki_page',
-            description: 'Get details of a specific wiki page from a project or group',
+            description: 'READ: Get complete wiki page content and metadata by slug. Use when: Reading technical documentation and guides, Accessing project knowledge base content, Getting full markdown with formatting. Returns complete page content, metadata, edit history, and author information. Perfect for content analysis and documentation review.',
             inputSchema: (0, zod_to_json_schema_1.zodToJsonSchema)(schema_readonly_1.GetWikiPageSchema),
             handler: async (args) => {
                 const options = schema_readonly_1.GetWikiPageSchema.parse(args);
-                const { project_id, group_id, slug } = options;
-                const isProject = !!project_id;
-                const entityType = isProject ? 'projects' : 'groups';
-                const entityId = (isProject ? project_id : group_id);
+                const { namespacePath, slug } = options;
+                const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(namespacePath);
                 const queryParams = new URLSearchParams();
                 Object.entries(options).forEach(([key, value]) => {
-                    if (value !== undefined &&
-                        value !== null &&
-                        key !== 'project_id' &&
-                        key !== 'group_id' &&
-                        key !== 'slug') {
+                    if (value !== undefined && value !== null && key !== 'namespacePath' && key !== 'slug') {
                         queryParams.set(key, String(value));
                     }
                 });
-                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodeURIComponent(entityId)}/wikis/${encodeURIComponent(slug)}?${queryParams}`;
+                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodedPath}/wikis/${encodeURIComponent(slug)}?${queryParams}`;
                 const response = await (0, fetch_1.enhancedFetch)(apiUrl, {
                     headers: {
                         Authorization: `Bearer ${process.env.GITLAB_TOKEN}`,
@@ -81,21 +74,19 @@ exports.wikiToolRegistry = new Map([
         'create_wiki_page',
         {
             name: 'create_wiki_page',
-            description: 'Create a new wiki page in a GitLab project or group',
+            description: 'CREATE: Add new documentation page to project or group wiki. Use when: Adding technical documentation, user guides, or FAQs, Creating project knowledge base content, Establishing team documentation standards. Check list_wiki_pages FIRST to avoid duplicate topics. Supports GitLab Flavored Markdown with extensions. Creates version-controlled documentation.',
             inputSchema: (0, zod_to_json_schema_1.zodToJsonSchema)(schema_1.CreateWikiPageSchema),
             handler: async (args) => {
                 const options = schema_1.CreateWikiPageSchema.parse(args);
-                const { project_id, group_id } = options;
-                const isProject = !!project_id;
-                const entityType = isProject ? 'projects' : 'groups';
-                const entityId = (isProject ? project_id : group_id);
+                const { namespacePath } = options;
+                const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(namespacePath);
                 const body = {};
                 Object.entries(options).forEach(([key, value]) => {
-                    if (value !== undefined && value !== null && key !== 'project_id' && key !== 'group_id') {
+                    if (value !== undefined && value !== null && key !== 'namespacePath') {
                         body[key] = value;
                     }
                 });
-                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodeURIComponent(entityId)}/wikis`;
+                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodedPath}/wikis`;
                 const response = await (0, fetch_1.enhancedFetch)(apiUrl, {
                     method: 'POST',
                     headers: {
@@ -116,25 +107,19 @@ exports.wikiToolRegistry = new Map([
         'update_wiki_page',
         {
             name: 'update_wiki_page',
-            description: 'Update an existing wiki page in a GitLab project or group',
+            description: 'UPDATE: Modify existing wiki page content or properties. Use when: Updating documentation with new information, Fixing errors or improving clarity, Reorganizing content structure. Maintains complete version history with change tracking. Supports collaborative editing with author attribution and diff viewing.',
             inputSchema: (0, zod_to_json_schema_1.zodToJsonSchema)(schema_1.UpdateWikiPageSchema),
             handler: async (args) => {
                 const options = schema_1.UpdateWikiPageSchema.parse(args);
-                const { project_id, group_id, slug } = options;
-                const isProject = !!project_id;
-                const entityType = isProject ? 'projects' : 'groups';
-                const entityId = (isProject ? project_id : group_id);
+                const { namespacePath, slug } = options;
+                const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(namespacePath);
                 const body = {};
                 Object.entries(options).forEach(([key, value]) => {
-                    if (value !== undefined &&
-                        value !== null &&
-                        key !== 'project_id' &&
-                        key !== 'group_id' &&
-                        key !== 'slug') {
+                    if (value !== undefined && value !== null && key !== 'namespacePath' && key !== 'slug') {
                         body[key] = value;
                     }
                 });
-                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodeURIComponent(entityId)}/wikis/${encodeURIComponent(slug)}`;
+                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodedPath}/wikis/${encodeURIComponent(slug)}`;
                 const response = await (0, fetch_1.enhancedFetch)(apiUrl, {
                     method: 'PUT',
                     headers: {
@@ -155,15 +140,13 @@ exports.wikiToolRegistry = new Map([
         'delete_wiki_page',
         {
             name: 'delete_wiki_page',
-            description: 'Delete a wiki page from a GitLab project or group',
+            description: 'DELETE: Permanently remove wiki page from documentation. Use when: Cleaning up outdated or obsolete content, Removing duplicate or incorrect pages, Reorganizing wiki structure. WARNING: Deletes page and ALL version history permanently - cannot be undone. Consider archiving important content first.',
             inputSchema: (0, zod_to_json_schema_1.zodToJsonSchema)(schema_1.DeleteWikiPageSchema),
             handler: async (args) => {
                 const options = schema_1.DeleteWikiPageSchema.parse(args);
-                const { project_id, group_id, slug } = options;
-                const isProject = !!project_id;
-                const entityType = isProject ? 'projects' : 'groups';
-                const entityId = (isProject ? project_id : group_id);
-                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodeURIComponent(entityId)}/wikis/${encodeURIComponent(slug)}`;
+                const { namespacePath, slug } = options;
+                const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(namespacePath);
+                const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodedPath}/wikis/${encodeURIComponent(slug)}`;
                 const response = await (0, fetch_1.enhancedFetch)(apiUrl, {
                     method: 'DELETE',
                     headers: {