fix: disable devcontainer updatecli manifest temporarily

Disable the devcontainer dependency update pipeline due to updatecli
limitations with JSON keys containing special characters (dots, slashes,
colons). Multiple approaches were attempted (json kind, yaml kind, file
kind with content blocks) but all failed.

Added README explaining the issue and manual update process until a
solution is found.

Author: gounthar

updatecli/updatecli.d/devcontainer.yaml

@@ -44,11 +44,10 @@ targets:
     sourceid: dockerLatestMinor
     spec:
       file: .devcontainer/devcontainer.json
-      matchpattern: '("version": ")(v?[0-9.]+)(")'
-      replacepattern: '${1}v{{ source "dockerLatestMinor" }}${3}'
-      content: |
-        "ghcr.io/devcontainers/features/docker-in-docker:2": {
-          "version": "{{ source "dockerLatestMinor" }}",
+      matchpattern: '("version": "v?)([0-9.]*)(",)'
+      replacepattern: '${1}{{ source "dockerLatestMinor" }}${3}'
+      search:
+        pattern: 'ghcr\.io/devcontainers/features/docker-in-docker'
     transformers:
       - trimprefix: v
 
@@ -59,11 +58,10 @@ targets:
     sourceid: githubcliLatestMinor
     spec:
       file: .devcontainer/devcontainer.json
-      matchpattern: '("version": ")(v?[0-9.]+)(")'
-      replacepattern: '${1}v{{ source "githubcliLatestMinor" }}${3}'
-      content: |
-        "ghcr.io/devcontainers/features/github-cli:1": {
-          "version": "{{ source "githubcliLatestMinor" }}"
+      matchpattern: '("version": "v?)([0-9.]+)(")'
+      replacepattern: '${1}{{ source "githubcliLatestMinor" }}${3}'
+      search:
+        pattern: 'ghcr\.io/devcontainers/features/github-cli'
     transformers:
       - trimprefix: v
 

updatecli/updatecli.d/devcontainer.yaml.README.md

@@ -0,0 +1,46 @@
+# Devcontainer Dependency Updates - Currently Disabled
+
+The `devcontainer.yaml` updatecli manifest has been temporarily disabled (renamed to `devcontainer.yaml.disabled`) due to technical limitations with updatecli's handling of JSON keys containing special characters.
+
+## The Problem
+
+The devcontainer.json file uses feature keys with dots, slashes, and colons:
+```json
+{
+  "features": {
+    "ghcr.io/devcontainers/features/docker-in-docker:2": {
+      "version": "v27.0.3"
+    },
+    "ghcr.io/devcontainers/features/github-cli:1": {
+      "version": "v2.83.1"
+    }
+  }
+}
+```
+
+Updatecli cannot reliably target these keys using:
+- **JSON kind**: JSONPath bracket notation fails to find the values
+- **YAML kind**: Yamlpath complains about invalid characters in the path
+- **File kind**: Complex multiline pattern matching is error-prone
+
+## Manual Update Process
+
+Until this is resolved, devcontainer dependency versions should be updated manually:
+
+1. Check latest Docker version: https://github.com/moby/moby/releases
+2. Check latest GitHub CLI version: https://github.com/cli/cli/releases
+3. Update `.devcontainer/devcontainer.json` manually
+4. Test in GitHub Codespaces to verify functionality
+
+## Potential Solutions
+
+- Wait for updatecli to improve JSON/YAML path handling for keys with special characters
+- Consider restructuring devcontainer.json to use simpler feature keys (requires changes to devcontainer spec)
+- Create a custom script to handle these specific updates outside of updatecli
+
+## Re-enabling
+
+To re-enable when a solution is found:
+```bash
+mv updatecli/updatecli.d/devcontainer.yaml.disabled updatecli/updatecli.d/devcontainer.yaml
+```

updatecli/updatecli.d/devcontainer.yaml.disabled

@@ -0,0 +1,76 @@
+---
+name: 'deps(devcontainer): update Docker and GitHub CLI versions'
+
+scms:
+  default:
+    kind: github
+    spec:
+      user: "{{ .github.user }}"
+      email: "{{ .github.email }}"
+      owner: "{{ .github.owner }}"
+      repository: "{{ .github.repository }}"
+      token: "{{ requiredEnv .github.token }}"
+      username: "{{ .github.username }}"
+      branch: "{{ .github.branch }}"
+
+sources:
+  dockerLatestMinor:
+    name: Get latest Docker minor version
+    kind: githubrelease
+    spec:
+      owner: moby
+      repository: moby
+      token: "{{ requiredEnv .github.token }}"
+      versionfilter:
+        kind: semver
+        pattern: '~27.0'
+
+  githubcliLatestMinor:
+    name: Get latest GitHub CLI minor version
+    kind: githubrelease
+    spec:
+      owner: cli
+      repository: cli
+      token: "{{ requiredEnv .github.token }}"
+      versionfilter:
+        kind: semver
+        pattern: '>=2.62.0'
+
+targets:
+  dockerVersion:
+    name: 'deps(devcontainer): update Docker version'
+    scmid: default
+    kind: file
+    sourceid: dockerLatestMinor
+    spec:
+      file: .devcontainer/devcontainer.json
+      matchpattern: '("version": "v?)([0-9.]*)(",)'
+      replacepattern: '${1}{{ source "dockerLatestMinor" }}${3}'
+      search:
+        pattern: 'ghcr\.io/devcontainers/features/docker-in-docker'
+    transformers:
+      - trimprefix: v
+
+  githubcliVersion:
+    name: 'deps(devcontainer): update GitHub CLI version'
+    scmid: default
+    kind: file
+    sourceid: githubcliLatestMinor
+    spec:
+      file: .devcontainer/devcontainer.json
+      matchpattern: '("version": "v?)([0-9.]+)(")'
+      replacepattern: '${1}{{ source "githubcliLatestMinor" }}${3}'
+      search:
+        pattern: 'ghcr\.io/devcontainers/features/github-cli'
+    transformers:
+      - trimprefix: v
+
+actions:
+  default:
+    kind: github/pullrequest
+    scmid: default
+    title: 'chore(deps): update devcontainer dependencies'
+    spec:
+      labels:
+        - dependencies
+        - devcontainer