feat(cli): JSON workflow importer - trigger/tool/permissions mapping by pelikhan · Pull Request #33376 · github/gh-aw

pelikhan · 2026-05-19T17:49:58Z

Why

The add --wizard command can import workflows from JSON payloads (Copilot automation API). Previously, the prompt, triggers, tools, and permissions fields all fell through to unrecognized-field comments rather than being translated into first-class gh-aw frontmatter. This PR completes that mapping.

What changed

Trigger mapping (triggers -> on:)

interval: hourly/daily/weekly -> gh-aw fuzzy schedule expressions (every 1h, daily, weekly) -- NOT raw cron; the compiler randomises cron at compile time
Single interval trigger emits the inline shorthand (on: daily); multiple triggers use the map form
issues -> on: issues: types: [...]; warns when query filter is present (no gh-aw equivalent)
workflow_run -> on: workflow_run: workflows: [...] types: [...]; warns on conclusions filter

Tool mapping (tools -> tools:)

40-entry lookup table maps GitHub tool IDs to gh-aw toolsets (issues, pull-requests, repos, etc.)
execute -> bash: "*" (with a review warning)
web_search -> web-search: (direct mapping, underscore->hyphen normalised)
Built-in read/edit/search tools are silently skipped (no config needed)
Unknown tools emit a per-tool warning

Other fields

prompt is used as the workflow body when instructions is absent
permissions map is passed through to the permissions: frontmatter block

Test coverage

Two anonymized real-world API payloads are used as test cases:

IntervalTrigger - single interval trigger, prompt-as-body
MultiTriggerWithTools - issues + workflow_run triggers, tool migration, permissions, Extra warnings

…apping - Extends ConvertJSONWorkflowToMarkdown to handle prompt, triggers, tools, and permissions fields from Copilot automation JSON payloads - Maps interval triggers to gh-aw fuzzy schedule expressions (every 1h / daily / weekly) instead of raw cron - Maps issues and workflow_run triggers to on: frontmatter blocks - Maps GitHub tool IDs to tools: github: toolsets: [...] via a 40-entry lookup table; execute -> bash: "*"; web_search -> web-search: - Passthrough permissions map to permissions: frontmatter - Falls back to prompt field for workflow body when instructions absent - Adds two real-world anonymized test cases from the automation API Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Completes the add --wizard JSON workflow importer by translating previously “unknown” JSON fields (prompt, triggers, tools, permissions) into first-class gh-aw frontmatter/body output, with warnings where gh-aw lacks an equivalent.

Changes:

Adds structured trigger conversion (triggers → on:) including interval shorthand and multi-trigger map emission.
Adds tool ID mapping (tools → tools:) with a lookup table + special cases (execute → bash: "*", web_search → web-search:).
Adds prompt-as-body fallback and permissions passthrough (permissions → permissions:), plus new tests for real-world payloads.

Show a summary per file

File	Description
pkg/cli/jsonworkflow_to_markdown.go	Implements triggers/tools/permissions/prompt mapping into markdown frontmatter/body, including conversion helpers and warnings.
pkg/cli/jsonworkflow_to_markdown_test.go	Adds importer test cases covering interval triggers, multi-trigger conversion, tool mapping, permissions, and warnings.

Copilot's findings

Tip

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

Files reviewed: 2/2 changed files
Comments generated: 1

+		wfEntry := map[string]any{
+			"workflows": t.WorkflowRun.Workflows,
+			"types":     t.WorkflowRun.Types,
+		}
+		if len(t.WorkflowRun.Conclusions) > 0 {
+			warnings = append(warnings, `triggers.workflow_run.conclusions has no gh-aw equivalent; review the generated "on:" block`)
+		}
+		parts["workflow_run"] = wfEntry


pelikhan · 2026-05-19T17:59:24Z

@copilot review all comments, lint go

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2026-05-19T18:11:40Z

@copilot review all comments, lint go

Addressed in 330a650. I reviewed the prior actionable feedback, now skip incomplete workflow_run imports unless both workflows and types are present, added a regression test, and make golint / go test ./pkg/cli both pass.

pelikhan · 2026-05-19T18:17:24Z

@copilot fix lint, format code https://github.com/github/gh-aw/actions/runs/26116030916/job/76806717111?pr=33376

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2026-05-19T18:24:14Z

@copilot fix lint, format code https://github.com/github/gh-aw/actions/runs/26116030916/job/76806717111?pr=33376

Addressed in b79223e. I checked the linked CI job, reproduced the failing lint-cjs Prettier check locally, formatted actions/setup/js/create_pull_request.cjs, and re-ran the formatting gate plus make golint successfully.

github-actions · 2026-05-19T18:33:52Z

✅ smoke-ci: safeoutputs CLI comment + comment-memory run (26117227063)

Generated by 🧪 Smoke CI for issue #33376 · ◷

…l default - setup/cli.md: add JSON workflow importer field mapping table (triggers, tools, permissions, prompt) for `gh aw add` and `gh aw add-wizard` (PR #33376). - reference/model-tables.md: add `gemini-3.5-flash` (multiplier 14) to the Google table (PR #33430). - reference/safe-outputs.md: describe the default collapsed `<details>` disclosure produced by the `footer-install` template (PR #33368). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Copilot AI review requested due to automatic review settings May 19, 2026 17:49

Copilot started reviewing on behalf of pelikhan May 19, 2026 17:50 View session

This comment has been minimized.

Sign in to view

Copilot AI reviewed May 19, 2026

View reviewed changes

Copilot started work on behalf of pelikhan May 19, 2026 17:59 View session

Copilot AI and others added 2 commits May 19, 2026 18:05

chore: start review follow-up

dff07b9

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

fix(cli): validate imported workflow_run triggers

330a650

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot finished work on behalf of pelikhan May 19, 2026 18:12

Copilot started work on behalf of pelikhan May 19, 2026 18:17 View session

Copilot AI and others added 2 commits May 19, 2026 18:21

chore: start ci lint follow-up

152068d

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

style(js): format create pull request handler

b79223e

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot finished work on behalf of pelikhan May 19, 2026 18:24

Merge branch 'main' into pelikhan/get-automation-api

258937f

pelikhan merged commit cbe9b26 into main May 19, 2026
13 of 14 checks passed

pelikhan deleted the pelikhan/get-automation-api branch May 19, 2026 18:31

github-actions Bot mentioned this pull request May 20, 2026

[docs] Update documentation for features from 2026-05-20 #33522

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(cli): JSON workflow importer - trigger/tool/permissions mapping#33376

feat(cli): JSON workflow importer - trigger/tool/permissions mapping#33376
pelikhan merged 6 commits into
mainfrom
pelikhan/get-automation-api

pelikhan commented May 19, 2026

Uh oh!

This comment has been minimized.

This comment has been minimized.

Copilot AI left a comment

Uh oh!

pelikhan commented May 19, 2026

Uh oh!

Copilot AI commented May 19, 2026

Uh oh!

pelikhan commented May 19, 2026

Uh oh!

Copilot AI commented May 19, 2026

Uh oh!

Uh oh!

github-actions Bot commented May 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

pelikhan commented May 19, 2026

Why

What changed

Test coverage

Uh oh!

This comment has been minimized.

This comment has been minimized.

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Copilot's findings

Uh oh!

pelikhan commented May 19, 2026

Uh oh!

Copilot AI commented May 19, 2026

Uh oh!

pelikhan commented May 19, 2026

Uh oh!

Copilot AI commented May 19, 2026

Uh oh!

Uh oh!

github-actions Bot commented May 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants