Merge branch 'main' into newline-fix

Author: brooke-hamilton

CHANGELOG.md

@@ -2,6 +2,13 @@
 
 Notable changes.
 
+## April 2026
+
+### [0.86.0]
+- Bump basic-ftp from 5.2.0 to 5.2.2. (https://github.com/devcontainers/cli/pull/1201)
+- Always write devcontainer.metadata label as JSON array. (https://github.com/devcontainers/cli/pull/1199)
+- Normalize drive letter to lowercase on Windows to match VSCode. (https://github.com/devcontainers/cli/pull/1183)
+
 ## March 2026
 
 ### [0.85.0]

package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@devcontainers/cli",
 	"description": "Dev Containers CLI",
-	"version": "0.85.0",
+	"version": "0.86.0",
 	"bin": {
 		"devcontainer": "devcontainer.js"
 	},

src/spec-node/imageMetadata.ts

@@ -497,11 +497,9 @@ export function getDevcontainerMetadataLabel(devContainerMetadata: SubstitutedCo
 	if (!metadata.length) {
 		return '';
 	}
-	const imageMetadataLabelValue = metadata.length !== 1
-		? `[${metadata
-			.map(feature => ` \\\n${toLabelString(feature)}`)
-			.join(',')} \\\n]`
-		: toLabelString(metadata[0]);
+	const imageMetadataLabelValue = `[${metadata
+		.map(feature => ` \\\n${toLabelString(feature)}`)
+		.join(',')} \\\n]`;
 	return `LABEL ${imageMetadataLabel}="${imageMetadataLabelValue}"`;
 }
 

src/test/imageMetadata.test.ts

@@ -432,6 +432,22 @@ describe('Image Metadata', function () {
 			assert.strictEqual(label.replace(/ \\\n/g, ''), `LABEL devcontainer.metadata="${JSON.stringify(expected).replace(/"/g, '\\"')}"`);
 		});
 
+		it('should create array label for single metadata entry (docker-compose with Dockerfile, no features)', () => {
+			// When there is only one metadata entry, the label should still be a JSON array.
+			// Regression test for https://github.com/devcontainers/cli/issues/1054
+			const label = getDevcontainerMetadataLabel(configWithRaw([
+				{
+					remoteUser: 'testUser',
+				}
+			]));
+			const expected = [
+				{
+					remoteUser: 'testUser',
+				}
+			];
+			assert.strictEqual(label.replace(/ \\\n/g, ''), `LABEL devcontainer.metadata="${JSON.stringify(expected).replace(/"/g, '\\"')}"`);
+		});
+
 		it('should merge metadata from devcontainer.json and features', () => {
 			const merged = mergeConfiguration({
 				configFilePath: URI.parse('file:///devcontainer.json'),

yarn.lock

@@ -639,9 +639,9 @@ base64-js@^1.3.1:
   integrity sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==
 
 basic-ftp@^5.0.2:
-  version "5.2.0"
-  resolved "https://registry.yarnpkg.com/basic-ftp/-/basic-ftp-5.2.0.tgz#7c2dff63c918bde60e6bad1f2ff93dcf5137a40a"
-  integrity sha512-VoMINM2rqJwJgfdHq6RiUudKt2BV+FY5ZFezP/ypmwayk68+NzzAQy4XXLlqsGD4MCzq3DrmNFD/uUmBJuGoXw==
+  version "5.2.2"
+  resolved "https://registry.yarnpkg.com/basic-ftp/-/basic-ftp-5.2.2.tgz#4cb2422deddf432896bdb3c9b8f13b944ad4842c"
+  integrity sha512-1tDrzKsdCg70WGvbFss/ulVAxupNauGnOlgpyjKzeQxzyllBLS0CGLV7tjIXTK3ZQA9/FBEm9qyFFN1bciA6pw==
 
 bl@^5.0.0:
   version "5.1.0"