Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/docs/features/pr-status.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,16 +54,16 @@ GitHub's pull request list shows only titles, labels and a check icon, so ProPR
| State | Title |
| --- | --- |
| `working` | `🔨 [3475 by Claude Opus 5.5] Let an automation run when a plan issue is blocked` |
| `needs_attention` | `⚠️⑥ [3475 by Claude Opus 5.5] …`, with the latest review score (① to ⑩) when there is one |
| `ready` | `✅⑧ [3510 by Claude Opus 5.5] Apply library extensions automatically…`, with the latest review score when there is one |
| `needs_attention` | `⚠️➅ [3475 by Claude Opus 5.5] …`, with the latest review score (➀ to ➉) when there is one |
| `ready` | `✅➇ [3510 by Claude Opus 5.5] Apply library extensions automatically…`, with the latest review score when there is one |

The slot is one emoji, the score beside ⚠️ and ✅, then a single space and the title exactly as it was. An epic pull request follows the emoji with its progress, and shows a pie circle in place of 🔨 while it is working; see [Epic pull requests](#epic-pull-requests). A `none` pull request has no slot.
The slot is one emoji, the score beside ⚠️ and ✅, then a single space and the title exactly as it was. The score uses the Dingbats circled digits ➀ to ➉. A title still showing an older ① to ⑩ score is recognised and gets the new digit on its next rename. An epic pull request follows the emoji with its progress, and shows a pie circle in place of 🔨 while it is working; see [Epic pull requests](#epic-pull-requests). A `none` pull request has no slot.

Every title change adds a "changed the title" entry to the timeline, so the title changes far less often than the body line:

- A new pull request is created with `🔨` already in its title, so creation costs no rename.
- The title changes only when the state changes, or when the score beside ⚠️ or ✅ changes. Activity inside `working` (a review starting, the next Ultrafix cycle, waiting for CI) never renames the pull request; that detail is in the body line.
- ProPR writes ⚠️ or ✅ only once the state has held for about 30 seconds and nothing for the pull request is queued or about to start. The short gap between an Ultrafix review and its fix, or between a failed check and its CI follow-up, costs no rename. Going back to `🔨` (for example when you post a follow-up on a `✅⑧` pull request) is immediate.
- ProPR writes ⚠️ or ✅ only once the state has held for about 30 seconds and nothing for the pull request is queued or about to start. The short gap between an Ultrafix review and its fix, or between a failed check and its CI follow-up, costs no rename. Going back to `🔨` (for example when you post a follow-up on a `✅➇` pull request) is immediate.
- No change is sent when the title is already right. When ProPR changes both the body line and the title, it does so in one update.
- ProPR only ever replaces the slot it recognises at the start of the title. Your edits to the rest of the title are kept. If you remove the slot, it stays off until the state changes. ProPR also leaves the title alone when adding the slot would take it past GitHub's 256-character limit.
- When the pull request is merged or closed, ProPR removes the slot: one final rename, so closed pull request lists and release notes stay clean.
Expand Down
2 changes: 1 addition & 1 deletion packages/api/test/mcpMergePreconditions.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -185,7 +185,7 @@ test('executeTool persists specific PR state failures and get_operation returns
if (route === 'GET /repos/{owner}/{repo}/pulls/{pull_number}') {
requestedPull = Number(args.pull_number);
if (requestedPull === 43) return { data: rest({ number: 43, state: 'closed', closed_at: '2026-09-27T12:00:00Z' }) };
if (requestedPull === 45) return { data: rest({ number: 45, title: '✅⑧ [12 by Claude Opus 5.5] Add retries' } as PullRequestStateSource) };
if (requestedPull === 45) return { data: rest({ number: 45, title: '✅➇ [12 by Claude Opus 5.5] Add retries' } as PullRequestStateSource) };
if ([44, 46, 47, 48, 49].includes(requestedPull)) return { data: rest({ number: requestedPull }) };
if (requestedPull === 50) throw Object.assign(new Error('Server Error'), {
name: 'HttpError', status: 502, response: { status: 502, headers: {}, data: { message: 'Server Error' } },
Expand Down
18 changes: 9 additions & 9 deletions packages/core/test/pullRequestStatusTitle.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -203,7 +203,7 @@ test('creation costs no rename, and a full Ultrafix loop to the goal with passin
await syncSettled();
await syncSettled();

assert.deepEqual(github.renames, [`✅⑧ ${TITLE}`]);
assert.deepEqual(github.renames, [`✅➇ ${TITLE}`]);
});

test('checks pending keep 🔨; a failure without follow-up shows ⚠️, passing checks show ✅', async () => {
Expand All @@ -218,12 +218,12 @@ test('checks pending keep 🔨; a failure without follow-up shows ⚠️, passin
assert.equal(github.pull.title, `🔨 ${TITLE}`, '⚠️ is held until it settles');
await new Promise(resolve => setTimeout(resolve, SETTLE_MS + 10));
await sync();
assert.equal(github.pull.title, `⚠️⑧ ${TITLE}`);
assert.equal(github.pull.title, `⚠️➇ ${TITLE}`);

github.checkRuns = [{ name: 'unit', status: 'completed', conclusion: 'success' }];
await syncSettled();
assert.equal(github.pull.title, `✅⑧ ${TITLE}`);
assert.deepEqual(github.renames, [`⚠️⑧ ${TITLE}`, `✅⑧ ${TITLE}`]);
assert.equal(github.pull.title, `✅➇ ${TITLE}`);
assert.deepEqual(github.renames, [`⚠️➇ ${TITLE}`, `✅➇ ${TITLE}`]);
});

test('a brief ⚠️ between a failed check and its queued follow-up costs no rename', async () => {
Expand All @@ -245,7 +245,7 @@ test('a follow-up on a ✅ pull request renames it to 🔨 at once and back only
await addTask('issue', 'completed');
await addScore(8);
await syncSettled();
assert.equal(github.pull.title, `✅⑧ ${TITLE}`);
assert.equal(github.pull.title, `✅➇ ${TITLE}`);

const followUp = await addTask('pr-comment', 'processing', { comments: [{ commandMode: 'default' }] });
await sync();
Expand All @@ -256,8 +256,8 @@ test('a follow-up on a ✅ pull request renames it to 🔨 at once and back only
assert.equal(github.pull.title, `🔨 ${TITLE}`, 'still 🔨 while the checks of the follow-up run');
github.checkRuns = [{ name: 'unit', status: 'completed', conclusion: 'success' }];
await syncSettled();
assert.equal(github.pull.title, `✅⑧ ${TITLE}`);
assert.deepEqual(github.renames, [`✅⑧ ${TITLE}`, `🔨 ${TITLE}`, `✅⑧ ${TITLE}`]);
assert.equal(github.pull.title, `✅➇ ${TITLE}`);
assert.deepEqual(github.renames, [`✅➇ ${TITLE}`, `🔨 ${TITLE}`, `✅➇ ${TITLE}`]);
});

test('a person\'s edit to the rest of the title survives later state changes', async () => {
Expand All @@ -267,7 +267,7 @@ test('a person\'s edit to the rest of the title survives later state changes', a
await setTaskState(implementation, 'completed');
await addScore(9);
await syncSettled();
assert.equal(github.pull.title, '✅⑨ [12 by Claude Opus 5.5] A better title, by a person');
assert.equal(github.pull.title, '✅➈ [12 by Claude Opus 5.5] A better title, by a person');
});

test('a slot a person removed comes back on the next state change, not before', async () => {
Expand Down Expand Up @@ -403,7 +403,7 @@ test('the edited webhook of a ProPR rename causes no further write or work', asy
});

test('[Epic] detection accepts titles with and without the slot', () => {
for (const slot of ['', '🔨 ', '⚠️⑥ ', '⚠ ', '✅⑧ ', '🔨 3/5 ', '○ 0/5 ', '◔ 1/5 ', '◑ 3/5 ', '◕ 4/5 ', '⚠️ 4/5 ', '✅ 5/5 ']) assert.equal(isEpicPullRequestTitle(`${slot}[Epic] Plan`), true, slot);
for (const slot of ['', '🔨 ', '⚠️➅ ', '⚠ ', '✅➇ ', '🔨 3/5 ', '○ 0/5 ', '◔ 1/5 ', '◑ 3/5 ', '◕ 4/5 ', '⚠️ 4/5 ', '✅ 5/5 ']) assert.equal(isEpicPullRequestTitle(`${slot}[Epic] Plan`), true, slot);
assert.equal(isEpicPullRequestTitle('Not an [Epic]'), false);
assert.equal(isEpicPullRequestTitle(null), false);
});
21 changes: 14 additions & 7 deletions packages/shared/src/prTitleStatusSlot.ts
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@
* review score as one circled digit), then a single space, then the title.
*
* 🔨 [3475 by Claude Opus 5.5] Let an automation run when …
* ⚠️⑥ [3475 by Claude Opus 5.5] …
* ✅⑧ [3510 by Claude Opus 5.5] Apply library extensions automatically …
* ⚠️➅ [3475 by Claude Opus 5.5] …
* ✅➇ [3510 by Claude Opus 5.5] Apply library extensions automatically …
*
* An epic pull request follows its emoji with how many of its issues are
* merged into the epic branch, and shows no score. While it is working, a pie
Expand Down Expand Up @@ -47,16 +47,23 @@ const EPIC_NONE = '\u25CB';
const EPIC_QUARTER = '\u25D4';
const EPIC_HALF = '\u25D1';
const EPIC_THREE_QUARTERS = '\u25D5';
/** ① (U+2460) to ⑩ (U+2469). */
const CIRCLED_ONE = 0x2460;
/**
* The score is written with the Dingbats circled sans-serif digits ➀ (U+2780)
* to ➉ (U+2789). The Enclosed Alphanumerics ① (U+2460) to ⑩ (U+2469) that
* titles used before are drawn sideways by some platform fonts (#3576); they
* are still read, so an older title gets the new digit on its next update.
*/
const CIRCLED_ONE = 0x2780;

/**
* The slot, anchored at the start of the title and followed by exactly one
* space. ⚠ is accepted with and without its variation selector. The score is
* only recognised beside ⚠️ and ✅. An epic's ` merged/total` may follow; a
* working epic's circle is recognised only with it.
* only recognised beside ⚠️ and ✅, as ➀–➉ or the older ①–⑩. An epic's
* ` merged/total` may follow; a working epic's circle is recognised only with it.
* Every non-ASCII character is escaped: the desktop renderer can decode the
* bundle as Latin-1, where a literal ➀ turns into an out-of-order range.
*/
export const PR_TITLE_STATUS_SLOT_PATTERN = /^(?:(?:\u{1F528}|(?:⚠️?|✅)[①-⑩]?)(?: \d{1,6}\/\d{1,6})?|[\u25CB\u25D4\u25D1\u25D5] \d{1,6}\/\d{1,6}) /u;
export const PR_TITLE_STATUS_SLOT_PATTERN = /^(?:(?:\u{1F528}|(?:\u26A0\uFE0F?|\u2705)[\u2460-\u2469\u2780-\u2789]?)(?: \d{1,6}\/\d{1,6})?|[\u25CB\u25D4\u25D1\u25D5] \d{1,6}\/\d{1,6}) /u;

/** The circle a working epic shows for `merged` of `total` issues merged. */
function epicWorkingCircle(merged: number, total: number): string {
Expand Down
43 changes: 28 additions & 15 deletions packages/shared/test/prTitleStatusSlot.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -8,34 +8,47 @@ const TITLE = '[3475 by Claude Opus 5.5] Let an automation run when a plan issue

test('renders one slot per persistent state, with the score beside ⚠️ and ✅', () => {
assert.equal(renderStatusSlot({ state: 'working', score: 8 }), '🔨');
assert.equal(renderStatusSlot({ state: 'needs_attention', score: 6 }), '⚠️⑥');
assert.equal(renderStatusSlot({ state: 'ready', score: 8 }), '✅⑧');
assert.equal(renderStatusSlot({ state: 'ready', score: 10 }), '✅⑩');
assert.equal(renderStatusSlot({ state: 'ready', score: 1 }), '✅①');
assert.equal(renderStatusSlot({ state: 'needs_attention', score: 6 }), '⚠️➅');
assert.equal(renderStatusSlot({ state: 'ready', score: 8 }), '✅➇');
assert.equal(renderStatusSlot({ state: 'ready', score: 10 }), '✅➉');
assert.equal(renderStatusSlot({ state: 'ready', score: 1 }), '✅➀');
assert.equal(renderStatusSlot({ state: 'ready', score: null }), '✅');
assert.equal(renderStatusSlot({ state: 'needs_attention', score: 0 }), '⚠️', 'no circled digit outside 1 to 10');
assert.equal(renderStatusSlot({ state: 'ready', score: 7.6 }), '✅⑧');
assert.equal(renderStatusSlot({ state: 'ready', score: 7.6 }), '✅➇');
assert.equal(renderStatusSlot(null), null);
});

test('sets, replaces and removes only the slot', () => {
assert.equal(withStatusSlot(TITLE, { state: 'working' }), `🔨 ${TITLE}`);
assert.equal(withStatusSlot(`🔨 ${TITLE}`, { state: 'ready', score: 8 }), `✅⑧ ${TITLE}`);
assert.equal(withStatusSlot(`✅⑧ ${TITLE}`, { state: 'needs_attention', score: 6 }), `⚠️⑥ ${TITLE}`);
assert.equal(withStatusSlot(`⚠️⑥ ${TITLE}`, null), TITLE);
assert.equal(withStatusSlot(`✅⑧ ${TITLE}`, { state: 'working' }), `🔨 ${TITLE}`);
assert.equal(withStatusSlot(`🔨 ${TITLE}`, { state: 'ready', score: 8 }), `✅➇ ${TITLE}`);
assert.equal(withStatusSlot(`✅➇ ${TITLE}`, { state: 'needs_attention', score: 6 }), `⚠️➅ ${TITLE}`);
assert.equal(withStatusSlot(`⚠️➅ ${TITLE}`, null), TITLE);
assert.equal(withStatusSlot(`✅➇ ${TITLE}`, { state: 'working' }), `🔨 ${TITLE}`);
assert.equal(withStatusSlot('', { state: 'working' }), '🔨 ');
});

test('accepts ⚠ with and without the variation selector', () => {
assert.equal(readStatusSlot(`⚠️⑥ ${TITLE}`), '⚠️⑥');
assert.equal(readStatusSlot(`⚠⑥ ${TITLE}`), '⚠⑥');
assert.equal(readStatusSlot(`⚠️➅ ${TITLE}`), '⚠️➅');
assert.equal(readStatusSlot(`⚠➅ ${TITLE}`), '⚠➅');
assert.equal(stripStatusSlot(`⚠ ${TITLE}`), TITLE);
assert.equal(withStatusSlot(`⚠⑥ ${TITLE}`, { state: 'ready', score: 9 }), `✅⑨ ${TITLE}`);
assert.equal(withStatusSlot(`⚠➅ ${TITLE}`, { state: 'ready', score: 9 }), `✅➈ ${TITLE}`);
});

test('writes the score as a Dingbats circled digit and still reads the older ①–⑩ slot (#3576)', () => {
for (let score = 1; score <= 10; score += 1) {
const slot = renderStatusSlot({ state: 'ready', score }) as string;
assert.equal(slot.codePointAt(1), 0x2780 + score - 1, `score ${score}`);
}
for (const legacy of ['①', '⑥', '⑩']) {
assert.equal(readStatusSlot(`⚠️${legacy} ${TITLE}`), `⚠️${legacy}`);
assert.equal(stripStatusSlot(`✅${legacy} ${TITLE}`), TITLE);
assert.equal(withStatusSlot(`⚠️${legacy} ${TITLE}`, { state: 'needs_attention', score: 6 }), `⚠️➅ ${TITLE}`);
}
assert.equal(hasStatusSlot(`🔨⑥ ${TITLE}`), false, 'no score beside 🔨 in either form');
});

test('recognises only a strict slot anchored at the start', () => {
for (const title of [TITLE, `x 🔨 ${TITLE}`, `🔨${TITLE}`, `🔨⑧ ${TITLE}`, `⑧ ${TITLE}`, ` 🔨 ${TITLE}`, `🔧 ${TITLE}`]) {
for (const title of [TITLE, `x 🔨 ${TITLE}`, `🔨${TITLE}`, `🔨➇ ${TITLE}`, `➇ ${TITLE}`, ` 🔨 ${TITLE}`, `🔧 ${TITLE}`]) {
assert.equal(hasStatusSlot(title), false, title);
assert.equal(stripStatusSlot(title), title, title);
}
Expand All @@ -47,13 +60,13 @@ test('recognises only a strict slot anchored at the start', () => {
test('leaves the title unchanged when the slot would exceed the 256 character limit', () => {
const long = 'a'.repeat(254);
assert.equal(withStatusSlot(long, { state: 'working' }), long);
assert.equal(withStatusSlot(`🔨 ${'b'.repeat(250)}`, { state: 'ready', score: 8 }), `✅⑧ ${'b'.repeat(250)}`);
assert.equal(withStatusSlot(`🔨 ${'b'.repeat(250)}`, { state: 'ready', score: 8 }), `✅➇ ${'b'.repeat(250)}`);
const exact = 'c'.repeat(253);
assert.equal(withStatusSlot(exact, { state: 'working' }).length, 256);
});

test('merge commit titles carry no slot', () => {
assert.deepEqual(mergeCommitTitleFields({ number: 3510, title: `✅⑧ ${TITLE}` }, 'squash'), { commit_title: `${TITLE} (#3510)` });
assert.deepEqual(mergeCommitTitleFields({ number: 3510, title: `✅➇ ${TITLE}` }, 'squash'), { commit_title: `${TITLE} (#3510)` });
assert.deepEqual(mergeCommitTitleFields({ number: 3510, title: TITLE }, 'squash'), { commit_title: `${TITLE} (#3510)` });
assert.deepEqual(mergeCommitTitleFields({ number: 7, title: `🔨 ${TITLE}`, headLabel: 'integry:feature' }, 'merge'),
{ commit_title: 'Merge pull request #7 from integry/feature', commit_message: TITLE });
Expand Down
2 changes: 1 addition & 1 deletion propr-ui/src/components/Dashboard/workTitle.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ import { splitWorkTitle } from './workTitle';

describe('splitWorkTitle', () => {
it('parses titles with and without the PR status slot', () => {
for (const slot of ['', '🔨 ', '⚠️⑥ ', '\u26A0⑥ ', '✅⑧ ', '✅ ']) {
for (const slot of ['', '🔨 ', '⚠️➅ ', '\u26A0➅ ', '✅➇ ', '✅ ']) {
expect(splitWorkTitle(`${slot}[3475 by Claude Opus 5.5] Let an automation run`, 'issue'))
.toEqual({ type: 'Implement', title: 'Let an automation run' });
expect(splitWorkTitle(`Fix PR #3510: ${slot}[3510 by Claude Opus 5.5] Apply library extensions`, 'pr-comment'))
Expand Down
2 changes: 1 addition & 1 deletion propr-ui/src/components/Dashboard/workTitle.ts
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ function taskTypeLabel(taskType: string | null | undefined): string | null {
}

export function splitWorkTitle(title: string | null | undefined, taskType?: string | null): WorkTitle {
// A PR title may lead with its status slot (`✅⑧ `); older task titles copied it after the prefix.
// A PR title may lead with its status slot (`✅➇ `); older task titles copied it after the prefix.
let rest = stripStatusSlot((title ?? '').trim());
let type: string | null = null;

Expand Down
2 changes: 1 addition & 1 deletion propr-ui/src/components/TaskList/rowModel.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ const image = (index: number) => ({ type: 'image', title: `Preview ${index}`, ur

describe('sanitizeTaskTitle', () => {
it('drops the PR status slot and the model tag, with or without the slot', () => {
for (const slot of ['', '🔨 ', '⚠️⑥ ', '✅⑧ ']) {
for (const slot of ['', '🔨 ', '⚠️➅ ', '✅➇ ']) {
expect(sanitizeTaskTitle(`Ultrafix PR #2664: ${slot}[2659 by GPT-6 Astra] Stop work when intent is withdrawn`))
.toEqual({ type: 'Ultrafix', title: 'Stop work when intent is withdrawn', fullTitle: 'Stop work when intent is withdrawn' });
expect(sanitizeTaskTitle(`PR #2664: ${slot}Stop work`).title).toBe('Stop work');
Expand Down
2 changes: 1 addition & 1 deletion propr-ui/src/components/TaskList/utils.statusSlot.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ import { getCleanDocumentTitle } from './utils.tsx';
import { cleanHeaderTaskTitle } from '../headerUtils';

describe('title parsers and the PR status slot', () => {
for (const slot of ['', '🔨 ', '⚠️⑥ ', '⚠ ', '✅⑧ ']) {
for (const slot of ['', '🔨 ', '⚠️➅ ', '⚠ ', '✅➇ ']) {
it(`getCleanDocumentTitle reads the [N by Model] prefix with slot "${slot}"`, () => {
expect(getCleanDocumentTitle(`${slot}[3475 by Claude Opus 5.5] Let an automation run`)).toBe('3475: Let an automation run');
expect(getCleanDocumentTitle(`Followup: ${slot}[870 by Claude Opus] Update checkout`)).toBe('870: Update checkout');
Expand Down
2 changes: 1 addition & 1 deletion propr-ui/src/components/TaskList/utils.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ export const shouldDimTask = (task: Task): boolean => {
* @returns Clean title in format "issueId: title" or the original title if no pattern matches
*/
/**
* The title without a PR status slot (`🔨 `, `✅⑧ `), at its start or right
* The title without a PR status slot (`🔨 `, `✅➇ `), at its start or right
* after a `Followup:` / `New Issue:` prefix.
*/
const withoutStatusSlot = (title: string): string => {
Expand Down
2 changes: 1 addition & 1 deletion propr-ui/src/components/headerUtils.ts
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ export const formatRelativeTime = (dateString: string): string => {

/**
* A task title for the header's task list: without the `Followup:` prefix, a
* PR status slot (`🔨 `, `✅⑧ `) or the leading `[N by Model]` tag.
* PR status slot (`🔨 `, `✅➇ `) or the leading `[N by Model]` tag.
*/
export function cleanHeaderTaskTitle(title?: string): string {
if (!title) return '';
Expand Down
2 changes: 1 addition & 1 deletion test/autoMergeOperations.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ test('GitHub refusing to arm at all is reported as unavailable so callers merge

test('the merge commit headline carries no title status slot', async () => {
graphql.mock.resetCalls();
currentPullRequest = { node_id: 'PR_node', title: '✅⑧ [12 by Claude Opus 5.5] Add retries', head: { sha: 'evaluated-head', label: 'acme:feature' }, base: { ref: 'main' } };
currentPullRequest = { node_id: 'PR_node', title: '✅➇ [12 by Claude Opus 5.5] Add retries', head: { sha: 'evaluated-head', label: 'acme:feature' }, base: { ref: 'main' } };
await enableAutoMerge({ owner: 'acme', repoName: 'repo', prNumber: 7, mergeMethod: 'SQUASH', expectedHead });
assert.equal(graphql.mock.calls[0].arguments[1].commitHeadline, '[12 by Claude Opus 5.5] Add retries (#7)');
assert.equal(graphql.mock.calls[0].arguments[1].commitBody, null);
Expand Down
Loading
Loading