2.0 KiB
2.0 KiB
KriCommon Consumer Contract
- Consume KriCommon as
com.kri.common:starter:<approved-version>through the repository's established Gradle version-management convention. - Import service-facing APIs from
com.kri.common.feature.*; treatcom.kri.common.runtime.*as internal. - Prefer a shared feature or approved extension point over duplicating authentication, HTTP, error, enum, Excel, Redis, JSON, date/time, JPA, crypto, or utility behavior locally.
- For HTTP/2 header safety and original upstream error propagation, use the shared HTTP/bypass features documented in the routed platform-capabilities reference instead of implementing consumer-local header filters and raw-response exception handlers.
- Response customizers may call
requireSuccess(); its upstream exception propagates unchanged. Response charset parsing ignores charset-like text inside other quoted header parameters. - When Swagger auto-configuration is active,
RequestUserContextcontroller arguments are excluded from request input documentation; server-side authentication and client IP injection remain unchanged. - Do not modify KriCommon or another consumer repository unless it is explicitly included in the approved task scope.
Required Shared References
Before each related task, read the current contents of every matching reference, even if it was read earlier in the session.
| Task scope | Required reference |
|---|---|
| Dependency, configuration, security, Web, Swagger, Redis, scheduling, HTTP, JSON, or date/time behavior | .agent-harness/references/kri-common/platform-capabilities.md |
| Encryption, hashing, key material, or legacy crypto interoperability | .agent-harness/references/kri-common/crypto-contract.md |
| KriCommon version upgrade or consumer verification | .agent-harness/references/kri-common/upgrade-and-verification.md |
If a task spans multiple scopes, read every matching reference. Generated files under .agent-harness/references/ are read-only copies; edit KriCommon's .agent/consumer.md or .agent/consumer-references/ and recompose instead.