[docs] docs: add awf-config.v1.schema.json references to config spec

[github-actions]

Documentation Sync - May 2026

This PR synchronizes docs/awf-config-spec.md with code changes from the past 7 days.

Changes Made

• Updated docs/awf-config-spec.md: Added documentation for the versioned awf-config.v1.schema.json schema file and a stable-URL pinning reference table, consistent with the information already present in docs/releasing.md.

Code Changes Referenced

• Commit 08cd698: feat: validate config files against published JSON Schema at runtime (#2384) — introduced docs/awf-config.v1.schema.json as a stable versioned copy of the config schema, alongside the existing docs/awf-config.schema.json. The spec only referenced the unversioned file; external consumers should pin to the versioned URL.

Verification

• No code examples changed — documentation-only update
• Reference table format matches docs/releasing.md style
• Consistent with existing documentation style

Generated by Documentation Maintainer · ● 654.3K · ◷

[github-actions]

Documentation Preview

Documentation build failed for this PR. View logs.

Built from commit 6a6e03d

[github-actions]

🔥 Smoke Test: Copilot BYOK (Offline) Mode

Test	Result
GitHub MCP connectivity	✅
GitHub.com HTTP	⚠️ (pre-step data not injected)
File write/read	⚠️ (pre-step data not injected)
BYOK inference (agent → api-proxy → api.githubcopilot.com)	✅

Running in BYOK offline mode (COPILOT_OFFLINE=true) via api-proxy → api.githubcopilot.com.

PR author: @github-actions[bot] · Reviewer: @Mossaka

Overall: PARTIAL PASS (2 tests indeterminate due to unexpanded template vars in workflow)

🔑 BYOK report filed by Smoke Copilot BYOK

[github-actions]

Smoke Test Results

✅ GitHub MCP: PR #2396, PR #2384
✅ Playwright: GitHub page title verified
✅ File Writing: Test file created
✅ Bash Commands: File verified

Status: PASS

💥 [THE END] — Illustrated by Smoke Claude

[github-actions]

🏗️ Build Test Suite Results

Ecosystem	Project	Build/Install	Tests	Status
Bun	elysia	❌	N/A	❌ FAIL
Bun	hono	❌	N/A	❌ FAIL
C++	fmt	❌	N/A	❌ FAIL
C++	json	❌	N/A	❌ FAIL
Deno	oak	❌	N/A	❌ FAIL
Deno	std	❌	N/A	❌ FAIL
.NET	hello-world	❌	N/A	❌ FAIL
.NET	json-parse	❌	N/A	❌ FAIL
Go	color	❌	N/A	❌ FAIL
Go	env	❌	N/A	❌ FAIL
Go	uuid	❌	N/A	❌ FAIL
Java	gson	❌	N/A	❌ FAIL
Java	caffeine	❌	N/A	❌ FAIL
Node.js	clsx	❌	N/A	❌ FAIL
Node.js	execa	❌	N/A	❌ FAIL
Node.js	p-limit	❌	N/A	❌ FAIL
Rust	fd	❌	N/A	❌ FAIL
Rust	zoxide	❌	N/A	❌ FAIL

Overall: 0/8 ecosystems passed — ❌ FAIL

Error Details

All repository clones failed. The gh CLI is not authenticated (GH_TOKEN environment variable not set), so no test repositories could be cloned.

Error:

gh: To use GitHub CLI in a GitHub Actions workflow, set the GH_TOKEN environment variable.

This affected all 8 ecosystems: Bun, C++, Deno, .NET, Go, Java, Node.js, Rust.

Generated by Build Test Suite for issue #2393 · ● 141.6K · ◷

[github-actions]

🔥 Smoke Test Results

Test	Status
GitHub MCP connectivity	✅
GitHub.com connectivity	✅
File write/read	✅ (smoke-test-copilot-25252094462.txt)

Overall: PASS

PR by @github-actions[bot] · Reviewer: @Mossaka

📰 BREAKING: Report filed by Smoke Copilot

[github-actions]

PRs: fix: load schema via require() for pkg/esbuild compat; feat: validate config files against published JSON Schema at runtime
GitHub review ✅
safeinputs-gh ❌
Playwright ✅
Tavily ❌
File write/read ✅
Discussion comment ✅
Build AWF ✅
Overall: FAIL

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• registry.npmjs.org

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "registry.npmjs.org"

See Network Configuration for more information.

🔮 The oracle has spoken through Smoke Codex

[github-actions]

Smoke Test: GitHub Actions Services Connectivity

Check	Result
Redis PING	❌ Timeout (no response)
PostgreSQL pg_isready	❌ No response on port 5432
PostgreSQL SELECT 1	❌ Skipped (pg_isready failed)

Overall: FAIL — host.docker.internal is not reachable from this environment. Service containers may not be running or network access is blocked.

🔌 Service connectivity validated by Smoke Services

[github-actions]

Smoke Test Results: Gemini Engine Validation

• GitHub MCP Connectivity: ✅
  • PR Title: fix: load schema via require() for pkg/esbuild compat
• GitHub.com Connectivity: ✅ (HTTP 200)
• File Write/Read Test: ✅ (Verified content matches)

Overall Status: PASS

CC: @github-actions[bot]

💎 Faceted by Smoke Gemini