env_project_clear

Instructions

Implementation Reference

• src/tools/environment.ts:427-458 (handler)

  The handler function for 'env_project_clear' tool. It calls storage.clearProjectEnvironment(project) and returns appropriate success/error messages.

    async (params) => {
      try {
        const removed = await storage.clearProjectEnvironment(params.project)
  
        if (!removed) {
          return {
            content: [
              {
                type: 'text' as const,
                text: `No hay entorno específico para el proyecto '${params.project}'`,
              },
            ],
          }
        }
  
        return {
          content: [
            {
              type: 'text' as const,
              text: `Entorno específico eliminado para proyecto '${params.project}'. Usará el entorno global.`,
            },
          ],
        }
      } catch (error) {
        const message = error instanceof Error ? error.message : String(error)
        return {
          content: [{ type: 'text' as const, text: `Error: ${message}` }],
          isError: true,
        }
      }
    },
  )

• src/tools/environment.ts:422-426 (schema)

  Input schema for 'env_project_clear': a single required string parameter 'project' describing the project path.

  {
    project: z
      .string()
      .describe('Ruta del proyecto del que eliminar la asociación'),
  },

• src/tools/environment.ts:419-458 (registration)

  Registration of the 'env_project_clear' tool using server.tool() with name, description, schema, and handler.

  server.tool(
    'env_project_clear',
    'Elimina la asociación de entorno específico de un proyecto. El proyecto no tendrá entorno activo hasta que se asigne uno.',
    {
      project: z
        .string()
        .describe('Ruta del proyecto del que eliminar la asociación'),
    },
    async (params) => {
      try {
        const removed = await storage.clearProjectEnvironment(params.project)
  
        if (!removed) {
          return {
            content: [
              {
                type: 'text' as const,
                text: `No hay entorno específico para el proyecto '${params.project}'`,
              },
            ],
          }
        }
  
        return {
          content: [
            {
              type: 'text' as const,
              text: `Entorno específico eliminado para proyecto '${params.project}'. Usará el entorno global.`,
            },
          ],
        }
      } catch (error) {
        const message = error instanceof Error ? error.message : String(error)
        return {
          content: [{ type: 'text' as const, text: `Error: ${message}` }],
          isError: true,
        }
      }
    },
  )

• src/lib/storage.ts:213-227 (helper)

  The helper/storage method clearProjectEnvironment() that deletes the project-environment association from the project environments file.

  async clearProjectEnvironment(project: string): Promise<boolean> {
    const projectEnvs = await this.getProjectEnvs()
    const normalized = project.replace(/\\/g, '/')
    // Try exact match first, then normalized match
    let found = false
    for (const key of Object.keys(projectEnvs)) {
      if (key === project || key.replace(/\\/g, '/') === normalized) {
        delete projectEnvs[key]
        found = true
      }
    }
    if (!found) return false
    await this.writeJson(this.projectEnvsFile, projectEnvs)
    return true
  }