Skip to content

agentic-wiki-writer: Step 2c PR creation blocked by default .github/ protected path prefix #320

Description

@isaakd

Problem

workflows/agentic-wiki-writer.md Step 2c instructs the agent to create a PR adding .github/agentic-wiki/PAGES.md. That PR is unconditionally blocked by the create-pull-request safe-output, because .github/ is in the default protected-path-prefixes.

Reproduction

First-run of the workflow in a repo that has no .github/agentic-wiki/PAGES.md yet.

Agent correctly runs Step 2c and calls create_pull_request with a patch adding .github/agentic-wiki/PAGES.md. Safe-output handler then emits:

Cannot create pull request: patch modifies protected files (.github/agentic-wiki/PAGES.md).
Add them to the allowed-files configuration field or set protected-files: fallback-to-issue
to create a review issue instead.

Full failure log: https://github.com/tidyhq/TidyClub/actions/runs/24343140201

Downstream effect: the manager also cancels the queued push_wiki output ("Code push operation 'create_pull_request' failed — remaining safe outputs will be cancelled"), so the wiki never gets pushed either, even on subsequent runs where PAGES.md already exists — the agent still tries a Step 3h fix-up PR.

Proposed fix

Scope create-pull-request to the template directory and opt in to writing protected paths in the frontmatter:

safe-outputs:
  create-pull-request:
    title-prefix: "[agentic-wiki]"
    labels: [documentation, automated]
    allowed-files:
      - ".github/agentic-wiki/**"
    protected-files: allowed

allowed-files scopes the PR to only the template directory; protected-files: allowed is required independently because .github/ is in protected-path-prefixes (per the comment in actions/setup/js/manifest_file_helpers.cjs in gh-aw: "neither overrides the other implicitly").

Verified the fix locally against v0.68.3 — compiled config now includes "allowed_files":[".github/agentic-wiki/**"] and "protected_files_policy":"allowed", and the Step 2c PR creation is expected to succeed on next run.

Happy to open a PR if useful.

Activity

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

Metadata

Metadata

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions