[codex] Prepare v0.1.5 release

.github/workflows/release.yml

@@ -24,6 +24,8 @@ jobs:
           go-version-file: go.mod
           cache-dependency-path: go.sum
 
+      - uses: azure/setup-helm@v4
+
       - name: Test
         run: go test -p 1 ./...
 
@@ -53,7 +55,7 @@ jobs:
                 -ldflags="-s -w" \
                 -o "${work}/${cmd}${ext}" "./cmd/${cmd}"
             done
-            cp README.md README.zh-CN.md QUICKSTART.md AI_CONTRACT.md LICENSE "${work}/"
+            cp README.md README.zh-CN.md QUICKSTART.md CHANGELOG.md AI_CONTRACT.md LICENSE "${work}/"
             mkdir -p "${work}/docs"
             cp -R docs/assets "${work}/docs/"
             mkdir -p "${work}/local"
@@ -65,6 +67,7 @@ jobs:
             fi
             rm -rf "${work}"
           done
+          helm package charts/kubernetes-ontology --destination dist
           (cd dist && sha256sum * > checksums.txt)
 
       - name: Create GitHub release

CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+## v0.1.5 - 2026-04-29
+
+### Added
+
+- Added bounded diagnostic response metadata for AI-agent consumers:
+  `partial`, `warnings`, `budgets`, `rankedEvidence`, `degradedSources`, and
+  `conflicts`.
+- Added Helm provenance modeling from standard Helm labels and annotations,
+  including `HelmRelease`, `HelmChart`, `managed_by_helm_release`, and
+  `installs_chart`.
+- Added viewer rendering support for diagnostic warnings, budget status,
+  evidence ranking, degraded sources, conflicts, and Helm provenance nodes.
+- Expanded the Kubernetes ontology OWL schema and access skill guidance for the
+  new diagnostic and Helm graph contract.
+
+### Changed
+
+- Refreshed installation examples, Helm chart metadata, and release guide
+  examples for `v0.1.5`.
+
+### Validation
+
+- Local CI, visualization checks, and live Kubernetes diagnostic checks are run
+  against a disposable kind cluster with an explicit kubeconfig.
+
+## v0.1.4 - 2026-04-28
+
+- Published release binaries and GHCR images for the open-source MVP.

QUICKSTART.md

@@ -62,7 +62,7 @@ the CLI at that local server.
 Set the version and choose the release archive for your machine:
 
 ```bash
-export KO_VERSION=v0.1.4
+export KO_VERSION=v0.1.5
 curl -LO "https://github.com/Colvin-Y/kubernetes-ontology/releases/download/${KO_VERSION}/kubernetes-ontology_${KO_VERSION}_linux_amd64.tar.gz"
 tar -xzf "kubernetes-ontology_${KO_VERSION}_linux_amd64.tar.gz"
 cd "kubernetes-ontology_${KO_VERSION}_linux_amd64"
@@ -145,7 +145,7 @@ path above.
 Set the version and image namespace you want to use:
 
 ```bash
-export KO_VERSION=v0.1.4
+export KO_VERSION=v0.1.5
 export KO_IMAGE=ghcr.io/colvin-y/kubernetes-ontology
 ```
 

README.md

@@ -191,7 +191,7 @@ the published GHCR image. The release archive includes the server
 viewer `kubernetes-ontology-viewer`.
 
 ```bash
-export KO_VERSION=v0.1.4
+export KO_VERSION=v0.1.5
 curl -LO "https://github.com/Colvin-Y/kubernetes-ontology/releases/download/${KO_VERSION}/kubernetes-ontology_${KO_VERSION}_linux_amd64.tar.gz"
 tar -xzf "kubernetes-ontology_${KO_VERSION}_linux_amd64.tar.gz"
 cd "kubernetes-ontology_${KO_VERSION}_linux_amd64"
@@ -235,7 +235,7 @@ clusters, mirror `ghcr.io/colvin-y/kubernetes-ontology` to an internal registry
 and set `KO_IMAGE` to that mirror, or use the release binary path above.
 
 ```bash
-export KO_VERSION=v0.1.4
+export KO_VERSION=v0.1.5
 export KO_IMAGE=ghcr.io/colvin-y/kubernetes-ontology
 
 helm upgrade --install kubernetes-ontology ./charts/kubernetes-ontology \
@@ -531,12 +531,16 @@ make live-check NAMESPACE=default NAME=my-pod
 Tagged releases publish:
 
 - per-platform archives containing `kubernetes-ontology`, `kubernetes-ontologyd`,
-  `kubernetes-ontology-viewer`, Quickstart docs, and a local config example
+  `kubernetes-ontology-viewer`, Quickstart docs, release notes, and a local
+  config example
+- a packaged Helm chart archive, for example
+  `kubernetes-ontology-0.1.5.tgz`
 - a multi-architecture image at
   `ghcr.io/colvin-y/kubernetes-ontology:<tag>`
 - SemVer aliases without the leading `v`, plus `latest`
 
 See [docs/release.md](docs/release.md) for the release checklist.
+See [CHANGELOG.md](CHANGELOG.md) for release notes.
 
 The agent skill is published from the default branch rather than from release
 archives, so marketplace pages should link to the live repository path:
@@ -573,6 +577,7 @@ archives, so marketplace pages should link to the live repository path:
 - [docs/design/README.md](docs/design/README.md): design document index
 - [docs/ontology/README.md](docs/ontology/README.md): ontology notes
 - [docs/release.md](docs/release.md): release checklist
+- [CHANGELOG.md](CHANGELOG.md): release notes
 
 ## License
 

README.zh-CN.md

@@ -128,7 +128,7 @@ Skill marketplace 对外链接故意指向默认分支，这样 Agent 会拿到
 `kubernetes-ontology-viewer`。
 
 ```bash
-export KO_VERSION=v0.1.4
+export KO_VERSION=v0.1.5
 curl -LO "https://github.com/Colvin-Y/kubernetes-ontology/releases/download/${KO_VERSION}/kubernetes-ontology_${KO_VERSION}_linux_amd64.tar.gz"
 tar -xzf "kubernetes-ontology_${KO_VERSION}_linux_amd64.tar.gz"
 cd "kubernetes-ontology_${KO_VERSION}_linux_amd64"
@@ -178,7 +178,7 @@ streamMode: informer
 `KO_IMAGE` 改成内部地址，或者使用上面的二进制方式。
 
 ```bash
-export KO_VERSION=v0.1.4
+export KO_VERSION=v0.1.5
 export KO_IMAGE=ghcr.io/colvin-y/kubernetes-ontology
 
 helm upgrade --install kubernetes-ontology ./charts/kubernetes-ontology \
@@ -411,6 +411,7 @@ make live-check NAMESPACE=default NAME=my-pod
 - [docs/design/README.md](docs/design/README.md)：设计文档索引
 - [docs/ontology/README.md](docs/ontology/README.md)：ontology 说明
 - [docs/release.md](docs/release.md)：发布流程
+- [CHANGELOG.md](CHANGELOG.md)：版本更新记录
 
 ## License
 

charts/kubernetes-ontology/Chart.yaml

@@ -2,8 +2,8 @@ apiVersion: v2
 name: kubernetes-ontology
 description: Read-only Kubernetes ontology server with an optional dependency-free viewer.
 type: application
-version: 0.1.4
-appVersion: "0.1.4"
+version: 0.1.5
+appVersion: "0.1.5"
 keywords:
   - kubernetes
   - ontology

docs/release.md

@@ -1,7 +1,7 @@
 # Release Guide
 
-This project publishes binaries through GitHub Releases and container images
-through GitHub Container Registry (GHCR).
+This project publishes binaries and a packaged Helm chart through GitHub
+Releases, plus container images through GitHub Container Registry (GHCR).
 
 Docker Hub is optional. The default open-source release path does not require a
 Docker Hub account, namespace, access token, or repository secret.
@@ -51,26 +51,40 @@ Docker Hub account, namespace, access token, or repository secret.
 
 ## Publish A Version
 
+Before tagging, run local validation from a disposable kind cluster and an
+explicit kubeconfig. Do not let release checks fall back to an ambient
+developer kubeconfig:
+
+```bash
+export KO_KIND_KUBECONFIG=/private/tmp/kubernetes-ontology-kind-kubeconfig
+kind export kubeconfig --name kind --kubeconfig "${KO_KIND_KUBECONFIG}"
+KUBECONFIG="${KO_KIND_KUBECONFIG}" make ci
+kubectl --kubeconfig "${KO_KIND_KUBECONFIG}" get nodes
+```
+
+Then run the live diagnostic smoke tests against that same kubeconfig.
+
 Use semantic version tags:
 
 ```bash
-git tag v0.1.4
-git push origin v0.1.4
+git tag v0.1.5
+git push origin v0.1.5
 ```
 
-Replace `v0.1.4` with the release tag you are publishing.
+Replace `v0.1.5` with the release tag you are publishing.
 
 Pushing the tag starts both workflows:
 
 - `.github/workflows/release.yml` creates a GitHub Release and uploads
   per-platform archives containing `kubernetes-ontology` (CLI),
   `kubernetes-ontologyd` (server), `kubernetes-ontology-viewer`, README files,
-  `QUICKSTART.md`, `AI_CONTRACT.md`, and the local config example.
+  `QUICKSTART.md`, `CHANGELOG.md`, `AI_CONTRACT.md`, the local config example,
+  and a packaged Helm chart archive.
 - `.github/workflows/docker.yml` builds and pushes a multi-architecture image:
 
   ```text
-  ghcr.io/colvin-y/kubernetes-ontology:v0.1.4
-  ghcr.io/colvin-y/kubernetes-ontology:0.1.4
+  ghcr.io/colvin-y/kubernetes-ontology:v0.1.5
+  ghcr.io/colvin-y/kubernetes-ontology:0.1.5
   ghcr.io/colvin-y/kubernetes-ontology:latest
   ```
 
@@ -89,20 +103,23 @@ gh run list --workflow Docker --limit 5
 Check the release assets:
 
 ```bash
-gh release view v0.1.4
+gh release view v0.1.5
 ```
 
-Inspect one archive when release packaging changes:
+Inspect one binary archive and the Helm chart archive when release packaging
+changes:
 
 ```bash
-gh release download v0.1.4 --pattern 'kubernetes-ontology_v0.1.4_linux_amd64.tar.gz' --clobber
-tar -tzf kubernetes-ontology_v0.1.4_linux_amd64.tar.gz | grep -E 'kubernetes-ontologyd$|kubernetes-ontology$|QUICKSTART.md|local/kubernetes-ontology.yaml.example'
+gh release download v0.1.5 --pattern 'kubernetes-ontology_v0.1.5_linux_amd64.tar.gz' --clobber
+tar -tzf kubernetes-ontology_v0.1.5_linux_amd64.tar.gz | grep -E 'kubernetes-ontologyd$|kubernetes-ontology$|QUICKSTART.md|local/kubernetes-ontology.yaml.example'
+gh release download v0.1.5 --pattern 'kubernetes-ontology-0.1.5.tgz' --clobber
+helm show chart kubernetes-ontology-0.1.5.tgz
 ```
 
 Pull the image:
 
 ```bash
-docker pull ghcr.io/colvin-y/kubernetes-ontology:v0.1.4
+docker pull ghcr.io/colvin-y/kubernetes-ontology:v0.1.5
 ```
 
 Deploy through Helm:
@@ -112,7 +129,7 @@ helm upgrade --install kubernetes-ontology ./charts/kubernetes-ontology \
   --namespace kubernetes-ontology \
   --create-namespace \
   --set image.repository=ghcr.io/colvin-y/kubernetes-ontology \
-  --set image.tag=v0.1.4 \
+  --set image.tag=v0.1.5 \
   --set cluster=your-logical-cluster \
   --set contextNamespaces='{default,kube-system}'
 ```

skills/kubernetes-ontology-access/SKILL.md

@@ -146,7 +146,7 @@ pull the published image. A GitHub Release archive contains:
 Download or transfer the archive for the selected version and platform:
 
 ```bash
-export KO_VERSION=v0.1.4
+export KO_VERSION=v0.1.5
 curl -LO "https://github.com/Colvin-Y/kubernetes-ontology/releases/download/${KO_VERSION}/kubernetes-ontology_${KO_VERSION}_linux_amd64.tar.gz"
 tar -xzf "kubernetes-ontology_${KO_VERSION}_linux_amd64.tar.gz"
 cd "kubernetes-ontology_${KO_VERSION}_linux_amd64"
@@ -221,7 +221,7 @@ project release they selected or the version already present in the repository
 docs. Do not invent a future version.
 
 ```bash
-export KO_VERSION=v0.1.4
+export KO_VERSION=v0.1.5
 export KO_IMAGE=ghcr.io/colvin-y/kubernetes-ontology
 
 helm upgrade --install kubernetes-ontology ./charts/kubernetes-ontology \