Plan: Kany8s MVP from PRD

[reoring]

Kany8s のPRDは docs/PRD.md にあります。

このPRDを読み、MVP作業を安全な子タスク(最大10個)に分割して tasks_yaml_v1 で提案してください。

[reoring]

tasks:

• title: "開発基盤: kubebuilder scaffold/ツールpin/CI"
  body: |-
  • go mod init + kubebuilder init で controller repo を起動
  • hack/tools.go 等で controller-gen/kustomize/setup-envtest を pin
  • Makefile に test/generate/manifests/docker-build の最小ループを揃える
  • .github/workflows/ci.yaml で make test と make manifests を実行
  • DoD: クリーン checkout から make test と make manifests が再現的に成功
• title: "API: Kany8sControlPlane CRD 定義"
  body: |-
  • api/v1alpha1/kany8scontrolplane_types.go を MVP 要件で定義
  • spec: version(required), resourceGraphDefinitionRef.name(required), kroSpec(optional JSON), controlPlaneEndpoint(controller が設定)
  • status: initialization.controlPlaneInitialized, conditions(Get/Set), failureReason/failureMessage
  • (任意) PrinterColumns: READY/INITIALIZED/ENDPOINT を追加
  • DoD: make generate/make manifests 後、CRD に required/status subresource/printColumns が反映
• title: "kro: RGD -> instance GVK 解決ヘルパー実装"
  body: |-
  • internal/kro/gvk.go に ResolveInstanceGVK(ctx, c, rgdName) を実装
  • kro.run/v1alpha1 ResourceGraphDefinition の spec.schema.apiVersion/kind から instance GVK を導出
  • group を含まない apiVersion(例: v1alpha1) は kro.run/<version> 扱いにする
  • internal/kro/gvk_test.go を table-driven で追加
  • DoD: RGD の apiVersion 表記揺れ込みで期待 GVK を安定して返す
• title: "Controller: kro instance の 1:1 create/update"
  body: |-
  • controllers/kany8scontrolplane_controller.go を作成し reconcile を実装
  • RGD を取得し、解決した GVK の kro instance を unstructured.Unstructured で create/update（CreateOrUpdate）
  • instance 名/namespace は ControlPlane と一致、OwnerReference(controller=true) を付与
  • spec 構築ルール: .spec に kroSpec を展開し、.spec.version は必ず上書き
  • DoD: ControlPlane apply で同名の kro instance が生成/更新され、削除で GC 連鎖する
• title: "Controller: status 正規化の消費と CAPI contract 反映"
  body: |-
  • internal/kro/status.go で instance の status.ready/endpoint/reason/message を安全に取得（欠落でも panic しない）
  • internal/endpoint/parse.go + internal/endpoint/parse_test.go で https://host[:port]/host[:port] を parse（port 省略=443）
  • endpoint が取れたら spec.controlPlaneEndpoint(host/port) を設定し、初回のみ status.initialization.controlPlaneInitialized=true
  • Conditions と failureReason/failureMessage を ready/endpoint/reason/message に基づき更新（未Readyは Creating、Ready+endpoint で Ready=True）
  • DoD: instance の status 変化に追従して ControlPlane 側の endpoint/initialized/conditions が収束する
• title: "RBAC/配布: install manifests の最小整備"
  body: |-
  • controller RBAC を +kubebuilder:rbac で追加（ControlPlane 本体 + status/finalizers）
  • resourcegraphdefinitions.kro.run の get/list/watch を追加
  • 動的 GVK 作成のため MVP は kro.run group を広めに許可（create/get/list/watch/update/patch）
  • (出す場合) Event 作成権限を追加
  • DoD: make manifests で RBAC が生成され、想定権限が components に含まれる
• title: "テスト: ユニット/コントローラテストを固定し CI で回す"
  body: |-
  • unit: endpoint parse / GVK 解決 / status 読み取りの境界値を追加
  • controller: fake client もしくは envtest で reconcile の主要シナリオをテスト化
  • シナリオ例: 未Ready -> Requeue、Ready+endpoint -> endpoint/initialized/conditions 更新
  • CI で make test を必須化（envtest を使うなら setup-envtest pin も含める）
  • DoD: 主要 contract がテストで回帰防止され、PR で失敗が検知できる
• title: "examples: kro RGD contract 最小例 + AWS/EKS 参照 RGD(ACK)"
  body: |-
  • examples/kro/ に ready/endpoint 正規化 contract を満たす最小 RGD を追加
  • examples/kro/eks/eks-control-plane-rgd.yaml を追加（ACK EKS Cluster + 必須 IAM Role を graph 化）
  • status 射影で endpoint は常に string、ready は常に boolean を materialize（kro v0.7.1 制約に合わせる）
  • DoD: RGD が ResourceGraphAccepted=True になり、instance で status.ready/endpoint が欠落しない
• title: "ドキュメント/サンプル: install→apply→観測の一本道を用意"
  body: |-
  • examples/capi/cluster.yaml に Cluster + Kany8sControlPlane の最小例を追加
  • README.md に「kro install -> Kany8s install -> RGD apply -> Cluster apply」の最短手順を追加
  • docs/runbooks/kind-kro.md, docs/runbooks/ack.md, docs/runbooks/e2e.md を追加（再現環境/前提/観測コマンド）
  • DoD: 初見の利用者が手順どおりに進めて Ready/endpoint/describe で状態を追える

[reoring]

Heartbeat by Roboppoi.

[reoring]