Add experimental Auggie shared engine as a built-in declarative engine

[Copilot]

This change introduces Augment Code’s Auggie CLI as an experimental first-class engine (engine: auggie) using the shared/declarative engine path (same model as OpenCode), including auth/session secret wiring and default runtime behavior. It also adds repository-level wiring so Auggie is recognized consistently across compile, docs, schema, domains, metadata, and smoke coverage.

• Engine definition and runtime registration

  • Added built-in engine definition: pkg/workflow/data/engines/auggie.md
  • Registered Auggie in the engine registry as a built-in behavior-defined engine
  • Marked as experimental with provider/auth metadata (AUGMENT_SESSION_AUTH)
  • Added Auggie manifest protection (AGENTS.md, .augment/)

• Constants, versions, and model/env metadata

  • Added AuggieEngine constant and engine option metadata
  • Added DefaultAuggieVersion = "0.29.0"
  • Added model env constants:
    • GH_AW_MODEL_AGENT_AUGGIE
    • GH_AW_MODEL_DETECTION_AUGGIE
  • Added native auth env/secret constant: AUGMENT_SESSION_AUTH

• Compiler and platform wiring

  • Added Auggie version lookup + metadata emission paths in compiler lookups
  • Included Auggie in engine model fallback handling (agent default model display semantics)
  • Added Auggie default firewall domains:
    • *.augmentcode.com
    • api.augmentcode.com
    • auth.augmentcode.com
    • d3.augmentcode.com
  • Added auggie to schema examples and engine-related catalog surfaces

• Docs and workflow coverage

  • Updated engines reference docs with Auggie entry, secret, feature matrix row, and pinned version table entry
  • Added smoke workflow and compiled lock file:
    • .github/workflows/smoke-auggie.md
    • .github/workflows/smoke-auggie.lock.yml

• Targeted engine/catalog/test updates

  • Extended engine/catalog/constants/completions/spec/loader/auth tests to include Auggie
  • Updated wasm golden fixtures impacted by new protected manifest folder set (.augment)

engine:
  id: auggie
  version: "0.29.0"   # optional
  model: "<model>"    # optional -> --model

---

Generated by 👨‍🍳 PR Sous Chef · 26.2 AIC · ⌖ 8.22 AIC · ⊞ 7.5K · ◷
_{Comment /souschef to run again}

[pelikhan]

@copilot configure smoke-auggie to use the GitHub model provider

[Copilot]

@copilot configure smoke-auggie to use the GitHub model provider

Updated in 173f1b1. smoke-auggie now uses a GitHub-provider model (engine.model: copilot/claude-sonnet-4.5) and the lock file was recompiled.

[Copilot]

Pull request overview

Adds experimental Auggie CLI support through the declarative engine framework.

Changes:

• Registers Auggie with authentication, model, version, domain, and manifest metadata.
• Updates compiler, schema, documentation, completions, and tests.
• Adds an Auggie smoke workflow and generated lock file.

Show a summary per file

File	Description
pkg/workflow/testdata/TestWasmGolden_CompileFixtures/with-imports.golden	Adds .augment protection output.
pkg/workflow/testdata/TestWasmGolden_CompileFixtures/smoke-copilot.golden	Updates protected-folder golden.
pkg/workflow/testdata/TestWasmGolden_CompileFixtures/playwright-cli-mode.golden	Updates protected-folder golden.
pkg/workflow/testdata/TestWasmGolden_CompileFixtures/basic-copilot.golden	Updates protected-folder golden.
pkg/workflow/testdata/TestWasmGolden_AllEngines/pi.golden	Updates Pi golden output.
pkg/workflow/testdata/TestWasmGolden_AllEngines/gemini.golden	Updates Gemini golden output.
pkg/workflow/testdata/TestWasmGolden_AllEngines/copilot.golden	Updates Copilot golden output.
pkg/workflow/testdata/TestWasmGolden_AllEngines/codex.golden	Updates Codex golden output.
pkg/workflow/testdata/TestWasmGolden_AllEngines/claude.golden	Updates Claude golden output.
pkg/workflow/spec_test.go	Adds Auggie to documented-engine checks.
pkg/workflow/engine_definition_loader_test.go	Tests Auggie declarative loading.
pkg/workflow/engine_catalog_test.go	Adds Auggie catalog expectations.
pkg/workflow/engine_auth_test.go	Adds Auggie auth catalog coverage.
pkg/workflow/domains.go	Defines Auggie network domains.
pkg/workflow/data/engines/auggie.md	Defines Auggie installation and execution.
pkg/workflow/compiler_yaml_step_lifecycle.go	Adds Auggie model metadata lookup.
pkg/workflow/compiler_yaml_lookups.go	Adds Auggie version and model defaults.
pkg/workflow/agentic_engine.go	Registers the declarative engine.
pkg/workflow/agentic_engine_test.go	Tests registry inclusion.
pkg/parser/schemas/main_workflow_schema.json	Adds Auggie schema example.
pkg/constants/version_constants.go	Pins the Auggie CLI version.
pkg/constants/spec_test.go	Tests Auggie constants.
pkg/constants/engine_constants.go	Defines engine, secret, and model constants.
pkg/constants/constants_test.go	Extends engine option tests.
pkg/cli/completions_test.go	Updates completion expectations.
docs/src/content/docs/reference/engines.md	Documents Auggie capabilities.
.github/workflows/smoke-auggie.md	Adds Auggie smoke coverage.
.github/workflows/smoke-auggie.lock.yml	Adds the compiled smoke workflow.

Review details

Tip

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

• Files reviewed: 27/28 changed files
• Comments generated: 6
• Review effort level: Medium

[pelikhan]

@copilot merge main and recompile

[Copilot]

@copilot please run the pr-finisher skill, address the unresolved review feedback below, and rerun checks once the branch is up to date.

Unresolved review threads:...

Updated in 716f617: merged main, recompiled the affected workflow files, and reran local validation (make fmt, make lint, make test-unit, make test, make recompile, make agent-report-progress). CI on this agent-pushed head is still stale until a maintainer re-triggers it.

[gh-aw-bot]

@copilot please run the pr-finisher skill, address unresolved review feedback, and rerun checks once the branch is up to date.

Generated by 👨‍🍳 PR Sous Chef · 9.89 AIC · ⌖ 7.32 AIC · ⊞ 5.1K · ◷
_{Comment /souschef to run again}

[Copilot]

@copilot please run the pr-finisher skill, address unresolved review feedback, and rerun checks once the branch is up to date.

...

Updated in 3366813: merged main, recompiled workflows to resolve the agentic_commands.yml conflict, and reran local validation (make fmt, make lint, make test-unit, make test, make recompile, make agent-report-progress). CI on this agent-pushed head is still unverified until a maintainer re-triggers it.

[gh-aw-bot]

@copilot please run the pr-finisher skill, address unresolved review comments, and rerun checks once the branch is up to date.

Unresolved review threads:

• copilot-pull-request-reviewer: Add experimental Auggie shared engine as a built-in declarative engine #45905 (comment)
• copilot-pull-request-reviewer: Add experimental Auggie shared engine as a built-in declarative engine #45905 (comment)
• copilot-pull-request-reviewer: Add experimental Auggie shared engine as a built-in declarative engine #45905 (comment)
• copilot-pull-request-reviewer: Add experimental Auggie shared engine as a built-in declarative engine #45905 (comment)

Generated by 👨🍳 PR Sous Chef

Generated by 👨‍🍳 PR Sous Chef · 6.64 AIC · ⌖ 6.63 AIC · ⊞ 7.5K · ◷
_{Comment /souschef to run again}

[Copilot]

@copilot please run the pr-finisher skill, address unresolved review comments, and rerun checks once the branch is up to date.

Unresolved review threads:...

Addressed on d21ae16. I verified the unresolved Auggie review threads are already satisfied on the current head, reran local validation (make fmt, make lint, make test-unit, make test, make recompile, make agent-report-progress), and committed the minimal generated workflow drift surfaced by recompile. CI on this agent-pushed head is still unverified until a maintainer re-triggers it.

[gh-aw-bot]

@copilot please run the pr-finisher skill, resolve the remaining unresolved review threads, investigate the failed checks listed below, and rerun checks once the branch is ready.

Unresolved review threads:

• copilot-pull-request-reviewer: Add experimental Auggie shared engine as a built-in declarative engine #45905 (comment)
• copilot-pull-request-reviewer: Add experimental Auggie shared engine as a built-in declarative engine #45905 (comment)
• copilot-pull-request-reviewer: Add experimental Auggie shared engine as a built-in declarative engine #45905 (comment)
• copilot-pull-request-reviewer: Add experimental Auggie shared engine as a built-in declarative engine #45905 (comment)

Failed checks:

• agent: https://github.com/github/gh-aw/actions/runs/29527486160/job/87719980894

The threads already have author follow-up replies; please verify the current HEAD, resolve stale review state where appropriate, and get the remaining checks rerun.

Generated by PR Sous Chef: https://github.com/github/gh-aw/actions/runs/29560675416

Generated by 👨‍🍳 PR Sous Chef · 7.25 AIC · ⌖ 6.05 AIC · ⊞ 7.5K · ◷
_{Comment /souschef to run again}

[pelikhan]

@copilot resolve the merge conflicts in this pull request

[github-actions]

🤖 PR Triage

Field	Value
Category	feature
Risk	high
Score	55/100 (impact:28, urgency:12, quality:15)
Action	fast_track

Rationale: Adds experimental Auggie (Augment Code) as a first-class declarative engine alongside OpenCode. Large feature with auth/session secret wiring. CI still running. Needs careful human review of engine wiring before merge.

Generated by 🔧 PR Triage Agent · 166.4 AIC · ⌖ 6.15 AIC · ⊞ 5.6K · ◷

[Copilot]

@copilot please run the pr-finisher skill, resolve the remaining unresolved review threads, investigate the failed checks listed below, and rerun checks once the branch is ready.

Unresolved review ...

Updated in cfc819c.

The listed Copilot review threads are already resolved on the current HEAD, and I fixed the remaining agent failure by switching /home/runner/work/gh-aw/gh-aw/.github/workflows/smoke-auggie.md and /home/runner/work/gh-aw/gh-aw/.github/workflows/dev.md to model-provider: github with the bare claude-sonnet-4.5 model token, then recompiling the affected lock files.

Local validation passed: make fmt, make lint, make test-unit, make test, make recompile, and make agent-report-progress. CI on this agent-pushed head is still stale and needs a maintainer re-trigger.

[Copilot]

@copilot resolve the merge conflicts in this pull request

Resolved in 08702cc: merged main, fixed the merge conflicts, recompiled the generated workflow files, and reran local validation (make build, make recompile, targeted go test, and make agent-report-progress).