# summary

Refresh repository knowledge artifacts.

# description

Builds the metadata index, class catalog, documentation index, managed project-knowledge evidence, and knowledge manifest from every configured Salesforce package directory.

# examples

- Refresh all configured source roots:

  <%= config.bin %> <%= command.id %> --full

- Check freshness without writing files:

  <%= config.bin %> <%= command.id %> --check --json

- Refresh explicitly scoped roots with reproducible provenance:

  <%= config.bin %> <%= command.id %> --source-dir force-app --source-dir packages/core --refresh-timestamp 2026-08-07T00:00:00.000Z

# flags.check.summary

Check freshness and readiness without writing files.

# flags.full.summary

Force a complete deterministic repository scan.

# flags.source-dir.summary

Source root to scan; repeat for multiple roots. Defaults to all sfdx packageDirectories.

# flags.refresh-timestamp.summary

Explicit ISO timestamp to include in generated provenance.

# info.current

Knowledge artifacts are current (%s changed paths).

# info.stale

Knowledge artifacts are stale (%s changed paths).

# info.refreshed

Refreshed knowledge artifacts (%s changed paths).