Add CLI project host setup clone command

Co-authored-by: Orca <help@stably.ai>

src/cli/handlers/project.ts

@@ -1,6 +1,7 @@
 import type {
   Project,
   ProjectHostSetup,
+  ProjectHostSetupCloneArgs,
   ProjectHostSetupCreateArgs,
   ProjectHostSetupCreateResult,
   ProjectHostSetupDeleteResult,
@@ -66,6 +67,26 @@ export const PROJECT_HANDLERS: Record<string, CommandHandler> = {
     )
     printResult(result, json, formatProjectHostSetupResult)
   },
+  'project setup-clone': async ({ flags, client, cwd, json }) => {
+    const rawDestination = getRequiredStringFlag(flags, 'destination')
+    const args: ProjectHostSetupCloneArgs = {
+      projectId: getRequiredStringFlag(flags, 'project'),
+      hostId: getRequiredStringFlag(flags, 'host') as ProjectHostSetupCloneArgs['hostId'],
+      url: getRequiredStringFlag(flags, 'url'),
+      destination: resolveRepoPathArgument(
+        rawDestination,
+        cwd,
+        client.isRemote,
+        'Project setup clone'
+      ),
+      displayName: getOptionalStringFlag(flags, 'display-name')
+    }
+    const result = await client.call<{ result: ProjectHostSetupResult }>(
+      'projectHostSetup.clone',
+      args
+    )
+    printResult(result, json, formatProjectHostSetupResult)
+  },
   'project setup-create': async ({ flags, client, cwd, json }) => {
     const path = getOptionalStringFlag(flags, 'path')
     const args: ProjectHostSetupCreateArgs = {

src/cli/help.ts

@@ -33,6 +33,7 @@ Projects:
   project list              List durable projects known to Orca
   project setups            List project host setups
   project setup-existing-folder Make a project available on a host by importing an existing folder
+  project setup-clone       Make a project available on a host by cloning a repository
   project setup-create      Create independent project host setup metadata
   project setup-update      Update project host setup metadata
   project setup-delete      Remove a project host setup
@@ -212,6 +213,7 @@ Common Commands:
   orca project list [--json]
   orca project setups [--project <id>] [--host <host-id>] [--json]
   orca project setup-existing-folder --project <id> --host <host-id> --path <path> [--kind git|folder] [--display-name <name>] [--json]
+  orca project setup-clone --project <id> --host <host-id> --url <clone-url> --destination <path> [--display-name <name>] [--json]
   orca project setup-create --project <id> --host <host-id> [--setup-id <id>] [--path <path>] [--kind git|folder] [--display-name <name>] [--worktree-base-path <path>] [--git-username <name>] [--state ready|not-set-up|setting-up|error|unsupported] [--method imported-existing-folder|cloned|provisioned] [--json]
   orca project setup-update --setup <setup-id> [--display-name <name>] [--path <path>] [--worktree-base-path <path>] [--git-username <name>] [--kind git|folder] [--state ready|not-set-up|setting-up|error|unsupported] [--method legacy-repo|imported-existing-folder|cloned|provisioned] [--json]
   orca project setup-delete --setup <setup-id> [--json]

src/cli/specs/project.ts

@@ -33,6 +33,21 @@ export const PROJECT_COMMAND_SPECS: CommandSpec[] = [
       'orca project setup-existing-folder --project github:stablyai/orca --host runtime:gpu --path /home/me/orca --kind git --json'
     ]
   },
+  {
+    path: ['project', 'setup-clone'],
+    summary: 'Make a project available on a host by cloning a repository',
+    usage:
+      'orca project setup-clone --project <id> --host <host-id> --url <clone-url> --destination <path> [--display-name <name>] [--json]',
+    allowedFlags: [...GLOBAL_FLAGS, 'project', 'host', 'url', 'destination', 'display-name'],
+    notes: [
+      'For remote runtimes, --destination must be an absolute parent directory on the remote server.',
+      'SSH targets are cloned through the desktop UI because the desktop client owns SSH connections.'
+    ],
+    examples: [
+      'orca project setup-clone --project github:stablyai/orca --host local --url https://github.com/stablyai/orca.git --destination ~/src',
+      'orca project setup-clone --project github:stablyai/orca --host runtime:gpu --url https://github.com/stablyai/orca.git --destination /srv --json'
+    ]
+  },
   {
     path: ['project', 'setup-create'],
     summary: 'Create independent project host setup metadata',