ai:chore: Implement direct types for: CCInsightsPhraseMatcher (#9335)

Implementing initial KRM types, CRD, and IdentityV2 for
`CCInsightsPhraseMatcher` resource under the
`contactcenterinsights.cnrm.cloud.google.com/v1alpha1` group using the
direct approach.

- Scaffolded and refined types in `phrasematcher_types.go`.
- Implemented `IdentityV2` and `ExternalIdentifier()` interfaces in
`ccinsightsphrasematcher_identity.go`.
- Registered `CCInsightsPhraseMatcher` in static configuration
`static_config.go`.
- Regenerated manifests, cluster roles, reports, and Go CRD clients
successfully.
- Verified that all local prerequisite validations
(`scripts/validate-prereqs.sh`) pass cleanly.

As instructed, this PR does not contain the controller or mapper steps.

Related chore file:
[.agents/greenfield-direct-new-resource-types.md](https://github.com/GoogleCloudPlatform/k8s-config-connector/blob/main/.agents/greenfield-direct-new-resource-types.md)

Fixes #9262

Author: acpana

.gemini/journals/contactcenterinsights.md

@@ -1,3 +1,5 @@
+# Contact Center Insights Service Journal
+
 ### [2026-06-05] CCInsightsView Greenfield Types Scaffolding
 - **Context**: Implementing Greenfield direct types, CRD, and IdentityV2 for `CCInsightsView` resource (mapped to `google.cloud.contactcenterinsights.v1.View`).
 - **Problem**: Greenfield types need to strictly follow the KRM layout, specifically:
@@ -11,3 +13,9 @@
   4. Implemented `CCInsightsViewRef` and registered it for resource referencing.
   5. Wrote comprehensive unit tests to validate identity and reference logic.
 - **Impact**: Establishes a standard, fully validated direct type foundation for Contact Center Insights (CCInsightsView), passing all presubmits and client-go code generation cleanly.
+
+### [2026-06-05] CCInsightsPhraseMatcher Greenfield Types and Identity
+- **Context**: Greenfield types, CRD, and IdentityV2 implementation for `CCInsightsPhraseMatcher` (GCP `PhraseMatcher` under `contactcenterinsights.googleapis.com`).
+- **Problem**: The proto-to-KRM generator comments out nested structs as "unreachable types" initially because `phrasematcher_types.go` is stubbed out. Also, we had to ensure scalar types are represented as pointers to satisfy KCC's strict pointer rule.
+- **Solution**: We populated the nested structs (such as `PhraseMatchRuleGroup` and `PhraseMatchRule`) explicitly in `phrasematcher_types.go` and defined `Location` in `CCInsightsPhraseMatcherSpec` directly as `*string`. Running `generate.sh` then resolved all unreachable types cleanly.
+- **Impact**: All future developers working on `contactcenterinsights` can leverage the scaffolded types, CRDs, and identity structure, knowing that the compiler and validators are fully satisfied with the pointer fields.

apis/contactcenterinsights/v1alpha1/ccinsightsphrasematcher_identity.go

@@ -0,0 +1,113 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package v1alpha1
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/GoogleCloudPlatform/k8s-config-connector/apis/common"
+	"github.com/GoogleCloudPlatform/k8s-config-connector/apis/common/identity"
+	refs "github.com/GoogleCloudPlatform/k8s-config-connector/apis/refs/v1beta1"
+	"github.com/GoogleCloudPlatform/k8s-config-connector/pkg/gcpurls"
+	"sigs.k8s.io/controller-runtime/pkg/client"
+)
+
+var (
+	_ identity.IdentityV2 = &CCInsightsPhraseMatcherIdentity{}
+	_ identity.Resource   = &CCInsightsPhraseMatcher{}
+)
+
+var CCInsightsPhraseMatcherIdentityFormat = gcpurls.Template[CCInsightsPhraseMatcherIdentity]("contactcenterinsights.googleapis.com", "projects/{project}/locations/{location}/phraseMatchers/{phrase_matcher}")
+
+// +k8s:deepcopy-gen=false
+type CCInsightsPhraseMatcherIdentity struct {
+	Project        string
+	Location       string
+	Phrase_matcher string
+}
+
+func (i *CCInsightsPhraseMatcherIdentity) String() string {
+	return CCInsightsPhraseMatcherIdentityFormat.ToString(*i)
+}
+
+func (i *CCInsightsPhraseMatcherIdentity) FromExternal(ref string) error {
+	parsed, match, err := CCInsightsPhraseMatcherIdentityFormat.Parse(ref)
+	if err != nil {
+		return fmt.Errorf("format of CCInsightsPhraseMatcher external=%q was not known (use %s): %w", ref, CCInsightsPhraseMatcherIdentityFormat.CanonicalForm(), err)
+	}
+	if !match {
+		return fmt.Errorf("format of CCInsightsPhraseMatcher external=%q was not known (use %s)", ref, CCInsightsPhraseMatcherIdentityFormat.CanonicalForm())
+	}
+
+	*i = *parsed
+	return nil
+}
+
+func (i *CCInsightsPhraseMatcherIdentity) Host() string {
+	return CCInsightsPhraseMatcherIdentityFormat.Host()
+}
+
+func getIdentityFromCCInsightsPhraseMatcherSpec(ctx context.Context, reader client.Reader, obj client.Object) (*CCInsightsPhraseMatcherIdentity, error) {
+	resourceID, err := refs.GetResourceID(obj)
+	if err != nil {
+		return nil, fmt.Errorf("cannot resolve resource ID")
+	}
+
+	location, err := refs.GetLocation(obj)
+	if err != nil {
+		return nil, fmt.Errorf("cannot resolve location")
+	}
+
+	projectID, err := refs.ResolveProjectID(ctx, reader, obj)
+	if err != nil {
+		return nil, fmt.Errorf("cannot resolve project")
+	}
+
+	identity := &CCInsightsPhraseMatcherIdentity{
+		Project:        projectID,
+		Location:       location,
+		Phrase_matcher: resourceID,
+	}
+	return identity, nil
+}
+
+func (obj *CCInsightsPhraseMatcher) GetIdentity(ctx context.Context, reader client.Reader) (identity.Identity, error) {
+	specIdentity, err := getIdentityFromCCInsightsPhraseMatcherSpec(ctx, reader, obj)
+	if err != nil {
+		return nil, err
+	}
+
+	externalRef := common.ValueOf(obj.Status.ExternalRef)
+	if externalRef != "" {
+		statusIdentity := &CCInsightsPhraseMatcherIdentity{}
+		if err := statusIdentity.FromExternal(externalRef); err != nil {
+			return nil, err
+		}
+
+		if statusIdentity.String() != specIdentity.String() {
+			return nil, fmt.Errorf("cannot change CCInsightsPhraseMatcher identity (old=%q, new=%q)", statusIdentity.String(), specIdentity.String())
+		}
+	}
+
+	return specIdentity, nil
+}
+
+func (obj *CCInsightsPhraseMatcher) ExternalIdentifier() *string {
+	if obj.Status.ExternalRef != nil {
+		return obj.Status.ExternalRef
+	}
+	return nil
+}

apis/contactcenterinsights/v1alpha1/ccinsightsphrasematcher_identity_test.go

@@ -0,0 +1,74 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package v1alpha1
+
+import (
+	"testing"
+)
+
+func TestCCInsightsPhraseMatcherIdentity_FromExternal(t *testing.T) {
+	tests := []struct {
+		name     string
+		input    string
+		expected *CCInsightsPhraseMatcherIdentity
+		hasError bool
+	}{
+		{
+			name:  "Full resource name",
+			input: "projects/my-project/locations/us-central1/phraseMatchers/my-phrasematcher",
+			expected: &CCInsightsPhraseMatcherIdentity{
+				Project:        "my-project",
+				Location:       "us-central1",
+				Phrase_matcher: "my-phrasematcher",
+			},
+			hasError: false,
+		},
+		{
+			name:  "Full resource name with host",
+			input: "contactcenterinsights.googleapis.com/projects/my-project/locations/us-central1/phraseMatchers/my-phrasematcher",
+			expected: &CCInsightsPhraseMatcherIdentity{
+				Project:        "my-project",
+				Location:       "us-central1",
+				Phrase_matcher: "my-phrasematcher",
+			},
+			hasError: false,
+		},
+		{
+			name:     "Invalid format",
+			input:    "projects/my-project/locations/us-central1/invalid/my-phrasematcher",
+			expected: nil,
+			hasError: true,
+		},
+	}
+
+	for _, tc := range tests {
+		t.Run(tc.name, func(t *testing.T) {
+			id := &CCInsightsPhraseMatcherIdentity{}
+			err := id.FromExternal(tc.input)
+			if tc.hasError {
+				if err == nil {
+					t.Fatal("expected error, got nil")
+				}
+				return
+			}
+			if err != nil {
+				t.Fatalf("unexpected error: %v", err)
+			}
+			if id.Project != tc.expected.Project || id.Location != tc.expected.Location || id.Phrase_matcher != tc.expected.Phrase_matcher {
+				t.Fatalf("expected %+v, got %+v", tc.expected, id)
+			}
+		})
+	}
+}

apis/contactcenterinsights/v1alpha1/generate.sh

@@ -26,7 +26,9 @@ go run . generate-types \
   --service google.cloud.contactcenterinsights.v1 \
   --api-version contactcenterinsights.cnrm.cloud.google.com/v1alpha1 \
   --resource CCInsightsView:View \
-  --prune-unused-types=false
+  --resource CCInsightsPhraseMatcher:PhraseMatcher \
+  --prune-unused-types=false \
+  --include-skipped-output
 
 cd ${REPO_ROOT}
 dev/tasks/generate-crds