Changes 'spo file add' overwrite default. Closes #7100

[waldekmastykarz]

Closes #7100

Changes --overwrite to a flag that defaults to false and updates the command documentation and tests.

[Copilot]

🟡 Changes recommended

The new default “do not overwrite” behavior can still overwrite in edge cases because the upload request uses overwrite=true and relies on a pre-check that can be bypassed by races/transient errors.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

This PR updates the SharePoint spo file add command to make --overwrite a boolean flag that defaults to false, aligning the command behavior with the post-#7099 decision captured in #7100.

Changes:

• Converted --overwrite from an optional boolean value (--overwrite [overwrite]) to a flag (--overwrite) and removed the deprecation warning about a future default change.
• Updated unit tests to reflect the new default behavior (error when a file exists unless --overwrite is specified).
• Updated command documentation to reflect --overwrite as a flag (no explicit true/false values or default shown).

File summaries

File	Description
src/m365/spo/commands/file/file-add.ts	Switches --overwrite to a flag and updates the default flow to treat missing --overwrite as “do not overwrite”.
src/m365/spo/commands/file/file-add.spec.ts	Updates tests to align with the new default behavior and explicit overwrite usage.
docs/docs/cmd/spo/file/file-add.mdx	Updates option docs to represent --overwrite as a flag.

Review details

• Files reviewed: 3/3 changed files
• Comments generated: 1
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.