On branch edburns/dd-2785864-pre-public-non-code-changes

new file:   .github/workflows/publish-snapshot.yml

- New workflow, to publish `-SNAPSHOT` build.

modified:   .vscode/settings.json

- Always reload.

modified:   README.md

- Document `-SNAPSHOT` build.

modified:   pom.xml

- Use correct `artifactId`.

- Add `<distributionManagement />` section.

Author: edburns

.github/workflows/publish-snapshot.yml

@@ -0,0 +1,54 @@
+name: Publish Snapshot to GitHub Packages
+
+env:
+    HUSKY: 0
+
+on:
+    workflow_dispatch:
+
+permissions:
+    contents: read
+    packages: write
+
+concurrency:
+    group: publish-snapshot
+    cancel-in-progress: false
+
+jobs:
+    publish-snapshot:
+        name: Publish SNAPSHOT to GitHub Packages
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v6
+              with:
+                  fetch-depth: 0
+
+            - uses: ./.github/actions/setup-copilot
+
+            - name: Set up JDK 17
+              uses: actions/setup-java@v5
+              with:
+                  java-version: "17"
+                  distribution: "temurin"
+                  cache: "maven"
+                  server-id: github
+                  server-username: PACKAGES_USERNAME
+                  server-password: PACKAGES_TOKEN
+
+            - name: Verify version is a SNAPSHOT
+              run: |
+                  VERSION=$(mvn help:evaluate -Dexpression=project.version -q -DforceStdout)
+                  echo "Publishing version: $VERSION"
+                  if [[ "$VERSION" != *"-SNAPSHOT" ]]; then
+                    echo "ERROR: This workflow only publishes SNAPSHOT versions. Current version: $VERSION"
+                    exit 1
+                  fi
+                  echo "### Snapshot Publish" >> $GITHUB_STEP_SUMMARY
+                  echo "- **Version:** $VERSION" >> $GITHUB_STEP_SUMMARY
+                  echo "- **Repository:** GitHub Packages (github/copilot-sdk-java)" >> $GITHUB_STEP_SUMMARY
+
+            - name: Deploy Snapshot
+              run: mvn -B deploy -DskipTests
+              env:
+                  PACKAGES_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+                  PACKAGES_USERNAME: ${{ github.actor }}

.vscode/settings.json

@@ -6,5 +6,6 @@
             "-Dcopilot.tests.dir=${workspaceFolder}/target/copilot-sdk/test"
         ]
     },
-    "java.compile.nullAnalysis.mode": "automatic"
+    "java.compile.nullAnalysis.mode": "automatic",
+    "java.configuration.updateBuildConfiguration": "automatic"
 }

README.md

@@ -37,6 +37,40 @@ Java SDK for programmatic control of GitHub Copilot CLI, enabling you to build A
 </dependency>
 ```
 
+#### Snapshot Builds
+
+Snapshot builds of the next development version are published to GitHub Packages. To use them, add the repository and update the dependency version in your `pom.xml`:
+
+```xml
+<repositories>
+    <repository>
+        <id>github</id>
+        <url>https://maven.pkg.github.com/github/copilot-sdk-java</url>
+        <snapshots><enabled>true</enabled></snapshots>
+    </repository>
+</repositories>
+
+<dependency>
+    <groupId>com.github</groupId>
+    <artifactId>copilot-sdk</artifactId>
+    <version>0.1.30-SNAPSHOT</version>
+</dependency>
+```
+
+GitHub Packages requires authentication even for public packages. Add your credentials to `~/.m2/settings.xml`:
+
+```xml
+<settings>
+    <servers>
+        <server>
+            <id>github</id>
+            <username>YOUR_GITHUB_USERNAME</username>
+            <password>YOUR_GITHUB_TOKEN</password><!-- needs read:packages scope -->
+        </server>
+    </servers>
+</settings>
+```
+
 ### Gradle
 
 ```groovy

pom.xml

@@ -6,7 +6,7 @@
     <modelVersion>4.0.0</modelVersion>
 
     <groupId>com.github</groupId>
-    <artifactId>copilot-sdk</artifactId>
+    <artifactId>copilot-sdk-java</artifactId>
     <version>0.1.30-SNAPSHOT</version>
     <packaging>jar</packaging>
 
@@ -36,6 +36,13 @@
         <tag>HEAD</tag>
     </scm>
 
+    <distributionManagement>
+        <snapshotRepository>
+            <id>github</id>
+            <url>https://maven.pkg.github.com/github/copilot-sdk-java</url>
+        </snapshotRepository>
+    </distributionManagement>
+
     <properties>
         <maven.compiler.release>17</maven.compiler.release>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>