Add Repository.createWorkspace method, CI workflow, and tests

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: mpociot

.github/workflows/tests.yml

@@ -0,0 +1,33 @@
+name: Tests
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        php: ['8.2', '8.3', '8.4']
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          coverage: none
+
+      - name: Validate composer.json
+        run: composer validate --strict
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-interaction --no-progress
+
+      - name: Run tests
+        run: composer test

README.md

@@ -18,6 +18,12 @@ $polyscope = new Polyscope('your-api-token');
 $servers = $polyscope->servers();
 $repositories = $polyscope->repositories();
 $workspaces = $polyscope->workspaces();
+
+// Create a workspace directly from a repository resource.
+$workspace = $repositories[0]->createWorkspace([
+    'prompt' => 'Fix the login flow',
+    'server_id' => 'srv-1', // optional
+]);
 ```
 
 If no token is passed, the SDK automatically falls back to Polyscope's local settings file and reads `authToken`.

src/Resources/Repository.php

@@ -4,6 +4,8 @@
 
 namespace Polyscope\Laravel\Resources;
 
+use RuntimeException;
+
 class Repository extends Resource
 {
     public ?string $id = null;
@@ -38,4 +40,42 @@ class Repository extends Resource
     public ?string $createdAt = null;
 
     public ?string $serverId = null;
+
+    /**
+     * @param  array<string, mixed>  $data
+     */
+    public function createWorkspace(array $data = []): Workspace
+    {
+        $repositoryId = $this->id();
+
+        if (
+            isset($data['repository_id'])
+            && is_string($data['repository_id'])
+            && $data['repository_id'] !== $repositoryId
+        ) {
+            throw new RuntimeException('The provided repository_id does not match this repository resource.');
+        }
+
+        $data['repository_id'] = $repositoryId;
+
+        return $this->client()->createWorkspace($data);
+    }
+
+    protected function client(): \Polyscope\Laravel\Polyscope
+    {
+        if ($this->polyscope === null) {
+            throw new RuntimeException('No Polyscope client instance available for this resource.');
+        }
+
+        return $this->polyscope;
+    }
+
+    protected function id(): string
+    {
+        if ($this->id === null || $this->id === '') {
+            throw new RuntimeException('Repository ID is missing from resource payload.');
+        }
+
+        return $this->id;
+    }
 }

tests/PolyscopeSDKTest.php

@@ -18,6 +18,7 @@
 use Polyscope\Laravel\Resources\Workspace;
 use Polyscope\Laravel\Resources\WorkspaceDiff;
 use Polyscope\Laravel\Resources\WorkspaceMessages;
+use RuntimeException;
 
 class PolyscopeSDKTest extends TestCase
 {
@@ -205,6 +206,64 @@ public function test_creating_workspace_returns_workspace_resource(): void
         $this->assertSame([], $workspace->linkedWorktreeIds);
     }
 
+    public function test_repository_resource_can_create_workspace_without_manual_repository_id(): void
+    {
+        $sdk = new Polyscope('token', $http = Mockery::mock(Client::class));
+
+        $http->shouldReceive('request')
+            ->once()
+            ->with('POST', 'v1/workspaces', [
+                'timeout' => 30,
+                'json' => [
+                    'prompt' => 'Fix bug',
+                    'server_id' => 'srv-1',
+                    'repository_id' => 'repo-1',
+                ],
+            ])
+            ->andReturn(new Response(201, [], json_encode([
+                'data' => [
+                    'id' => 'wt-1',
+                    'repo_id' => 'repo-1',
+                    'branch' => 'fix-bug',
+                    'status' => 'active',
+                ],
+            ], JSON_THROW_ON_ERROR)));
+
+        $repository = new \Polyscope\Laravel\Resources\Repository([
+            'id' => 'repo-1',
+            'name' => 'polyscope',
+            'path' => '/code/polyscope',
+        ], $sdk);
+
+        $workspace = $repository->createWorkspace([
+            'prompt' => 'Fix bug',
+            'server_id' => 'srv-1',
+        ]);
+
+        $this->assertInstanceOf(Workspace::class, $workspace);
+        $this->assertSame('wt-1', $workspace->id);
+        $this->assertSame('repo-1', $workspace->repoId);
+    }
+
+    public function test_repository_resource_rejects_mismatched_repository_id_when_creating_workspace(): void
+    {
+        $this->expectException(RuntimeException::class);
+        $this->expectExceptionMessage('The provided repository_id does not match this repository resource.');
+
+        $sdk = new Polyscope('token');
+
+        $repository = new \Polyscope\Laravel\Resources\Repository([
+            'id' => 'repo-1',
+            'name' => 'polyscope',
+            'path' => '/code/polyscope',
+        ], $sdk);
+
+        $repository->createWorkspace([
+            'repository_id' => 'repo-2',
+            'prompt' => 'Fix bug',
+        ]);
+    }
+
     public function test_workspace_show_maps_nested_properties(): void
     {
         $sdk = new Polyscope('token', $http = Mockery::mock(Client::class));