[gmolto]

Summary

• Resolve OSCAR Agent Profile 1.1 agentSoul and agentSkills from crate-local RO-Crate files during local and remote hub deploy, only for guidance variables declared by the FDL.
• Preserve explicit --env-file overrides and reject unresolved guidance placeholders.
• Add --preview to inspect the resolved source FDL without contacting a cluster, with declared secrets redacted; make preview and deployment select the same service deterministically.
• Document the behavior and cover local/remote loading, validation, overrides, preview, and mocked deployment paths.

Related work

Tracking issue: https://github.com/grycap/issue-tracker/issues/540

The crate/profile documentation update is in grycap/oscar-agents#6. The accepted profile identifier currently points to devel; moving it to main requires a coordinated follow-up with the crate metadata.

Verification

• go test ./... (passed)
• Local and remote oscar-cli hub deploy --preview for pdf-summarizer and hermes-dashboard (passed; PDF guidance resolved)
• No live OSCAR deployment or LLM invocation was performed. Provider settings, credentials, and any required volume still need configuration before deployment.