docs: document JSON importer mapping, gemini-3.5-flash, footer-install default (#33522)

Author: github-actions[bot]

docs/src/content/docs/reference/model-tables.md

@@ -182,6 +182,7 @@ Before per-model multipliers are applied, raw token counts are weighted by token
 | `gemini-3.1-flash-lite-preview` | 0.1 |
 | `gemini-3.1-flash-image-preview` | 0.33 |
 | `gemini-3.1-flash-tts-preview` | 0.1 |
+| `gemini-3.5-flash` | 14 |
 | `gemini-2.5-computer-use-preview` | 0.2 |
 | `gemini-2.5-computer-use-preview-10-2025` | 0.2 |
 | `gemini-robotics-er-1.5-preview` | 0.2 |

docs/src/content/docs/reference/safe-outputs.md

@@ -1603,6 +1603,8 @@ safe-outputs:
 
 **Options**: `append-only-comments` (default: `false`)
 
+The `footer-install` template renders the install instructions that follow the footer attribution line. When a workflow source is available and no custom template is set, the default renders as a collapsed `<details>` disclosure with the summary `Add this agentic workflows to your repo`; the expanded block contains the `gh aw add {workflow_source}` command. Custom `footer-install` overrides bypass the disclosure wrapper, so include `<details>` markup explicitly if you want the same collapsed UX. Supported placeholders: `{workflow_source}`, `{workflow_source_url}`.
+
 **Variables**: `{workflow_name}`, `{run_url}`, `{agentic_workflow_url}`, `{triggering_number}`, `{workflow_source}`, `{workflow_source_url}`, `{event_type}`, `{status}`, `{operation}`, `{effective_tokens}`, `{effective_tokens_formatted}`, `{effective_tokens_suffix}`
 
 `{effective_tokens}` contains the raw total effective token count for the run (e.g. `1200`), and `{effective_tokens_formatted}` is the compact human-readable form (e.g. `1.2K`, `3M`). Both are only present when the effective token count is greater than zero. `{effective_tokens_suffix}` is a pre-formatted, always-safe suffix string (e.g. `" · ● 1.2K"` or `""`) that can be inserted directly into footer templates alongside `{history_link}`. The default footer automatically includes the formatted value — use these variables in custom footer templates to include token usage in your own format. See [Effective Tokens Specification](/gh-aw/reference/effective-tokens-specification/) for details on how effective tokens are computed.

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

@@ -176,6 +176,21 @@ Repository-level packages can declare an [`aw.yml` manifest](/gh-aw/reference/aw
 
 `add` and `add-wizard` also accept arbitrary `http(s)://` URLs. The fetched response is dispatched by `Content-Type`: `text/markdown` (and `text/x-markdown`) is installed as a raw gh-aw workflow, and `application/json` (or any `*+json` suffix) is converted to a workflow markdown file before installation. Unknown content types produce an actionable error listing the detected type. For non-GitHub hosts, no include/dispatch-workflow dependency resolution is performed, and no GitHub authentication token is sent to the remote server.
 
+##### JSON Workflow Field Mapping
+
+When importing a JSON workflow definition (for example, a payload from the Copilot automation API), the importer translates JSON fields into gh-aw frontmatter and workflow body:
+
+| JSON field | Mapped to | Notes |
+|------------|-----------|-------|
+| `triggers.interval` | `on:` (fuzzy schedule) | `hourly` → `every 1h`, `daily` → `daily`, `weekly` → `weekly`. A single interval trigger emits the inline shorthand (`on: daily`); the compiler randomizes cron at compile time. |
+| `triggers.issues` | `on.issues.types` | A `query` filter has no gh-aw equivalent and emits a per-field warning. |
+| `triggers.workflow_run` | `on.workflow_run` (`workflows`, `types`) | A `conclusions` filter emits a per-field warning. |
+| `tools` | `tools:` | A 40-entry lookup maps GitHub tool IDs to gh-aw toolsets (`issues`, `pull-requests`, `repos`, etc.). `execute` maps to `bash: "*"` (with a review warning); `web_search` maps to `web-search:`. Built-in read/edit/search tools are silently skipped. Unrecognized tools emit a per-tool warning. |
+| `permissions` | `permissions:` | Passed through unchanged. |
+| `prompt` | Workflow body | Used when an `instructions` field is absent. |
+
+Unrecognized fields are preserved as commented hints in the generated workflow.
+
 #### `new`
 
 Create a workflow template in `.github/workflows/`. Opens for editing automatically.