Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

tool sf-deploy-metadata does not provides details

Open
#5 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
35/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Stale
Domain
cli, devops

Research direction

Start by tracing the sf-deploy-metadata tool and its use of sf project deploy start. Check where failed deployment output is reduced to a conflict count, then verify that the tool result exposes enough deployment details for an agent to identify missing metadata.

Written by the indexing model from the issue text.

Description

Hi, when agent runs the sf-deploy-metadata tool, and the deployment fails, it does not provide detailed information about the issue, just how many conflicts occured.

**Tool Results: sf-deploy-metadata-86**

Failed to deploy metadata: 6 conflicts detected

The output of sf project deploy start should be routed to the tool result such that the agent can react. For example, I want the agent to deploy the project, which I know have some issues related to missing metadata, those can be easily resolved by deploying the missing metadata, but for this to work the agent needs to know what metadata is missing.

Whole agent thread:

xx Dev Deployment and MCP Recovery

User

deploy this salesforce project to xx-dev. if deployment fails, deploy indidividual files in order to fix the deployment, use mcp server where possible

Agent

Use Tool: sf-get-username (sf-get-username-85)

{
  "directory": "/Users/adam/IdeaProjects/salesforce",
  "defaultTargetOrg": false
}

Tool Results: sf-get-username-85

YOU MUST inform the user that we are going to use "[email protected]" (Alias: xx-dev) for the "usernameOrAlias" parameter.
YOU MUST explain the reasoning for selecting this org, which is: "it is the default (Local) target org"
UNLESS THE USER SPECIFIES OTHERWISE, use this username for the "usernameOrAlias" parameter in future Tool calls.

Agent

I will deploy your Salesforce project to the xx-dev org using [email protected].

Use Tool: sf-deploy-metadata (sf-deploy-metadata-86)

{
  "usernameOrAlias": "xx-dev",
  "apexTestLevel": "NoTestRun",
  "directory": "/Users/adam/IdeaProjects/salesforce"
}

Tool Results: sf-deploy-metadata-86

Failed to deploy metadata: 6 conflicts detected

Agent

The deployment to xx-dev failed with 6 conflicts. Unfortunately, the sf-deploy-metadata tool doesn't provide specific details about which files caused the conflicts directly in its output.

To address this, I will try to find all Salesforce metadata files in your project and then attempt to deploy them individually. I will start by finding all files within the /Users/adam/IdeaProjects/salesforce directory.

Dominant language
No language data
Stars
1
Forks
1
PR merge metrics
No merged PRs in 30d

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from forcedotcom/mcp

All issues in forcedotcom/mcp

Similar issues

More CLI issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.