Skip to content

Support epics and human checkpoints - #33

Merged
chrisbanes merged 2 commits into
mainfrom
cb/project-human-frontier
Aug 1, 2026
Merged

Support epics and human checkpoints#33
chrisbanes merged 2 commits into
mainfrom
cb/project-human-frontier

Conversation

@chrisbanes

Copy link
Copy Markdown
Owner

Summary

  • add configured epic and human-work roles to run-github-project
  • expose ready epics, human actions, and waiting-for-human frontier behavior
  • document controller reconciliation and add deterministic ranker coverage

Why

Coordination parents and human gates previously appeared only as blocked or triage work, preventing the drain from expressing actionable manual checkpoints while independent leaf work continued.

Validation

  • python3 skills/run-github-project/scripts/test_rank_tickets.py (65 tests)
  • npm run lint
  • python3 /Users/chris/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/run-github-project
  • git diff --check origin/main...HEAD
  • repeated review-and-simplify-changes, code-review, and ponytail-review

@chrisbanes
chrisbanes marked this pull request as ready for review August 1, 2026 18:24

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 40f6f79b4d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +1117 to +1120
or (
isinstance(ticket["labels"], list)
and args.human_work_label in ticket["labels"]
)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Keep malformed assigned human work out of planning claims

When a Backlog human-work issue is assigned to the authenticated user and any normalized field raises InputError (for example, a missing projectPosition), this new branch identifies it as human work, but the exception path subsequently classifies every current-user Backlog assignment as blockedPlanningClaims. The scheduler treats that collection as unresolved runner work and prevents triage, even though valid assigned human work is deliberately not a runner claim. Preserve the human-work role during error classification so these entries remain frontier/excluded items, and cover the malformed assigned-human counterexample.

AGENTS.md reference: AGENTS.md:L18-L18

Useful? React with 👍 / 👎.

Comment on lines +89 to +91
Finish successfully only when the ordinary drain finish gate passes and no
human action remains. Return partial drain only for a failed, ambiguous,
blocked, or timed-out claimed lane. Never call a human frontier a failure or

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Preserve partial-drain results for triage failures

When the triage provider cannot complete an eligible item, drain-scheduler.md explicitly requires a partial-drain report, but this finish gate limits partial drain to failures in a claimed lane; the triage lane has no claim. This leaves conflicting outcome instructions, particularly when human actions also remain, so include triage-provider failures in this partial-drain condition or explicitly defer to the scheduler's authoritative finish gate.

AGENTS.md reference: AGENTS.md:L16-L16

Useful? React with 👍 / 👎.

@greptile-apps

greptile-apps Bot commented Aug 1, 2026

Copy link
Copy Markdown

Greptile Summary

The PR extends run-github-project with configured epic reconciliation and resumable human checkpoints while preserving independent autonomous work.

  • Adds ranker outputs for ready epics, human actions, and role-tagged blocked work.
  • Defines controller reconciliation, human-frontier, and waiting-for-human behavior.
  • Updates configuration, workflow documentation, and deterministic ranker coverage.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename Overview
skills/run-github-project/scripts/rank_tickets.py Adds validated Backlog role classification and separate outputs for epics, human actions, triage candidates, and blocked frontier work.
skills/run-github-project/scripts/test_rank_tickets.py Adds deterministic coverage for epic readiness, human gates, dependency parking, conflicting roles, and assigned human work.
skills/run-github-project/references/human-frontier.md Defines classification, reconciliation, reporting, resumption, and finish semantics for epics and human checkpoints.
skills/run-github-project/SKILL.md Integrates the new frontier into startup validation, scheduling, authority checks, reconciliation, and reporting.
skills/run-github-project/references/drain-scheduler.md Places epic reconciliation in the controller lane and adds waiting-for-human behavior to the drain finish gate.

Reviews (2): Last reviewed commit: "Address human frontier review feedback" | Re-trigger Greptile

@chrisbanes
chrisbanes merged commit 8a15fa5 into main Aug 1, 2026
2 checks passed
@chrisbanes
chrisbanes deleted the cb/project-human-frontier branch August 1, 2026 19:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant