Skip to content

docs(process): describe the event-driven controller schedule - #1198

Merged
Birfy merged 1 commit into
mainfrom
agent/1197-controller-schedule-docs
Nov 20, 2026
Merged

Birfy merged 1 commit into
mainfrom
agent/1197-controller-schedule-docs

Conversation

@Birfy

@Birfy Birfy commented Nov 20, 2026

Copy link
Copy Markdown
Collaborator

Closes #1197.

What changed

After #1194 the label controller is event-driven, but two sentences in AGENTS.md and the tests/test_process_controller.py module docstring still said it ran every 30 minutes.

  • Merge policy: the controller sets risk:T* on opened / ready_for_review / reopened for a same-repo PR, or on the next four-a-day cron tick for a fork PR.
  • Controller section: it runs on those pull_request events (a fork-head run is skipped) and on a four-a-day cron backstop.
  • The test module docstring matches that schedule.

No change to controller.yml or controller.py.

changelog.d/1197-controller-schedule-docs.md: Changed.

Stale text at 8d75685a

On current main, the sentences this PR replaces are still the pre-#1194 wording:

  • AGENTS.md: "the controller sets the risk:T* label within ~30 minutes."
  • AGENTS.md: the Controller section "runs every 30 minutes".
  • tests/test_process_controller.py: "It runs every 30 minutes with a write token…"

Tip SHA: 9742081

Ran:

  • python -m tools.changelog_fragments check → 9 changelog fragment(s) OK
  • pytest -o addopts="" -p no:cacheprovider -q tests/test_process_controller.py tests/test_process_controller_draft.py tests/test_changelog_fragments.py at this tip → 83 passed

Not run:

  • Full offline suite / test matrix — docstring and process-doc wording only
  • mkdocs build --strict — no docs/ or mkdocs.yml change

Closes #1197

AGENTS.md and the controller test docstring still said the label
controller ran every 30 minutes. After #1194 it labels on opened /
ready_for_review / reopened (same-repo) and on a four-a-day cron
backstop.
@Birfy Birfy added documentation Improvements or additions to documentation area:ci CI workflows, release, packaging and the repo process (.github/, AGENTS.md) agent-pr Pull request opened by an agent labels Nov 20, 2026
@Birfy Birfy self-assigned this Nov 20, 2026
@github-actions github-actions Bot added the risk:T3 Risk tier T3 (core loop, release, process; needs Danyang's click), set by the controller label Nov 20, 2026
@Birfy

Birfy commented Nov 20, 2026

Copy link
Copy Markdown
Collaborator Author

Review (Birfy)

Tip SHA: 9742081
Ran:

  • .github/scripts/risk_gate.py --repo ThinkFlowLab/agentdescent --pr 1198 → T3 (AGENTS.md; 24 lines / 3 files)
  • pytest -o addopts="" -p no:cacheprovider -q tests/test_process_controller.py tests/test_process_controller_draft.py tests/test_changelog_fragments.py at this tip → 83 passed
  • python -m tools.changelog_fragments check → 9 changelog fragment(s) OK
    Not run:
  • Required CI is still in progress at this tip; auto-squash is armed and pinned to this SHA
  • Full offline suite — docstring and process-doc wording only
  • mkdocs build --strict — no docs/ or mkdocs.yml change
    Findings:
  • No actionable defects. This only updates the two stale "every 30 minutes" / "within ~30 minutes" sentences in AGENTS.md (and the matching test docstring) so they match the ci(controller): label PRs on their lifecycle events #1194 triggers: same-repo lifecycle events, fork PRs on the four-a-day cron backstop. Workflow and controller script are untouched.
  • Self-PASS (Birfy) on a Birfy PR, which the merge policy allows.
    Verdict: PASS

@Birfy
Birfy enabled auto-merge (squash) November 20, 2026 22:27
@Birfy
Birfy merged commit 4b46761 into main Nov 20, 2026
12 checks passed
@Birfy
Birfy deleted the agent/1197-controller-schedule-docs branch November 20, 2026 22:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agent-pr Pull request opened by an agent area:ci CI workflows, release, packaging and the repo process (.github/, AGENTS.md) documentation Improvements or additions to documentation risk:T3 Risk tier T3 (core loop, release, process; needs Danyang's click), set by the controller

Projects

None yet

Development

Successfully merging this pull request may close these issues.

AGENTS.md still says the controller runs every 30 minutes

1 participant