Skip to content

[deep-report] Fix 3 frontmatter doc gaps: undocumented max-tool-denials, stale github-app dependencies claim, runs-on-slim macOS example misma #56575

Description

@github-actions

Description

Schema Consistency Checker (#56553, findings 2-4) found three doc/schema mismatches, all verified live:

  1. max-tool-denials is a real, validated frontmatter field (default 5, Copilot-SDK-only) documented in the generated schema reference (frontmatter-full.md:3299-3308) but has no section at all in the main user-facing guide docs/src/content/docs/reference/frontmatter.md.
  2. That same guide's github-app fallback description (frontmatter.md:187-200) claims the fallback applies to a top-level dependencies field — no such field exists anywhere in the schema or pkg/workflow/frontmatter_types.go; this is stale wording.
  3. runs-on-slim's schema-derived reference text inherits the generic github_actions_runs_on definition's prose, which still lists macos-latest-style examples, even though pkg/workflow/runs_on_validation.go:35-82 explicitly rejects macos/macos-* for both runs-on and runs-on-slim.

Expected Impact

Closes 3 concrete doc-accuracy gaps that currently mislead users: a real, useful field is undiscoverable, a nonexistent field is implied configurable, and generated reference text implies a runner option the compiler forbids.

Suggested Agent

New Agent / manual — (1) add a max-tool-denials section to frontmatter.md, (2) remove/correct the dependencies mention in the github-app fallback docs, (3) specialize runs-on-slim's schema description/examples away from the generic macOS-friendly wording.

Estimated Effort

Quick (< 1 hour) — three small, independent doc edits, no code changes.

Data Source

DeepReport analysis 2026-08-28 cycle, from Schema Consistency Checker #56553, findings 2-4.

Warning

Firewall blocked 1 domain

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

  • api.anthropic.com

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

network:
  allowed:
    - defaults
    - "api.anthropic.com"

See Network Configuration for more information.

Generated by 🔬 Deep Report · claude · agent · 131.9 AIC · ⌖ 9.14 AIC · ⊞ 12.4K · ◷

  • expires on Aug 30, 2026, 1:34 AM UTC-08:00

Activity

  1. github-actions commented on Aug 30, 2026

    @github-actions
    ContributorAuthor

    This issue was automatically closed because it expired on 2026-08-30T09:34:09.552Z.

    Closed by Workflow

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions