refactor(cli)!: harmonize provider verbs and add rm/mv aliases

[skevetter]

Summary

Hard-cut breaking change to the devsy CLI verb surface:

• devsy provider configure → devsy provider init
• devsy provider update → devsy provider set-source
• Added rm as an alias for delete on workspace, context, machine, provider, pro provider, and agent workspace
• Added mv as an alias for rename on workspace and provider

No deprecation shims — old verbs are removed entirely. Desktop IPC, E2E framework, in-tree Go callers, and markdown docs all updated to the new verbs.

Why

configure was a false friend — most CLIs use it for "set my preferences," but here it meant "re-init." update was misleading — sounded like "fetch newer version" but actually swapped the source URL. The other provider verbs (get, set, list, use) already matched context / ide exactly; this brings the remaining two outliers in line.

ls was already aliased on every list command — rm and mv close the analogous gaps.

Summary by CodeRabbit

• New Features

  • Added rm alias for workspace, context, machine, and provider delete commands.
  • Added mv alias for workspace and provider rename commands.
  • Introduced provider set-source command for updating provider sources and pinning to specific versions.

• Documentation

  • Updated provider management guides to reflect new command structure and workflows.

[netlify]

✅ Deploy Preview for devsydev canceled.

Name	Link
🔨 Latest commit	1572eef
🔍 Latest deploy log	https://app.netlify.com/projects/devsydev/deploys/6a1c54b3fc18dc0008dae10e

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 9cd88052-cda1-4f49-8579-56d94eeff27b

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• ✅ Review completed - (🔄 Check again to review again)

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)

docs/pages/managing-providers/add-provider.mdx (1)

112-112: ⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Update descriptive text to match the new command name.

The text mentions "during the configure or add phase" but the command has been renamed to init. Update the wording for consistency.

📝 Proposed fix

-Options for providers can be set during the `configure` or `add` phase:
+Options for providers can be set during the `init` or `add` phase:

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/pages/managing-providers/add-provider.mdx` at line 112, Update the
descriptive sentence that currently reads "Options for providers can be set
during the `configure` or `add` phase" to reflect the new command name by
replacing `add` with `init` (so it reads "Options for providers can be set
during the `configure` or `init` phase"); ensure the inline code backticks
around `configure` and `init` are preserved and update any nearby mentions in
the same paragraph if present to keep wording consistent with the renamed
command.

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@cmd/provider/set_source.go`:
- Around line 77-87: The call to ConfigureProvider in set-source.go is missing
Reconfigure: true so ConfigureProvider will merge prior user options (via
mergeExistingOptions) into the new source/schema; update the
ProviderOptionsConfig passed to ConfigureProvider to include Reconfigure: true
(and explicitly set other default fields as needed) so the provider option
resolution behaves like provider add/update-provider and does not carry stale
values; locate the ConfigureProvider invocation in set-source.go and modify the
ProviderOptionsConfig struct to include Reconfigure: true.

---

Outside diff comments:
In `@docs/pages/managing-providers/add-provider.mdx`:
- Line 112: Update the descriptive sentence that currently reads "Options for
providers can be set during the `configure` or `add` phase" to reflect the new
command name by replacing `add` with `init` (so it reads "Options for providers
can be set during the `configure` or `init` phase"); ensure the inline code
backticks around `configure` and `init` are preserved and update any nearby
mentions in the same paragraph if present to keep wording consistent with the
renamed command.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 474450c1-c273-4d8b-bca7-fa1e9cf33b28

📥 Commits

Reviewing files that changed from the base of the PR and between a25c609 and 1572eef.

📒 Files selected for processing (26)

• cmd/agent/workspace/delete.go
• cmd/context/delete.go
• cmd/machine/delete.go
• cmd/pro/provider/delete.go
• cmd/provider/add.go
• cmd/provider/delete.go
• cmd/provider/delete_test.go
• cmd/provider/init.go
• cmd/provider/init_test.go
• cmd/provider/provider.go
• cmd/provider/rename.go
• cmd/provider/set_source.go
• cmd/provider/set_source_test.go
• cmd/provider/update.go
• cmd/workspace/delete.go
• cmd/workspace/rename.go
• desktop/src/main/ipc.ts
• docs/pages/managing-providers/add-provider.mdx
• docs/pages/managing-providers/set-source.mdx
• docs/pages/managing-providers/what-are-providers.mdx
• docs/sidebars.js
• e2e/framework/command.go
• e2e/tests/provider/provider.go
• examples/ztunnel/README.md
• pkg/provider/provider.go
• pkg/workspace/workspace.go

💤 Files with no reviewable changes (1)

• cmd/provider/update.go

[coderabbitai]

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Recover the removed update.go from git history and inspect its ConfigureProvider call.
del=$(git rev-list -n1 HEAD -- cmd/provider/update.go)
if [ -n "$del" ]; then
  echo "Last commit touching update.go: $del"
  echo "===== content prior to deletion ====="
  git show "${del}^:cmd/provider/update.go" 2>/dev/null | sed -n '1,200p'
else
  echo "No git history found for cmd/provider/update.go"
fi

Repository: devsy-org/devsy

Length of output: 107

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== Check whether cmd/provider/update.go exists =="
ls -la cmd/provider | sed -n '1,200p' || true
test -f cmd/provider/update.go && echo "FOUND: cmd/provider/update.go" || echo "MISSING: cmd/provider/update.go"

echo
echo "== Find all ConfigureProvider calls in cmd/provider =="
rg -n "ConfigureProvider\\(" cmd/provider -S || true

echo
echo "== Search for Reconfigure: true / SkipRequired / SkipInit / SkipSubOptions / SingleMachine usage =="
rg -n "Reconfigure\\s*:\\s*true|SkipRequired|SkipInit|SkipSubOptions|SingleMachine" cmd/provider -S || true

echo
echo "== Search for 'provider update' command wiring =="
rg -n "provider\\s+update|update\\b" cmd/provider -S || true

echo
echo "== Inspect cmd/provider/set_source.go around ConfigureProvider call =="
sed -n '1,140p' cmd/provider/set_source.go || true

Repository: devsy-org/devsy

Length of output: 7111

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== Inspect cmd/provider/configure_shared.go =="
sed -n '1,220p' cmd/provider/configure_shared.go

echo
echo "== Inspect cmd/provider/add.go around ConfigureProvider call =="
sed -n '90,170p' cmd/provider/add.go

echo
echo "== Inspect cmd/provider/init.go around ConfigureProvider call =="
sed -n '1,130p' cmd/provider/init.go

echo
echo "== Inspect cmd/provider/set_source_test.go to see expected behavior =="
sed -n '1,220p' cmd/provider/set_source_test.go

Repository: devsy-org/devsy

Length of output: 10191

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== Search for workspace.UpdateProvider usage =="
rg -n "workspace\.UpdateProvider" -S . || true

echo
echo "== Search for ConfigureProvider calls with Reconfigure flags =="
rg -n "ConfigureProvider\\(ctx, ProviderOptionsConfig\\{" cmd/provider -S || true
rg -n "Reconfigure\\s*:\\s*(true|false)" cmd/provider -S || true

echo
echo "== Search for 'update' command wiring in cmd/provider =="
rg -n "\\bprovider\\s+update\\b|\\bUpdateCmd\\b|Use:\\s*\"update\"" cmd/provider -S || true

echo
echo "== Inspect cmd/provider/set.go for related reconfigure logic =="
sed -n '1,220p' cmd/provider/set.go

echo
echo "== Inspect cmd/provider/provider.go for command registration =="
sed -n '1,240p' cmd/provider/provider.go

Repository: devsy-org/devsy

Length of output: 5179

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== Inspect cmd/pro/update_provider.go =="
sed -n '1,220p' cmd/pro/update_provider.go

echo
echo "== Inspect workspace.UpdateProvider implementation =="
rg -n "func UpdateProvider\\(" -S ./pkg ./cmd || true
fd -e go UpdateProvider -a ./pkg ./cmd | head -n 20 || true

# Print the exact file that contains the function, if found
f=$(rg -l "func UpdateProvider\\(" -S ./pkg ./cmd | head -n 1 || true)
if [ -n "${f}" ]; then
  echo
  echo "== File: $f =="
  sed -n '1,260p' "$f"
fi

Repository: devsy-org/devsy

Length of output: 9187

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== Search for any provider command named update =="
rg -n 'Use:\s*"update' cmd/provider -S || true

echo
echo "== Search for ConfigureProvider calls in cmd/provider excluding set_source.go/add.go =="
rg -n "ConfigureProvider\\(ctx, ProviderOptionsConfig\\{" cmd/provider -S || true

echo
echo "== Search for 'Update' in cmd/provider file names =="
ls -ლა cmd/provider | sed -n '1,200p'

echo
echo "== Search for 'reconfigure' flag wiring in cmd/provider =="
rg -n 'reconfigure' cmd/provider -S || true

Repository: devsy-org/devsy

Length of output: 510

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== Locate ResolveOptions implementation =="
rg -n "func ResolveOptions\\(" -S pkg | head -n 20

f=$(rg -l "func ResolveOptions\\(" pkg | head -n 1 || true)
if [ -n "$f" ]; then
  echo
  echo "== File: $f =="
  sed -n '1,260p' "$f"
fi

echo
echo "== Search how resolve options handles unknown keys / required options =="
rg -n "unknown|not provided|required|SkipRequired|SkipSubOptions" -S "$f" || true

Repository: devsy-org/devsy

Length of output: 7492

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== Inspect cmd/provider/set_source_test.go =="
sed -n '1,260p' cmd/provider/set_source_test.go

echo
echo "== Search for set-source usage in tests =="
rg -n "set-source" -S . || true

echo
echo "== Search for provider init --reconfigure references =="
rg -n "init .*--reconfigure|--reconfigure.*provider init|provider init.*--reconfigure" -S . || true

Repository: devsy-org/devsy

Length of output: 2110

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== Inspect docs for provider set-source =="
sed -n '1,120p' docs/pages/managing-providers/set-source.mdx

echo
echo "== Inspect resolver behavior for unknown/extra options =="
rg -n "unknown option|not provided|not defined|extra option|unrecognized|skip.*unknown" pkg/options -S || true

echo
echo "== Locate resolver.New and its handling of input option keys =="
rg -n "func New\\(" pkg/options/resolver -S || true

f=$(rg -l "package resolver" pkg/options/resolver | head -n 1 || true)
echo "resolver dir sample file: $f"

# Print key resolver files (small-ish)
ls pkg/options/resolver 2>/dev/null | head -n 50 || true
for f in $(ls pkg/options/resolver 2>/dev/null | head -n 20); do
  echo "---- pkg/options/resolver/$f ----"
  sed -n '1,220p' "pkg/options/resolver/$f" | head -n 220
done

Repository: devsy-org/devsy

Length of output: 28043

---

set-source should likely pass Reconfigure: true after swapping provider source

cmd/provider/set_source.go calls ConfigureProvider without Reconfigure, so configure_shared.go will merge existing user-provided option values into the new option resolution (mergeExistingOptions when !cfg.Reconfigure). This differs from provider add (sets Reconfigure: true) and pro update-provider (also sets Reconfigure: true). Consider setting Reconfigure: true (and explicitly setting other defaults for clarity) to avoid carrying stale user-provided option values across source/schema changes.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@cmd/provider/set_source.go` around lines 77 - 87, The call to
ConfigureProvider in set-source.go is missing Reconfigure: true so
ConfigureProvider will merge prior user options (via mergeExistingOptions) into
the new source/schema; update the ProviderOptionsConfig passed to
ConfigureProvider to include Reconfigure: true (and explicitly set other default
fields as needed) so the provider option resolution behaves like provider
add/update-provider and does not carry stale values; locate the
ConfigureProvider invocation in set-source.go and modify the
ProviderOptionsConfig struct to include Reconfigure: true.