docs: Update documentation for features from November 15, 2025

This commit updates the documentation based on features merged in the last 24 hours.

## Features Documented

### 1. Cross-repository --repo flag (PR #4007)
- Added --repo option to enable, disable, and logs commands
- Enables workflow management operations across different repositories
- Updated CLI reference with examples and option descriptions

### 2. Workflow description extraction (PR #4008)
- Documents that add and trial commands now display workflow descriptions
- Descriptions are extracted from frontmatter description field
- Provides better context about workflow purpose when adding or testing

### 3. Import cache for offline compilation (PR #3981)
- Remote imports are automatically cached in .github/aw/imports/
- Cache stores imports by commit SHA for efficient reuse
- Enables offline compilation once imports have been downloaded
- Updated CLI, imports reference, and packaging guides

### 4. "Did You Mean" schema validation suggestions (PR #3999)
- Compiler suggests correct field names for typos using fuzzy matching
- Based on Levenshtein distance algorithm
- Added tip callout and new error documentation section
- Includes examples of common typos detected

## Files Modified

- docs/src/content/docs/setup/cli.md
- docs/src/content/docs/reference/imports.md
- docs/src/content/docs/guides/packaging-imports.md
- docs/src/content/docs/troubleshooting/errors.md

## Related PRs

- #4007 - Add --repo options to more commands
- #4008 - Add workflow description extraction feature
- #3981 - Add import cache for offline workflow compilation
- #3999 - Implement 'Did You Mean' suggestions for schema validation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: github-actions[bot]

docs/src/content/docs/guides/packaging-imports.md

@@ -46,6 +46,8 @@ imports:
 
 During `gh aw add`, imports are expanded to track source repository (e.g., `shared/common-tools.md` becomes `githubnext/agentics/shared/common-tools.md@abc123def`).
 
+Remote imports are automatically cached in `.github/aw/imports/` by commit SHA. This enables offline workflow compilation once imports have been downloaded. The cache is shared across different refs pointing to the same commit, reducing redundant downloads.
+
 ## Example: Modular Workflow with Imports
 
 Create a shared MCP server configuration in `.github/workflows/shared/mcp/tavily.md`:

docs/src/content/docs/reference/imports.md

@@ -45,6 +45,18 @@ Import paths support local files (`shared/file.md`, `../file.md`), remote reposi
 
 Paths are resolved relative to the importing file, with support for nested imports and circular import protection.
 
+## Import Cache
+
+Remote imports are automatically cached in `.github/aw/imports/` to enable offline compilation. The cache stores imports by commit SHA, allowing different refs (branches, tags) pointing to the same commit to share cached files.
+
+When compiling workflows with remote imports:
+- First compilation downloads the import and stores it in the cache
+- Subsequent compilations use the cached file, eliminating network calls
+- Cache is organized by owner/repo/sha/path for efficient lookups
+- Local imports are never cached and are always read from the filesystem
+
+The cache directory is git-tracked and automatically configured with `.gitattributes` to mark cached files as generated content with conflict-free merge behavior.
+
 ## Agent Files
 
 Import custom agent files from `.github/agents/` to customize AI engine behavior. Agent files are markdown documents with specialized instructions that modify how the AI interprets and executes workflows.

docs/src/content/docs/setup/cli.md

@@ -98,6 +98,8 @@ gh aw add ci-doctor --dir shared --number 3      # Organize and create copies
 gh aw add ci-doctor --pr                         # Create PR instead of direct commit
 ```
 
+When adding a workflow, the command displays the workflow description (extracted from the frontmatter `description` field) to provide context about the workflow's purpose.
+
 **Options:**
 - `--dir`: Organize workflows in subdirectories
 - `--number`: Create multiple numbered copies
@@ -132,6 +134,8 @@ gh aw compile --dependabot                 # Generate dependency manifests
 gh aw compile --purge                      # Remove orphaned .lock.yml files
 ```
 
+Remote imports are automatically cached in `.github/aw/imports/` for offline compilation. First compilation downloads imports; subsequent compilations use cached files, eliminating network calls.
+
 **Key Options:**
 
 | Option | Description |
@@ -159,6 +163,8 @@ gh aw trial ./issue-workflow.md --trigger-context "#123" # With issue context
 gh aw trial ./workflow.md --repo owner/repo        # Run directly in repository
 ```
 
+When trialing a workflow, the command displays the workflow description (extracted from the frontmatter `description` field) to provide context about what the workflow does.
+
 **Key Options:**
 
 | Option | Description |
@@ -219,17 +225,20 @@ gh aw logs                                 # Download logs for all workflows
 gh aw logs workflow-name                   # Download logs for specific workflow
 gh aw logs -c 10 --start-date -1w         # Filter by count and date
 gh aw logs --parse --json                 # Generate markdown + JSON output
+gh aw logs workflow-name --repo owner/repo # Download logs from specific repository
 ```
 
 **Key Options:**
 
 | Option | Description | Example |
 |--------|-------------|---------|
 | `-c, --count N` | Limit number of runs | `-c 10` |
+| `-e, --engine` | Filter by AI engine | `-e copilot` |
 | `--start-date` | Filter runs from date | `--start-date -1w` |
 | `--end-date` | Filter runs until date | `--end-date -1d` |
 | `--parse` | Generate `log.md` and `firewall.md` | `--parse` |
 | `--json` | Output structured metrics | `--json` |
+| `--repo owner/repo` | Download logs from specific repository | `--repo owner/repo` |
 
 Downloads workflow execution logs, analyzes tool usage and network patterns, and caches results for faster subsequent runs (~10-100x speedup).
 
@@ -257,10 +266,14 @@ Enable workflows for execution.
 gh aw enable                                # Enable all workflows
 gh aw enable prefix                         # Enable workflows matching prefix
 gh aw enable ci-*                          # Enable workflows with pattern
+gh aw enable workflow-name --repo owner/repo # Enable in specific repository
 ```
 
 Enables workflows for automatic and manual execution with pattern matching support for bulk operations.
 
+**Options:**
+- `--repo owner/repo`: Enable workflows in a specific repository (defaults to current repository)
+
 #### `disable`
 
 Disable workflows and cancel running jobs.
@@ -269,10 +282,14 @@ Disable workflows and cancel running jobs.
 gh aw disable                               # Disable all workflows
 gh aw disable prefix                        # Disable workflows matching prefix
 gh aw disable ci-*                         # Disable workflows with pattern
+gh aw disable workflow-name --repo owner/repo # Disable in specific repository
 ```
 
 Disables workflows to prevent execution and cancels any currently running workflow jobs.
 
+**Options:**
+- `--repo owner/repo`: Disable workflows in a specific repository (defaults to current repository)
+
 #### `remove`
 
 Remove workflows from the repository.

docs/src/content/docs/troubleshooting/errors.md

@@ -11,6 +11,10 @@ This reference documents common error messages encountered when working with Git
 
 Schema validation errors occur when the workflow frontmatter does not conform to the expected JSON schema. These errors are detected during the compilation process.
 
+:::tip[Typo Detection]
+When you make a typo in frontmatter field names, the compiler automatically suggests correct field names using fuzzy matching. Look for "Did you mean" suggestions in error messages to quickly identify and fix common typos like `permisions` → `permissions` or `engnie` → `engine`.
+:::
+
 ### Frontmatter Not Properly Closed
 
 **Error Message:**
@@ -81,6 +85,40 @@ timeout-minutes: "10"
 timeout-minutes: 10
 ```
 
+### Unknown Property
+
+**Error Message:**
+```
+Unknown property: permisions. Did you mean 'permissions'?
+```
+
+**Cause:** A field name in the frontmatter is not recognized by the schema validator, often due to a typo.
+
+**Solution:** Use the suggested field name from the error message. The compiler uses fuzzy matching to suggest the most likely correct field names based on edit distance.
+
+```yaml wrap
+# Incorrect - typo in field name
+---
+on: issues
+permisions:  # Typo
+  contents: read
+---
+
+# Correct
+---
+on: issues
+permissions:
+  contents: read
+---
+```
+
+**Common typos detected:**
+- `permisions` → `permissions`
+- `engnie` → `engine`
+- `toolz` → `tools`
+- `timeout_minute` → `timeout-minutes`
+- `runs_on` → `runs-on`
+
 ### Imports Field Must Be Array
 
 **Error Message:**