Add missing godoc for validateToolConfiguration in compiler validators

[Copilot]

This issue targets the remaining documentation gap in pkg/workflow/compiler_validators.go: validateToolConfiguration lacked explicit godoc despite being part of the validator surface. The change adds focused API documentation with no behavioral changes.

• What changed

  • Added/updated the method comment for validateToolConfiguration to document:
    • validation scope (safe-outputs, needs, network, labels, concurrency, sandbox, tool/permission alignment, dispatch/call-workflow),
    • error behavior (returns the first validation error),
    • parameter constraint/context (workflowPermissions comes from validatePermissions).

• Why this is scoped

  • Touches documentation only in pkg/workflow/compiler_validators.go.
  • Leaves private helper godoc and runtime logic unchanged.

• Snippet

  // validateToolConfiguration validates the workflow's tool-related configuration:
  // safe-outputs settings, needs declarations, network configuration, labels,
  // concurrency expressions, sandbox constraints, GitHub tool-to-toolset
  // alignment, permission requirements, and dispatch/call-workflow settings.
  // It returns the first validation error encountered (already formatted with
  // markdownPath context by downstream validators).
  // workflowPermissions is the *Permissions value returned by validatePermissions.

• Fixes [Code Quality] Add godoc to exported method validateToolConfiguration in compiler_validators.go #48383

[pelikhan]

@copilot resolve the merge conflicts on this branch.

[Copilot]

Pull request overview

Updates validator documentation, but also includes an unrelated generated workflow change.

Changes:

• Expands validateToolConfiguration documentation.
• Adds Copilot auto model-cost metadata to a smoke workflow lockfile.

Show a summary per file

File	Description
pkg/workflow/compiler_validators.go	Updates validator documentation.
.github/workflows/smoke-copilot-auto.lock.yml	Adds runtime model-cost metadata.

Review details

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

• Files reviewed: 2/2 changed files
• Comments generated: 2
• Review effort level: Medium