[cli-consistency] Missing Documentation: hash-frontmatter Command

[github-actions]

Issue Description

Command: gh aw hash-frontmatter
Type: Missing documentation
Priority: Medium

The hash-frontmatter command exists in the codebase and is fully functional but is completely missing from the CLI documentation (docs/src/content/docs/setup/cli.md). Users cannot discover this utility command.

Evidence from Source Code

File: pkg/cli/hash_command.go
Use: hash-frontmatter (workflow)
Short description: "Compute frontmatter hash for a workflow"
Registration:

• cmd/gh-aw/main.go line 564: hashCmd := cli.NewHashCommand()
• Line 599: hashCmd.GroupID = "utilities"
• Line 628: rootCmd.AddCommand(hashCmd)

Current State vs Expected State

Aspect	Current	Expected
Implementation	✅ Fully implemented	✅ Fully implemented
Registration	✅ Registered in main.go	✅ Registered in main.go
Documentation	❌ Missing entirely	✅ Should be in cli.md under "### Utility Commands"

Impact

Users are missing out on a useful utility for detecting configuration changes between compilation and execution. The command computes deterministic SHA-256 hashes of workflow frontmatter including:

• All frontmatter fields from the main workflow
• Frontmatter from all imported workflows (BFS traversal)
• Template expressions containing env. or vars. from the markdown body
• Version information (gh-aw, awf, agents)

Suggested Fix

Add documentation section in docs/src/content/docs/setup/cli.md under the "### Utility Commands" section (after the project command documentation):

#### `hash-frontmatter`

Compute a deterministic SHA-256 hash of workflow frontmatter for detecting configuration changes.

```bash wrap
gh aw hash-frontmatter my-workflow.md
gh aw hash-frontmatter .github/workflows/audit-workflows.md
```

The hash includes:
- All frontmatter fields from the main workflow
- Frontmatter from all imported workflows (BFS traversal)
- Template expressions containing env. or vars. from the markdown body
- Version information (gh-aw, awf, agents)

The hash can be used to detect configuration changes between compilation and execution.

Files to Modify

• docs/src/content/docs/setup/cli.md - Add hash-frontmatter command documentation
  Related to [cli-consistency] CLI Consistency Issues - February 6, 2026 #14141

AI generated by CLI Consistency Checker

• expires on Feb 8, 2026, 1:35 PM UTC

[github-actions]

🍪 Issue Monster has assigned this to Copilot!

I've identified this issue as a good candidate for automated resolution and assigned it to the Copilot agent.

The Copilot agent will analyze the issue and create a pull request with the fix.

Om nom nom! 🍪

AI generated by Issue Monster