Skip to content

feat: app_deployment collection and CM-006 evaluation #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
keyskey merged 9 commits into from
Jun 9, 2026
Merged

feat: app_deployment collection and CM-006 evaluation #4

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
88a7c00
feat: add AppDeployment evidence type and git URL repository helper
keyskey Jun 9, 2026
8a4175b
feat: add app_deployment evidence, argocd provider, and control config
keyskey Jun 9, 2026
37bbbea
feat: add app_deployment storage Put and Query
keyskey Jun 9, 2026
60f1a65
feat: implement CM-006 app_deployment evaluation using traceability core
keyskey Jun 9, 2026
c40717c
refactor: migrate CM-007 to evaluateTraceabilityCore
keyskey Jun 9, 2026
9aab0bc
feat: add argocd provider using official apiclient for app_deployment…
keyskey Jun 9, 2026
d840a2a
feat: add collect app-deployment command and daily step
keyskey Jun 9, 2026
08ff251
test: add app_deployment fixture data and storage round-trip test
keyskey Jun 9, 2026
734f79e
feat: skip infra_deployment collect when not configured
keyskey Jun 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ CM-001〜010 により統制を評価する。詳細は [設計ドキュメン
kao run daily --config kao.yaml --date 2026-06-05
```

認証情報は Configuration に平文で書かず、環境変数（`GITHUB_TOKEN`, `DATABASE_URL` 等）から注入する。
認証情報は Configuration に平文で書かず、環境変数（`GITHUB_TOKEN`, `ARGOCD_SERVER`, `ARGOCD_TOKEN`, `DATABASE_URL` 等）から注入する。`go.mod` の `argoproj/argo-cd/v2` は本番 Argo CD サーバーのバージョンに合わせて pin する。

## 設計ドキュメント

Expand Down
14 changes: 7 additions & 7 deletions docs/design-doc.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -140,15 +140,15 @@ KAO は状態を持たない。実行基盤は GitHub Actions、Kubernetes CronJ

## Schedule

全 evidence を **毎日 00:00 UTC の単一ジョブ** で収集・評価する。Cron からは `kao run daily` を実行する（§8）。
**毎日 00:00 UTC の単一ジョブ** で収集・評価する。Cron からは `kao run daily` を実行する（§8）。`repo_control` と `code_change` は常に収集する。`app_deployment` / `infra_deployment` は Configuration で該当 evidence が有効な場合のみ収集する（Terraform や Argo CD を使わない組織では省略可能）。

| 順序 | 処理 | 収集対象 | 備考 |
|---|---|---|---|
| 1 | `repo_control` 収集 → storage | ジョブ実行時点のリポジトリ統制状態 | CODEOWNERS と Team Membership を含む |
| 2 | `code_change` 収集 → storage | **前日**に default branch へマージされた PR | `--date` で対象日を指定 |
| 3 | `app_deployment` 収集 → storage | **前日**の本番 Application デプロイ | 同上 |
| 4 | `infra_deployment` 収集 → storage | **前日**の本番 Infrastructure デプロイ | 同上 |
| 5 | `evaluate` ← storage → storage | 手順 1〜4 の証跡を入力として評価 | 結果を storage へ保存 |
| 1 | `repo_control` 収集 → storage | ジョブ実行時点のリポジトリ統制状態 | 常に実行。CODEOWNERS と Team Membership を含む |
| 2 | `code_change` 収集 → storage | **前日**に default branch へマージされた PR | 常に実行。`--date` で対象日を指定 |
| 3 | `app_deployment` 収集 → storage | **前日**の本番 Application デプロイ | `evidence.app_deployment` + `providers.argocd` が設定されている場合のみ |
| 4 | `infra_deployment` 収集 → storage | **前日**の本番 Infrastructure デプロイ | `evidence.infra_deployment`（`apply_workflows` または `apply_job_names`）が設定されている場合のみ |
| 5 | `evaluate` ← storage → storage | 収集済み証跡を入力として評価 | 結果を storage へ保存。未収集の deployment 統制（CM-006/007）は評価対象にならない |

`repo_control` を日次で記録する理由:

Expand Down Expand Up @@ -198,7 +198,7 @@ kao run daily --config kao.yaml --date 2026-06-05 --repository trading-api

## kao run daily（推奨）

日次ジョブのエントリポイント。§7 Schedule の手順 1〜5 を順に実行する。
日次ジョブのエントリポイント。§7 Schedule の手順を順に実行する。`app_deployment` / `infra_deployment` の collect は設定がある場合のみ実行され、単体の `kao collect app-deployment` / `kao collect infra-deployment` は設定必須である。

```bash
kao run daily --config kao.yaml --date 2026-06-05
Expand Down
147 changes: 146 additions & 1 deletion go.mod
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,21 +3,166 @@ module github.com/keyskey/kao
go 1.26.4

require (
github.com/argoproj/argo-cd/v2 v2.14.11
github.com/google/go-github/v62 v62.0.0
github.com/jackc/pgx/v5 v5.10.0
github.com/spf13/cobra v1.10.2
gopkg.in/yaml.v3 v3.0.1
k8s.io/apimachinery v0.31.2
)

require (
cloud.google.com/go/compute/metadata v0.5.0 // indirect
dario.cat/mergo v1.0.1 // indirect
github.com/Azure/go-ansiterm v0.0.0-20210617225240-d185dfc1b5a1 // indirect
github.com/MakeNowJust/heredoc v1.0.0 // indirect
github.com/Masterminds/semver/v3 v3.3.1 // indirect
github.com/Microsoft/go-winio v0.6.1 // indirect
github.com/ProtonMail/go-crypto v1.1.5 // indirect
github.com/argoproj/gitops-engine v0.7.1-0.20250328191959-6d3cf122b03f // indirect
github.com/argoproj/pkg v0.13.7-0.20230626144333-d56162821bd1 // indirect
github.com/beorn7/perks v1.0.1 // indirect
github.com/blang/semver/v4 v4.0.0 // indirect
github.com/bmatcuk/doublestar/v4 v4.7.1 // indirect
github.com/bombsimon/logrusr/v2 v2.0.1 // indirect
github.com/bradleyfalzon/ghinstallation/v2 v2.12.0 // indirect
github.com/casbin/casbin/v2 v2.102.0 // indirect
github.com/casbin/govaluate v1.2.0 // indirect
github.com/cespare/xxhash/v2 v2.3.0 // indirect
github.com/chai2010/gettext-go v1.0.2 // indirect
github.com/cloudflare/circl v1.3.7 // indirect
github.com/coreos/go-oidc/v3 v3.11.0 // indirect
github.com/cyphar/filepath-securejoin v0.3.6 // indirect
github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc // indirect
github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f // indirect
github.com/distribution/reference v0.5.0 // indirect
github.com/dlclark/regexp2 v1.11.4 // indirect
github.com/emicklei/go-restful/v3 v3.11.0 // indirect
github.com/emirpasic/gods v1.18.1 // indirect
github.com/evanphx/json-patch v5.9.0+incompatible // indirect
github.com/exponent-io/jsonpath v0.0.0-20151013193312-d6023ce2651d // indirect
github.com/fatih/camelcase v1.0.0 // indirect
github.com/felixge/httpsnoop v1.0.4 // indirect
github.com/fxamacker/cbor/v2 v2.7.0 // indirect
github.com/go-errors/errors v1.4.2 // indirect
github.com/go-git/gcfg v1.5.1-0.20230307220236-3a3c6141e376 // indirect
github.com/go-git/go-billy/v5 v5.6.2 // indirect
github.com/go-git/go-git/v5 v5.13.2 // indirect
github.com/go-jose/go-jose/v4 v4.0.2 // indirect
github.com/go-logr/logr v1.4.2 // indirect
github.com/go-logr/stdr v1.2.2 // indirect
github.com/go-openapi/jsonpointer v0.21.0 // indirect
github.com/go-openapi/jsonreference v0.21.0 // indirect
github.com/go-openapi/swag v0.23.0 // indirect
github.com/go-redis/cache/v9 v9.0.0 // indirect
github.com/gobwas/glob v0.2.3 // indirect
github.com/gogo/protobuf v1.3.2 // indirect
github.com/golang-jwt/jwt/v4 v4.5.2 // indirect
github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da // indirect
github.com/golang/protobuf v1.5.4 // indirect
github.com/google/btree v1.1.3 // indirect
github.com/google/gnostic-models v0.6.8 // indirect
github.com/google/go-cmp v0.6.0 // indirect
github.com/google/go-github/v66 v66.0.0 // indirect
github.com/google/go-querystring v1.1.0 // indirect
github.com/google/gofuzz v1.2.0 // indirect
github.com/google/shlex v0.0.0-20191202100458-e7afc7fbc510 // indirect
github.com/google/uuid v1.6.0 // indirect
github.com/gorilla/websocket v1.5.3 // indirect
github.com/gregjones/httpcache v0.0.0-20190611155906-901d90724c79 // indirect
github.com/grpc-ecosystem/go-grpc-middleware v1.4.0 // indirect
github.com/grpc-ecosystem/grpc-gateway v1.16.0 // indirect
github.com/hashicorp/go-cleanhttp v0.5.2 // indirect
github.com/hashicorp/go-retryablehttp v0.7.7 // indirect
github.com/imdario/mergo v0.3.16 // indirect
github.com/inconshreveable/mousetrap v1.1.0 // indirect
github.com/jackc/pgpassfile v1.0.0 // indirect
github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
github.com/jackc/puddle/v2 v2.2.2 // indirect
github.com/kr/text v0.2.0 // indirect
github.com/jbenet/go-context v0.0.0-20150711004518-d14ea06fba99 // indirect
github.com/jonboulle/clockwork v0.2.2 // indirect
github.com/josharian/intern v1.0.0 // indirect
github.com/json-iterator/go v1.1.12 // indirect
github.com/kballard/go-shellquote v0.0.0-20180428030007-95032a82bc51 // indirect
github.com/kevinburke/ssh_config v1.2.0 // indirect
github.com/klauspost/compress v1.17.9 // indirect
github.com/liggitt/tabwriter v0.0.0-20181228230101-89fcab3d43de // indirect
github.com/mailru/easyjson v0.7.7 // indirect
github.com/mitchellh/go-wordwrap v1.0.1 // indirect
github.com/moby/spdystream v0.4.0 // indirect
github.com/moby/term v0.5.0 // indirect
github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
github.com/modern-go/reflect2 v1.0.2 // indirect
github.com/monochromegane/go-gitignore v0.0.0-20200626010858-205db1a8cc00 // indirect
github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 // indirect
github.com/mxk/go-flowrate v0.0.0-20140419014527-cca7078d478f // indirect
github.com/opencontainers/go-digest v1.0.0 // indirect
github.com/opencontainers/image-spec v1.1.0 // indirect
github.com/patrickmn/go-cache v2.1.0+incompatible // indirect
github.com/peterbourgon/diskv v2.0.1+incompatible // indirect
github.com/pjbgf/sha1cd v0.3.2 // indirect
github.com/pkg/errors v0.9.1 // indirect
github.com/prometheus/client_golang v1.20.5 // indirect
github.com/prometheus/client_model v0.6.1 // indirect
github.com/prometheus/common v0.55.0 // indirect
github.com/prometheus/procfs v0.15.1 // indirect
github.com/r3labs/diff v1.1.0 // indirect
github.com/redis/go-redis/v9 v9.7.1 // indirect
github.com/robfig/cron/v3 v3.0.1 // indirect
github.com/rogpeppe/go-internal v1.15.0 // indirect
github.com/russross/blackfriday/v2 v2.1.0 // indirect
github.com/sergi/go-diff v1.3.2-0.20230802210424-5b0b94c5c0d3 // indirect
github.com/sirupsen/logrus v1.9.3 // indirect
github.com/skeema/knownhosts v1.3.0 // indirect
github.com/spf13/pflag v1.0.9 // indirect
github.com/vmihailenco/go-tinylfu v0.2.2 // indirect
github.com/vmihailenco/msgpack/v5 v5.3.4 // indirect
github.com/vmihailenco/tagparser/v2 v2.0.0 // indirect
github.com/x448/float16 v0.8.4 // indirect
github.com/xanzy/ssh-agent v0.3.3 // indirect
github.com/xlab/treeprint v1.2.0 // indirect
go.opentelemetry.io/auto/sdk v1.1.0 // indirect
go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.56.0 // indirect
go.opentelemetry.io/otel v1.33.0 // indirect
go.opentelemetry.io/otel/metric v1.33.0 // indirect
go.opentelemetry.io/otel/trace v1.33.0 // indirect
go.starlark.net v0.0.0-20230525235612-a134d8f9ddca // indirect
golang.org/x/crypto v0.41.0 // indirect
golang.org/x/mod v0.27.0 // indirect
golang.org/x/net v0.43.0 // indirect
golang.org/x/oauth2 v0.24.0 // indirect
golang.org/x/sync v0.17.0 // indirect
golang.org/x/sys v0.35.0 // indirect
golang.org/x/term v0.34.0 // indirect
golang.org/x/text v0.29.0 // indirect
golang.org/x/time v0.8.0 // indirect
golang.org/x/tools v0.36.0 // indirect
google.golang.org/genproto v0.0.0-20240213162025-012b6fc9bca9 // indirect
google.golang.org/genproto/googleapis/api v0.0.0-20241104194629-dd2ea8efbc28 // indirect
google.golang.org/genproto/googleapis/rpc v0.0.0-20241104194629-dd2ea8efbc28 // indirect
google.golang.org/grpc v1.68.1 // indirect
google.golang.org/protobuf v1.35.2 // indirect
gopkg.in/evanphx/json-patch.v4 v4.12.0 // indirect
gopkg.in/inf.v0 v0.9.1 // indirect
gopkg.in/warnings.v0 v0.1.2 // indirect
gopkg.in/yaml.v2 v2.4.0 // indirect
k8s.io/api v0.31.2 // indirect
k8s.io/apiextensions-apiserver v0.31.2 // indirect
k8s.io/apiserver v0.31.2 // indirect
k8s.io/cli-runtime v0.31.2 // indirect
k8s.io/client-go v0.31.2 // indirect
k8s.io/component-base v0.31.2 // indirect
k8s.io/component-helpers v0.31.2 // indirect
k8s.io/klog/v2 v2.130.1 // indirect
k8s.io/kube-aggregator v0.31.2 // indirect
k8s.io/kube-openapi v0.0.0-20240228011516-70dd3763d340 // indirect
k8s.io/kubectl v0.31.2 // indirect
k8s.io/kubernetes v1.31.0 // indirect
k8s.io/utils v0.0.0-20240711033017-18e509b52bc8 // indirect
oras.land/oras-go/v2 v2.5.0 // indirect
sigs.k8s.io/json v0.0.0-20221116044647-bc3834ca7abd // indirect
sigs.k8s.io/kustomize/api v0.17.2 // indirect
sigs.k8s.io/kustomize/kyaml v0.17.1 // indirect
sigs.k8s.io/structured-merge-diff/v4 v4.4.4-0.20241211184406-7bf59b3d70ee // indirect
sigs.k8s.io/yaml v1.4.0 // indirect
)
Loading
Loading