packages/credentials/README.md

# credentials/ — credential references

English | [中文](README.zh.md)

The credential capability family separates reference resolution from its provider:

| Package | Role | ctx key |
|---|---|---|
| [`credentials/`](credentials/README.md) | Credential-reference seam | `ctx.credentials` |
| [`credentials-local/`](credentials-local/README.md) | Environment and local-file provider | registers `ctx.credentials` |

Configuration carries references, not secret values. Consumers resolve those references at their operation boundary; the child READMEs own mutation, precedence, and storage semantics.

The subsystem reference — `CredentialRef`, per-operation resolution, UI-safe `CredentialInfo`, provider layers — is [docs/subsystems/credentials.md](../../docs/subsystems/credentials.md).
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`# credentials/ — credential references`
docs: bilingual credentials/settings-consumer documentation, catalogs, and gates 2026-07-29 14:20:06 +08:00
			`English \| [中文](README.zh.md)`

docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`The credential capability family separates reference resolution from its provider:`
docs: bilingual credentials/settings-consumer documentation, catalogs, and gates 2026-07-29 14:20:06 +08:00
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`\| Package \| Role \| ctx key \|`
			`\|---\|---\|---\|`
			\| [`credentials/`](credentials/README.md) \| Credential-reference seam \| `ctx.credentials` \|
			\| [`credentials-local/`](credentials-local/README.md) \| Environment and local-file provider \| registers `ctx.credentials` \|
docs: bilingual credentials/settings-consumer documentation, catalogs, and gates 2026-07-29 14:20:06 +08:00
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`Configuration carries references, not secret values. Consumers resolve those references at their operation boundary; the child READMEs own mutation, precedence, and storage semantics.`
docs: anchor each subsystem page to its package group; make group READMEs thin tables 2026-08-02 05:54:15 +08:00
			The subsystem reference — `CredentialRef`, per-operation resolution, UI-safe `CredentialInfo`, provider layers — is [docs/subsystems/credentials.md](../../docs/subsystems/credentials.md).