fix(cli): guide deprecated global start

Signed-off-by: Deepak Jain <deepujain@gmail.com>

Author: deepujain

docs/manage-sandboxes/run-sandboxes.mdx

@@ -158,7 +158,8 @@ $$nemoclaw tunnel start
 ```
 
 `$$nemoclaw tunnel stop` stops the tunnel and asks NemoClaw to stop the in-sandbox gateway for the selected or default sandbox.
-The older `$$nemoclaw start` still works as a deprecated alias.
+The older `$$nemoclaw start` now prints migration guidance and exits successfully without starting
+a sandbox or tunnel. Use `$$nemoclaw <name> start` or `$$nemoclaw tunnel start` explicitly.
 </AgentOnly>
 <AgentOnly variant="hermes">
 

docs/reference/commands.mdx

@@ -3950,7 +3950,9 @@ export CLOUDFLARE_TUNNEL_TOKEN=<cloudflare-tunnel-token>
 $$nemoclaw tunnel start
 ```
 
-`$$nemoclaw start` remains as a deprecated alias that prints a warning and delegates to `tunnel start`.
+`$$nemoclaw start` remains as a deprecated compatibility command. It exits successfully after
+printing guidance for `$$nemoclaw <name> start` and `$$nemoclaw tunnel start`; it does not start
+either resource itself.
 
 ### `$$nemoclaw tunnel stop`
 
@@ -3985,10 +3987,12 @@ $$nemoclaw tunnel status
 ### `$$nemoclaw start`
 
 <Warning>
-Deprecated. Use `$$nemoclaw tunnel start` instead.
+Deprecated. Use `$$nemoclaw <name> start` for a stopped sandbox or `$$nemoclaw tunnel start` for
+the optional public-URL tunnel.
 </Warning>
 
-This command remains as a compatibility alias to `$$nemoclaw tunnel start`.
+This compatibility command prints migration guidance and exits successfully without changing
+sandbox or tunnel state.
 
 ### `$$nemoclaw stop`
 

src/commands/simple-global-oclif-adapters.test.ts

@@ -293,7 +293,7 @@ describe("simple global oclif adapters", () => {
     await DeprecatedStartCommand.run([], rootDir);
     await DeprecatedStopCommand.run([], rootDir);
 
-    expect(mocks.runStartCommand).toHaveBeenCalledTimes(2);
+    expect(mocks.runStartCommand).toHaveBeenCalledTimes(1);
     expect(mocks.runStopCommand).toHaveBeenCalledTimes(2);
     expect(mocks.runStartCommand).toHaveBeenCalledWith(
       expect.objectContaining({ listSandboxes: expect.any(Function), startAll: mocks.startAll }),

src/commands/start.ts

@@ -2,9 +2,9 @@
 // SPDX-License-Identifier: Apache-2.0
 
 import { NemoClawCommand } from "../lib/cli/nemoclaw-oclif-command";
-import { serviceDeps } from "../lib/tunnel/command-support";
-import { runStartCommand } from "../lib/tunnel/service-command";
-import { startAll } from "../lib/tunnel/services";
+
+const DEPRECATED_START_MESSAGE =
+  "Deprecated: 'nemoclaw start' no longer starts a resource. Use 'nemoclaw <name> start' for a stopped sandbox or 'nemoclaw tunnel start' for the optional public-URL tunnel.";
 
 export default class DeprecatedStartCommand extends NemoClawCommand {
   static id = "start";
@@ -15,13 +15,11 @@ export default class DeprecatedStartCommand extends NemoClawCommand {
   static examples = ["<%= config.bin %> start"];
   static state = "deprecated" as const;
   static deprecationOptions = {
-    message:
-      "Deprecated: 'nemoclaw start' is now 'nemoclaw tunnel start'. To start a stopped sandbox container instead, use 'nemoclaw <name> start'. See 'nemoclaw help'.",
+    message: DEPRECATED_START_MESSAGE,
   };
   static flags = {};
 
   public async run(): Promise<void> {
     await this.parse(DeprecatedStartCommand);
-    await runStartCommand({ ...serviceDeps(), startAll });
   }
 }

test/cli/tunnel-command.test.ts

@@ -37,6 +37,13 @@ describe("tunnel CLI dispatch", () => {
     expect(r.out).toContain("Deprecated alias");
   });
 
+  it("deprecated start exits 0 with sandbox-scoped migration guidance (#9303)", () => {
+    const r = run("start 2>&1");
+    expect(r.code).toBe(0);
+    expect(r.out).toContain("nemoclaw <name> start");
+    expect(r.out).toContain("nemoclaw tunnel start");
+  });
+
   it("tunnel stop --help exits 0 and shows tunnel usage", () => {
     const r = run("tunnel stop --help");
     expect(r.code).toBe(0);