docs(release): Prepare v0.1.5 publishing

Align install examples, Helm chart metadata, and release docs with v0.1.5.

Package CHANGELOG.md and the Helm chart in release artifacts so GitHub Releases carry the same notes and chart version users install.

Co-Authored-By: Codex <noreply@openai.com>

Author: Colvin-Y

.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 \