From 888cd7d426c48c3eb19c4a86d79039eccc317474 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 20 Apr 2026 23:37:56 +0000
Subject: [PATCH 1/2] Initial plan


From c831a684e5c8a957d49609081264f7ee1b7cda0b Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 20 Apr 2026 23:48:54 +0000
Subject: [PATCH 2/2] docs: fix spec audit mismatches for cli and workflow
 readmes

Agent-Logs-Url: https://github.com/github/gh-aw/sessions/5e0a4ac2-78d7-4048-aec2-b8bd7ab8f30d

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
---
 pkg/cli/README.md      | 6 +++++-
 pkg/workflow/README.md | 2 +-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/pkg/cli/README.md b/pkg/cli/README.md
index 15c2873d363..6025ec58b2d 100644
--- a/pkg/cli/README.md
+++ b/pkg/cli/README.md
@@ -16,7 +16,10 @@ All diagnostic output MUST go to `stderr` using `console` formatting helpers. St
 |---------|-------------|-------------|
 | `gh aw add` | `NewAddCommand` | Add remote or local workflows to the repository |
 | `gh aw add-wizard` | `NewAddWizardCommand` | Interactive wizard for adding workflows |
+| `gh aw new` | `newCmd` (main.go) | Create a new workflow file (supports `--force`, `--interactive`, `--engine`) |
 | `gh aw compile` | (compile_command.go) | Compile `.md` workflow files into GitHub Actions `.lock.yml` |
+| `gh aw enable` | `enableCmd` (main.go) | Enable a workflow |
+| `gh aw disable` | `disableCmd` (main.go) | Disable a workflow |
 | `gh aw run` | `RunWorkflowOnGitHub` (main.go) | Dispatch and monitor workflow runs |
 | `gh aw audit` | `NewAuditCommand` | Audit a specific workflow run by run ID |
 | `gh aw audit diff` | `NewAuditDiffSubcommand` | Diff audit data between multiple runs |
@@ -47,7 +50,8 @@ All diagnostic output MUST go to `stderr` using `console` formatting helpers. St
 | `gh aw secrets set` | (secret_set_command.go) | Create or update a repository secret |
 | `gh aw secrets bootstrap` | (secret_set_command.go) | Validate and configure all required secrets for workflows |
 | `gh aw trial` | `NewTrialCommand` | Run trial workflow executions |
-| `gh aw deps` | (deps_*.go) | Dependency inspection and security advisories |
+| _No `gh aw deps` command_ | `deps_*.go` (internal utilities) | Dependency reporting/advisory helpers used by other commands |
+| `gh aw version` | `versionCmd` (main.go) | Show version information |
 | `gh aw completion` | `NewCompletionCommand` | Generate shell completion scripts |
 
 ## Public API
diff --git a/pkg/workflow/README.md b/pkg/workflow/README.md
index 2f63e4b830e..0325f0fd450 100644
--- a/pkg/workflow/README.md
+++ b/pkg/workflow/README.md
@@ -45,7 +45,7 @@ The package is intentionally large (~320 source files) because it encodes all Gi
 | `WithFailFast(bool)` | Stop at first validation error |
 | `WithWorkflowIdentifier(string)` | Set the workflow identifier |
 | `NewCompiler(opts ...CompilerOption)` | Creates a new `Compiler` |
-| `NewCompilerWithVersion(string)` | Creates a `Compiler` with a specific version |
+| `WithVersion(string) CompilerOption` | Sets a specific compiler version |
 
 ### Engine Architecture