Add varlock explain command and override indicators

[theoephraim]

Summary

• Override indicators in varlock load: When a config item value comes from a process.env override rather than its file-based definitions, the pretty output now shows a yellow indicator. This helps users understand why their resolver functions (e.g. op()) are not being called.
• New varlock explain ITEM_KEY command: Shows detailed information about how a single config item is resolved - all definitions/sources in priority order, which is active, whether a process.env override is in effect (and what would be used without it), type info, decorators, and documentation links.

Motivation

Users were getting confused when setting a config item via op() but the function was never invoked because a process.env override was silently taking precedence.

Test plan

• Run varlock load with a process.env override set - verify the override indicator appears
• Run varlock explain ITEM_KEY for items with/without overrides
• Run varlock explain ITEM_KEY for items with multiple definitions
• Run varlock explain NONEXISTENT - verify clear error message
• Existing tests pass (329 passed, 0 failed)

Screenshots

override indicators

explain output

Not 100% set on either of these, but probably a good start and can improve later

Generated with Claude Code

[changeset-bot]

🦋 Changeset detected

Latest commit: 8ea0ba0

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 18 packages

Name	Type
varlock	Minor
@varlock/astro-integration	Major
@varlock/cloudflare-integration	Major
@varlock/expo-integration	Major
@varlock/nextjs-integration	Major
@varlock/vite-integration	Major
@varlock/1password-plugin	Major
@varlock/aws-secrets-plugin	Major
@varlock/azure-key-vault-plugin	Major
@varlock/bitwarden-plugin	Major
@varlock/dashlane-plugin	Major
@varlock/google-secret-manager-plugin	Major
@varlock/hashicorp-vault-plugin	Major
@varlock/infisical-plugin	Major
@varlock/keepass-plugin	Major
@varlock/pass-plugin	Major
@varlock/passbolt-plugin	Major
@varlock/proton-pass-plugin	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[pkg-pr-new]

Open in StackBlitz

varlock

npm i https://pkg.pr.new/varlock@560

@varlock/astro-integration

npm i https://pkg.pr.new/@varlock/astro-integration@560

@varlock/cloudflare-integration

npm i https://pkg.pr.new/@varlock/cloudflare-integration@560

@varlock/expo-integration

npm i https://pkg.pr.new/@varlock/expo-integration@560

@varlock/nextjs-integration

npm i https://pkg.pr.new/@varlock/nextjs-integration@560

@varlock/vite-integration

npm i https://pkg.pr.new/@varlock/vite-integration@560

@varlock/1password-plugin

npm i https://pkg.pr.new/@varlock/1password-plugin@560

@varlock/aws-secrets-plugin

npm i https://pkg.pr.new/@varlock/aws-secrets-plugin@560

@varlock/azure-key-vault-plugin

npm i https://pkg.pr.new/@varlock/azure-key-vault-plugin@560

@varlock/bitwarden-plugin

npm i https://pkg.pr.new/@varlock/bitwarden-plugin@560

@varlock/dashlane-plugin

npm i https://pkg.pr.new/@varlock/dashlane-plugin@560

@varlock/google-secret-manager-plugin

npm i https://pkg.pr.new/@varlock/google-secret-manager-plugin@560

@varlock/hashicorp-vault-plugin

npm i https://pkg.pr.new/@varlock/hashicorp-vault-plugin@560

@varlock/infisical-plugin

npm i https://pkg.pr.new/@varlock/infisical-plugin@560

@varlock/keepass-plugin

npm i https://pkg.pr.new/@varlock/keepass-plugin@560

@varlock/pass-plugin

npm i https://pkg.pr.new/@varlock/pass-plugin@560

@varlock/passbolt-plugin

npm i https://pkg.pr.new/@varlock/passbolt-plugin@560

@varlock/proton-pass-plugin

npm i https://pkg.pr.new/@varlock/proton-pass-plugin@560

commit: 8ea0ba0

[philmillman]

sweet! 🚀