copilot-operator 0.1.38 → 0.1.40

package/dist/src/plan/schema.js

@@ -52,6 +52,11 @@ const VcsInput = z
         .optional(),
     /** The local branch `startFrom: "branch"` starts from, and `previous-session`'s fallback. */
     baseBranch: z.string().trim().optional(),
+    /**
+     * The remote `baseBranch` was chosen from in the start window (`origin`): the session starts from
+     * that remote branch as fetched there. Written by the export; the start window asks every time.
+     */
+    baseRemote: z.string().trim().optional(),
     /**
      * The existing local branch the whole session works on, exactly as named: no new branch, no
      * prefix. Given alone it means `startFrom: "existing-branch"`. See `VersionControl.startFrom`.

package/dist/src/plan/systemGuide.js

@@ -40,8 +40,8 @@ export const SYSTEM_GUIDE = [
         route: 'every page',
         nameEn: 'The header and the navigation',
         nameBg: 'Заглавната лента и навигацията',
-        purposeEn: 'The links down the side of every page, the language switch, the round to-the-top and to-the-bottom buttons of a long page, the box that asks before anything irreversible, and the banner of steps waiting for a decision, which appears on every page.',
-        purposeBg: 'Връзките отстрани на всяка страница, смяната на езика, кръглите бутони към началото и края на дълга страница, прозорецът, който пита преди нещо необратимо, и лентата със стъпки, чакащи решение, която се появява на всяка страница.',
+        purposeEn: 'The links down the side of every page, the language switch, the round to-the-top and to-the-bottom buttons of a long page, the box that asks before anything irreversible, the start window every start button opens first (where the work starts), the notice of a start that did not happen, and the banner of steps waiting for a decision, which appears on every page.',
+        purposeBg: 'Връзките отстрани на всяка страница, смяната на езика, кръглите бутони към началото и края на дълга страница, прозорецът, който пита преди нещо необратимо, прозорецът за старт, който всеки бутон за пускане отваря първо (откъде тръгва работата), съобщението за пускане, което не е започнало, и лентата със стъпки, чакащи решение, която се появява на всяка страница.',
         sections: [
             {
                 headingKey: 'nav.label',
@@ -177,6 +177,148 @@ export const SYSTEM_GUIDE = [
                     },
                 ],
             },
+            {
+                headingKey: 'startdlg.title',
+                en: 'Where the work starts',
+                bg: 'Откъде да тръгне работата',
+                controls: [
+                    {
+                        key: 'startdlg.keep',
+                        kind: 'radio',
+                        en: 'Keep the start prepared before this run',
+                        bg: 'Запази началото, подготвено преди това пускане',
+                        doesEn: 'Only for a session whose start was prepared before the run — a starting snapshot approved on the run panel — and chosen first then: the run starts from it as approved. Any other choice below drops it.',
+                        doesBg: 'Само за сесия, чието начало е подготвено преди пускането — стартова снимка, одобрена в панела за пускане — и тогава е избрано първо: пускането тръгва от нея, както е одобрена. Всеки друг избор по-долу я отменя.',
+                    },
+                    {
+                        key: 'startdlg.local',
+                        kind: 'radio',
+                        en: 'Local branch',
+                        bg: 'Локален клон',
+                        doesEn: 'The start window opens on every start button — the run buttons on /, a session\'s Start, "Run this task", the register\'s Continue and "Run only this one again" — and nothing starts until its own button is pressed. This choice: the work starts from the local branch picked in the list beside it, as it is in the folder; nothing is fetched.',
+                        doesBg: 'Прозорецът за старт се отваря от всеки бутон за пускане — бутоните за пускане на /, „Старт“ на сесия, „Пусни тази задача“, „Продължи“ и „Пусни само тази отново“ в регистъра — и нищо не тръгва, преди да се натисне неговият бутон. Този избор: работата тръгва от локалния клон, избран в списъка до него, какъвто е в папката; нищо не се изтегля.',
+                    },
+                    {
+                        key: 'startdlg.remote',
+                        kind: 'radio',
+                        en: 'Remote branch (fetched now)',
+                        bg: 'Remote клон (изтегля се сега)',
+                        doesEn: 'The work starts from the branch as it is on the server: type its name (feature/…) or pick it from the list. It is fetched when the window\'s start button is pressed; if the SSH key has a passphrase, Git\'s own window asks for it (it may be behind the browser) — the operator types it there, the bot never sees it. The local branch of that name is not touched.',
+                        doesBg: 'Работата тръгва от клона, какъвто е на сървъра: напиши името му (feature/…) или го избери от списъка. Изтегля се при натискане на бутона за старт на прозореца; ако SSH ключът има passphrase, собственият прозорец на Git я иска (може да е зад браузъра) — операторът я въвежда там, ботът не я вижда. Локалният клон със същото име не се пипа.',
+                    },
+                    {
+                        key: 'startdlg.refreshRemote',
+                        kind: 'button',
+                        en: 'Get the list of branches from the remote',
+                        bg: 'Вземи списъка с клонове от remote',
+                        doesEn: 'Fetches the whole remote (the password window may open) so the list of remote branches to pick from is current.',
+                        doesBg: 'Изтегля целия remote (може да се отвори прозорецът за парола), за да е актуален списъкът с remote клонове за избор.',
+                    },
+                    {
+                        key: 'startdlg.previous',
+                        kind: 'radio',
+                        en: 'Carry on from the session before it',
+                        bg: 'Продължи от предната сесия',
+                        doesEn: 'Offered for a session that follows another in the same repository: carries on from the end of that session\'s branch.',
+                        doesBg: 'Предлага се за сесия след друга в същото хранилище: продължава от края на клона на онази сесия.',
+                    },
+                    {
+                        key: 'startdlg.onBranch',
+                        kind: 'checkbox',
+                        en: 'Work directly on this branch, without a new branch',
+                        bg: 'Работи направо на този клон, без нов клон',
+                        doesEn: 'Off, as usual: the bot cuts a branch of its own from the chosen one. On: the tasks commit on the chosen branch itself; a remote branch is first made locally, or the local one brought up to it (fast-forward only). A local branch that has gone its own way from the remote one is refused, with nothing changed.',
+                        doesBg: 'Изключено, както обикновено: ботът прави свой клон от избрания. Включено: задачите комитват направо на избрания клон; при remote клон първо се прави локален или локалният се довежда до него (само fast-forward). Локален клон, тръгнал по свой път спрямо remote, се отказва, без да се променя нищо.',
+                    },
+                    {
+                        key: 'startdlg.goStep',
+                        kind: 'button',
+                        en: 'Start, asking before each command',
+                        bg: 'Започни, с питане преди всяка команда',
+                        doesEn: 'The window\'s own start button, for a run that asks before each command: fetches what was chosen from the remote, writes the choice on the sessions and starts.',
+                        doesBg: 'Собственият бутон за старт на прозореца, за пускане с питане преди всяка команда: изтегля избраното от remote, записва избора в сесиите и стартира.',
+                    },
+                    {
+                        key: 'startdlg.goUnattended',
+                        kind: 'button',
+                        en: 'Start without asking',
+                        bg: 'Започни без питане',
+                        doesEn: 'The same, for a run without asking.',
+                        doesBg: 'Същото, за пускане без питане.',
+                    },
+                    {
+                        key: 'startdlg.retryFetch',
+                        kind: 'button',
+                        en: 'Fetch again',
+                        bg: 'Изтегли отново',
+                        doesEn: 'After a fetch that did not get through — a passphrase not typed, a branch name the remote does not have: fetches again.',
+                        doesBg: 'След изтегляне, което не е минало — непопълнен passphrase, име на клон, което remote няма: изтегля отново.',
+                    },
+                    {
+                        key: 'startdlg.useFetched',
+                        kind: 'button',
+                        en: 'Go on with what was last fetched',
+                        bg: 'Продължи с последно изтегленото',
+                        doesEn: 'After such a fetch, when that branch was fetched here before: starts from that older copy instead.',
+                        doesBg: 'След такова изтегляне, ако клонът е бил изтеглян тук преди: тръгва от онова по-старо копие.',
+                    },
+                    {
+                        key: 'startdlg.back',
+                        kind: 'button',
+                        en: 'Back to the choice',
+                        bg: 'Обратно към избора',
+                        doesEn: 'Back to the choice of branches, after a fetch or a start that did not go through.',
+                        doesBg: 'Обратно към избора на клонове след изтегляне или старт, които не са минали.',
+                    },
+                    {
+                        key: 'startdlg.tryAgain',
+                        kind: 'button',
+                        en: 'Try to start again',
+                        bg: 'Опитай пак да започнеш',
+                        doesEn: 'After a start that did not happen — for instance once the version control fixes shown in the window are done: starts again with the same choice, without fetching again.',
+                        doesBg: 'След старт, който не се е случил — например след като поправките на контрола на версиите, показани в прозореца, са направени: стартира пак със същия избор, без ново изтегляне.',
+                    },
+                ],
+            },
+            {
+                headingKey: null,
+                en: 'A start that did not happen',
+                bg: 'Пускане, което не е започнало',
+                controls: [
+                    {
+                        key: 'startfail.title',
+                        kind: 'note',
+                        en: 'The work did not start',
+                        bg: 'Работата не започна',
+                        doesEn: 'In the start window when its button did not start the work, on / under the run buttons once the window is closed, and on every page when a run was accepted and then could not begin (the browser, the profile, the sign-in, a session refused at its turn): the error itself and where it stopped.',
+                        doesBg: 'В прозореца за старт, когато бутонът му не е стартирал работата, на / под бутоните за пускане след затварянето му, и на всяка страница, когато пускане е прието, а после не е могло да започне (браузърът, профилът, влизането, сесия, отказана на своя ред): самата грешка и къде е спряло.',
+                    },
+                    {
+                        key: 'startfail.download',
+                        kind: 'link',
+                        en: 'Download what happened (error, run record and terminal)',
+                        bg: 'Изтегли какво се случи (грешка, запис на пускането и терминал)',
+                        doesEn: 'A text file with the error, where it stopped, the run\'s own record, the sessions\' events and every line the bot\'s console printed from the press until a few seconds after. Ask the operator for it when a run does not start.',
+                        doesBg: 'Текстов файл с грешката, къде е спряло, собствения запис на пускането, събитията на сесиите и всеки ред, който конзолата на бота е отпечатала от натискането до няколко секунди след това. Поискай го от оператора, когато пускане не тръгва.',
+                    },
+                    {
+                        key: 'startfail.terminal',
+                        kind: 'link',
+                        en: 'Download what the terminal showed',
+                        bg: 'Изтегли какво показа терминалът',
+                        doesEn: 'The latest lines the bot\'s console (npm start or cop start) printed, with the time of each, as a text file. Also on /system.',
+                        doesBg: 'Последните редове, отпечатани от конзолата на бота (npm start или cop start), с часа на всеки, като текстов файл. Има го и на /system.',
+                    },
+                    {
+                        key: 'startfail.dismiss',
+                        kind: 'button',
+                        en: 'Close this notice',
+                        bg: 'Затвори съобщението',
+                        doesEn: 'Closes the notice of a run that could not begin, on every page; the files stay on record.',
+                        doesBg: 'Затваря съобщението за пускане, което не е могло да започне, на всяка страница; файловете остават.',
+                    },
+                ],
+            },
             {
                 headingKey: 'approval.waitingHere',
                 en: 'A step is waiting for your decision',
@@ -722,8 +864,8 @@ export const SYSTEM_GUIDE = [
                         kind: 'note',
                         en: 'Prepare version control for this run',
                         bg: 'Подготви контрола на версиите за това пускане',
-                        doesEn: 'Shown under the run settings when a repository of the ticked sessions is not ready: one box per repository, with the fixes. The run buttons stay off until every box is ready, and a start is refused before the browser opens.',
-                        doesBg: 'Показва се под настройките на пускането, когато хранилище на отметнатите сесии не е готово: по една кутия на хранилище, с решенията. Бутоните за пускане остават изключени, докато всяка кутия не е готова, а старт се отказва преди да се отвори браузърът.',
+                        doesEn: 'Shown under the run settings when a repository of the ticked sessions is not ready: one box per repository, with the fixes. The run buttons stay off until every box is ready — unless all that is wrong is where a session starts (a branch that is not here), which the start window settles — and a start is refused before the browser opens.',
+                        doesBg: 'Показва се под настройките на пускането, когато хранилище на отметнатите сесии не е готово: по една кутия на хранилище, с решенията. Бутоните за пускане остават изключени, докато всяка кутия не е готова — освен ако единственият проблем е откъде тръгва сесия (клон, който го няма тук), което се решава в прозореца за старт — а старт се отказва преди да се отвори браузърът.',
                     },
                     {
                         key: 'runvcs.repo',
@@ -834,24 +976,16 @@ export const SYSTEM_GUIDE = [
                         kind: 'button',
                         en: 'Run {n} session(s)',
                         bg: 'Пусни {n} сесия(и)',
-                        doesEn: 'Starts the ticked sessions one after another and runs every command without asking. It asks "are you sure" first, unless Settings → Execution → "Starting a run without supervision" is "Start it without asking".',
-                        doesBg: 'Пуска отметнатите сесии една след друга и изпълнява всяка команда без питане. Първо пита „сигурен ли си“, освен ако Настройки → Изпълнение → „Пускане без надзор“ е „Пускай, без да питаш“.',
+                        doesEn: 'Starts the ticked sessions one after another and runs every command without asking. It asks "are you sure" first, unless Settings → Execution → "Starting a run without supervision" is "Start it without asking". The start window opens first ("Where the work starts"), where the branch of each session is chosen.',
+                        doesBg: 'Пуска отметнатите сесии една след друга и изпълнява всяка команда без питане. Първо пита „сигурен ли си“, освен ако Настройки → Изпълнение → „Пускане без надзор“ е „Пускай, без да питаш“. Първо се отваря прозорецът за старт („Откъде да тръгне работата“), където се избира клонът на всяка сесия.',
                     },
                     {
                         key: 'batch.runStep',
                         kind: 'button',
                         en: 'Step by step',
                         bg: 'Стъпка по стъпка',
-                        doesEn: 'Starts the same sessions but stops before every command and waits for a decision.',
-                        doesBg: 'Пуска същите сесии, но спира преди всяка команда и чака решение.',
-                    },
-                    {
-                        key: 'batch.notStartedTitle',
-                        kind: 'note',
-                        en: 'The run did not start',
-                        bg: 'Пускането не тръгна',
-                        doesEn: 'The box over the two run buttons when a press was refused, with the reason under it. Nothing was opened and nothing ran; read the reason before pressing again.',
-                        doesBg: 'Карето над двата бутона за пускане, когато натискането е отказано, с причината под него. Нищо не е отваряно и нищо не е пускано; прочети причината, преди да натиснеш пак.',
+                        doesEn: 'Starts the same sessions but stops before every command and waits for a decision. The start window opens first, as for the other button.',
+                        doesBg: 'Пуска същите сесии, но спира преди всяка команда и чака решение. Първо се отваря прозорецът за старт, както при другия бутон.',
                     },
                     {
                         key: 'batch.notStartedIsolation',
@@ -1587,8 +1721,8 @@ export const SYSTEM_GUIDE = [
                         kind: 'button',
                         en: 'Run again',
                         bg: 'Пусни отново',
-                        doesEn: 'Puts a finished task back in the queue unchanged, to start afresh; the earlier attempt is kept with its own log. It only queues.',
-                        doesBg: 'Връща приключила задача в опашката без промяна, да тръгне отначало; предишният опит се пази със собствен дневник. Само я нарежда.',
+                        doesEn: 'Puts a finished task back in the queue unchanged, to start afresh; the earlier attempt is kept with its own log. It only queues, then offers "Run this task" on the card.',
+                        doesBg: 'Връща приключила задача в опашката без промяна, да тръгне отначало; предишният опит се пази със собствен дневник. Само я нарежда, после предлага „Пусни тази задача“ на картата.',
                     },
                     {
                         key: 'restore.button',
@@ -2300,8 +2434,64 @@ export const SYSTEM_GUIDE = [
                         kind: 'button',
                         en: 'Fix the prompt and queue it again',
                         bg: 'Поправи prompt-а и върни в опашката',
-                        doesEn: 'On a row that did not end done, its session idle: rewrite the task\'s text and queue it again. It does not start it.',
-                        doesBg: 'На ред, който не е завършил готов, при спряна сесия: пренапишете текста на задачата и я върнете в опашката. Не я пуска.',
+                        doesEn: 'On a row that did not end done, its session idle: rewrite the task\'s text and queue it again. Saving does not start it; the same dialog then asks "Run it now?" with the "Run this task" choices and buttons.',
+                        doesBg: 'На ред, който не е завършил готов, при спряна сесия: пренапишете текста на задачата и я върнете в опашката. Запазването не я пуска; после същият прозорец пита „Да я пусна ли сега?“ с изборите и бутоните на „Пусни тази задача“.',
+                    },
+                    {
+                        key: 'runq.later',
+                        kind: 'button',
+                        en: 'Later',
+                        bg: 'По-късно',
+                        doesEn: 'On a "Run this task" panel that was offered rather than asked for — after a prompt was saved, a contradiction fixed, or a task queued again on its card: leaves the task waiting in the queue.',
+                        doesBg: 'В панела „Пусни тази задача“, когато е предложен, а не поискан — след запазен prompt, поправено противоречие или задача, върната в опашката от картата ѝ: оставя задачата да чака в опашката.',
+                    },
+                    {
+                        key: 'runq.button',
+                        kind: 'button',
+                        en: 'Run this task',
+                        bg: 'Пусни тази задача',
+                        doesEn: 'On a waiting (queued) row, its session idle and active: a panel to start that task now — "Only this task", or "This one and the N queued after it" in its session. It lists what runs, says the tasks that already ran are not touched, and names an earlier task of a chain that did not succeed (a warning, not a refusal). Also on a queued task card on the session page.',
+                        doesBg: 'На чакащ ред, при спряна и активна сесия: панел за пускане на задачата сега — „Само тази задача“ или „Тази и N чакащи след нея“ в сесията ѝ. Изброява какво ще тръгне, казва, че вече изпълнените задачи не се пипат, и назовава по-ранна задача от верига, която не е минала (предупреждение, не отказ). Има го и на картата на чакаща задача в страницата на сесията.',
+                    },
+                    {
+                        key: 'runq.go',
+                        kind: 'button',
+                        en: 'Run, asking before each command',
+                        bg: 'Пусни, с питане преди всяка команда',
+                        doesEn: 'In "Run this task": starts what the panel lists, step by step. A refusal is said in the panel; if the task contradicts itself, its fixes open right there.',
+                        doesBg: 'В „Пусни тази задача“: пуска изброеното в панела, стъпка по стъпка. Отказът се казва в панела; ако задачата си противоречи, поправките ѝ се отварят там.',
+                    },
+                    {
+                        key: 'runq.unattended',
+                        kind: 'button',
+                        en: 'Run without asking',
+                        bg: 'Пусни без да пита',
+                        doesEn: 'In "Run this task": the same, on its own, without stopping to ask; asks "are you sure" first unless Settings say not to.',
+                        doesBg: 'В „Пусни тази задача“: същото, самостоятелно, без да спира да пита; първо пита „сигурни ли сте“, освен ако настройките не казват друго.',
+                    },
+                    {
+                        key: 'cfix.button',
+                        kind: 'button',
+                        en: 'Fix the contradiction',
+                        bg: 'Поправи противоречието',
+                        doesEn: 'On a row (a dialog) or task card blocked because it contradicts itself (the chip "task contradicts itself"): lists each contradiction with the ways out, the least change chosen — add the file to the scope, let a read-only task change only that file, drop the scope, or drop one of its own checks. Never changes the prompt. A task a run refused to start for this stays queued: its fixes open inside "Run this task".',
+                        doesBg: 'На ред (или карта), блокиран с „задачата си противоречи“: изброява всяко противоречие с изходите от него, като е избрана най-малката промяна — файлът в обхвата, задача само за четене да променя само този файл, без обхват, или без една от собствените ѝ проверки. Prompt-ът никога не се променя.',
+                    },
+                    {
+                        key: 'cfix.apply',
+                        kind: 'button',
+                        en: 'Apply and queue it again',
+                        bg: 'Приложи и върни в опашката',
+                        doesEn: 'Applies the chosen fixes, queues the task as a new attempt and offers "Run this task". Nothing starts by itself.',
+                        doesBg: 'Прилага избраните поправки, връща задачата в опашката като нов опит и предлага „Пусни тази задача“. Нищо не тръгва само.',
+                    },
+                    {
+                        key: 'cfix.applyQueued',
+                        kind: 'button',
+                        en: 'Apply',
+                        bg: 'Приложи',
+                        doesEn: 'The same for a task still waiting (a run refused to start it): edits it where it waits; then start it again from the same panel.',
+                        doesBg: 'Същото за задача, която още чака (пускането е отказано): променя я на място; после я пуснете отново от същия панел.',
                     },
                     {
                         key: 'reg.newPrompt',
@@ -3449,6 +3639,14 @@ export const SYSTEM_GUIDE = [
                         doesEn: 'The block showing the settings as saved and the paths they resolve to.',
                         doesBg: 'Блокът с настройките, както са запазени, и пътищата, до които водят.',
                     },
+                    {
+                        key: 'startfail.terminal',
+                        kind: 'link',
+                        en: 'Download what the terminal showed',
+                        bg: 'Изтегли какво показа терминалът',
+                        doesEn: 'Under "This machine": the latest lines the bot\'s console printed, with their times, as a text file — what to ask for when something went wrong and nothing on the pages says why.',
+                        doesBg: 'Под „Тази машина“: последните редове, отпечатани от конзолата на бота, с часовете им, като текстов файл — това се иска, когато нещо се е объркало и нищо по страниците не казва защо.',
+                    },
                     {
                         key: 'sys.profileHeld',
                         kind: 'note',

package/dist/src/session/exports.js

@@ -147,6 +147,7 @@ export function buildPlanExport(scope) {
                     // Only when chosen: absent is the old behaviour, and writing it out would suggest a choice.
                     ...(s.vcs?.startFrom ? { startFrom: s.vcs.startFrom } : {}),
                     ...(s.vcs?.baseBranch ? { baseBranch: s.vcs.baseBranch } : {}),
+                    ...(s.vcs?.baseRemote ? { baseRemote: s.vcs.baseRemote } : {}),
                     ...(s.vcs?.existingBranch ? { existingBranch: s.vcs.existingBranch } : {}),
                     // Only when switched off: absent is on.
                     ...(s.vcs?.updateFromRemote === false ? { updateFromRemote: false } : {}),

package/dist/src/session/startFailure.js

@@ -0,0 +1,91 @@
+/**
+ * A start that did not get as far as the first task, kept so the operator can see why and download
+ * what happened.
+ *
+ * Asked for on 2026-10-13: "if something fails and the bot does not start at all, I want to see what
+ * the error is — the specific error, and a place to download what happened in the terminal". Some of
+ * these were answered under the button that was pressed, in a sentence; others were not answered at
+ * all: a run accepted, then the browser would not open, and the reason was in the console and in a
+ * table row further down the page. Each one is now recorded here with where it stopped, the message,
+ * the run and its sessions, and the page offers a file that puts the run's own record, the sessions'
+ * events and the console lines of those moments in one place.
+ *
+ * Kept in memory only, for this process: the files it points at (the run log, the terminal log) are
+ * what stays.
+ */
+import { randomBytes } from 'node:crypto';
+import { formatTerminal, localTime } from '../log/terminal.js';
+const STAGE_SAID = {
+    refused: 'the start was not let in, before anything opened',
+    branch: 'choosing the branch the work starts from',
+    preflight: 'the version control check, before the browser opened',
+    browser: 'opening the browser (Edge), its profile or the chat',
+    run: 'the run, before its first task began',
+    'at-turn': "the session's turn in the run, before its first task",
+    error: 'the bot itself, while starting',
+};
+export function describeStage(stage) {
+    return STAGE_SAID[stage];
+}
+const KEEP = 50;
+export class StartFailures {
+    list = [];
+    record(f) {
+        const full = { ...f, id: `sf-${Date.now().toString(36)}-${randomBytes(3).toString('hex')}`, at: f.at ?? new Date().toISOString() };
+        this.list.push(full);
+        if (this.list.length > KEEP)
+            this.list.splice(0, this.list.length - KEEP);
+        return full;
+    }
+    get(id) {
+        return this.list.find((f) => f.id === id);
+    }
+    /** The newest first; only those nobody was answered with, when asked for. */
+    recent(opts = {}) {
+        return [...this.list].reverse().filter((f) => !opts.unansweredOnly || !f.answered);
+    }
+}
+export function refOf(f) {
+    return { id: f.id, at: f.at, stage: f.stage, message: f.message, ...(f.runId ? { runId: f.runId } : {}), answered: f.answered, sessions: f.sessions.map((s) => s.name) };
+}
+/**
+ * The file the page offers: what failed and where, then the run's own record, the sessions' events,
+ * and what the console printed from the press to a few seconds after the failure. Plain text, so it
+ * opens anywhere and can be pasted into a message; the caller redacts it.
+ */
+export function failureReport(f, parts) {
+    const out = [];
+    out.push('copilot-operator — the work did not start');
+    out.push('');
+    out.push(`When:              ${localTime(f.at)} (pressed ${localTime(f.pressedAt)})`);
+    out.push(`Where it stopped:  ${describeStage(f.stage)} [${f.stage}]`);
+    if (f.runId)
+        out.push(`Run:               ${f.runId}`);
+    if (f.sessions.length > 0)
+        out.push(`Sessions:          ${f.sessions.map((s) => `"${s.name}" (${s.id})`).join(', ')}`);
+    if (parts.version)
+        out.push(`Version:           ${parts.version}`);
+    out.push('');
+    out.push('What went wrong:');
+    out.push(...f.message.split(/\r?\n/).map((l) => `  ${l}`));
+    out.push('');
+    out.push(`The run's record (${parts.runLog.length} entr${parts.runLog.length === 1 ? 'y' : 'ies'}):`);
+    if (parts.runLog.length === 0)
+        out.push('  (none: the start stopped before the run was recorded)');
+    for (const e of parts.runLog)
+        out.push(`  ${localTime(e.at)}  ${e.type}  ${e.message}`);
+    out.push('');
+    out.push(`The sessions' events since the press (${parts.events.length}):`);
+    if (parts.events.length === 0)
+        out.push('  (none)');
+    for (const e of parts.events)
+        out.push(`  ${localTime(e.at)}  ${e.level === 'info' ? '    ' : e.level.toUpperCase().padEnd(4)}  ${e.type}  ${e.message ?? ''}`);
+    out.push('');
+    out.push(`What the terminal showed (the bot's console, ${parts.terminal.length} line(s) from the press to a few seconds after):`);
+    out.push(parts.terminal.length > 0 ? formatTerminal(parts.terminal) : '  (nothing was printed)');
+    out.push('');
+    if (parts.terminalFile)
+        out.push(`The whole console is kept in ${parts.terminalFile}; past 5 MB the older part goes to terminal.1.log beside it.`);
+    out.push('');
+    return out.join('\n');
+}

package/dist/src/vcs/prepareFromRemote.js

@@ -29,8 +29,8 @@ import { rm } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join, resolve } from 'node:path';
 import { createHash } from 'node:crypto';
-import { branchNameFrom, freeBranchName, git, gitFetch, lastFetchedAt, porcelainPaths, RUNNER_EMAIL } from './git.js';
-import { closePasswordWindows, describeFetchFailure, fetchCommandFor, operatorFetchEnv, QUIET_FETCH_ENV } from './remoteAuth.js';
+import { branchNameFrom, freeBranchName, git, lastFetchedAt, porcelainPaths, RUNNER_EMAIL } from './git.js';
+import { fetchAsOperator, fetchCommandFor } from './remoteAuth.js';
 const short = (c) => (c ?? '').slice(0, 8);
 const lines = (s) => s.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
 function stamp(now = new Date()) {
@@ -92,25 +92,12 @@ export async function planPrepare(folder, opts) {
     let fetched;
     if (opts.fetch) {
         /*
-         * With the password window: five minutes for the operator to type, and the window not hidden. One
-         * connection only — `remote set-head --auto` would open a second and ask for the password again —
-         * so the remote's main is read from what was fetched, below.
+         * With the password window when there is one, the whole remote in one connection, so the remote's
+         * main is read from what was fetched, below. Once more when the first try fails: see `gitFetch`
+         * (2026-10-05, every first press failed at work).
          */
-        const asked = !!opts.askpass;
-        const env = asked ? operatorFetchEnv(opts.askpass) : QUIET_FETCH_ENV;
-        const args = [...(asked ? [] : ['-c', 'credential.interactive=false']), 'fetch', '--quiet', '--no-tags', '--prune', remote];
-        const started = new Date(Date.now() - 1000);
-        // Once more when the first try fails: see `gitFetch` (2026-10-05, every first press failed at work).
-        const f = await gitFetch(repoDir, args, asked ? 300_000 : 120_000, env, { windowsHide: !asked, killTree: true });
-        // Given up on with the window still open: closed, so it is not left on screen asking for nothing.
-        if (!f.ok && asked && /gave up after/.test(f.stderr))
-            await closePasswordWindows(opts.askpass, started);
-        if (f.ok)
-            fetched = { ok: true, asked, ...(f.retried ? { retried: true, ...(f.firstError ? { firstError: f.firstError } : {}) } : {}) };
-        else {
-            const why = describeFetchFailure(f.stderr || f.stdout);
-            fetched = { ok: false, detail: why.detail, auth: why.auth, asked };
-        }
+        const f = await fetchAsOperator(repoDir, remote, { askpass: opts.askpass ?? null });
+        fetched = f.ok ? { ok: true, asked: f.asked, ...(f.retried ? { retried: true, ...(f.firstError ? { firstError: f.firstError } : {}) } : {}) } : { ok: false, detail: f.detail, auth: f.auth, asked: f.asked };
     }
     let target = '';
     const remoteHead = await git(repoDir, ['symbolic-ref', '--quiet', '--short', `refs/remotes/${remote}/HEAD`]);

package/dist/src/vcs/remoteAuth.js

@@ -20,7 +20,7 @@
 import { execFile } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { resolve } from 'node:path';
-import { git } from './git.js';
+import { git, gitFetch } from './git.js';
 import { psQuote } from './syncCommand.js';
 /** No prompt anywhere: what every fetch of a run uses. */
 export const QUIET_FETCH_ENV = { ...process.env, GIT_TERMINAL_PROMPT: '0', GCM_INTERACTIVE: 'never', GIT_ASKPASS: '', SSH_ASKPASS: '' };
@@ -90,3 +90,28 @@ export function closePasswordWindows(program, since) {
 export function fetchCommandFor(dir, remote) {
     return `git -C ${psQuote(dir)} fetch --prune ${psQuote(remote)}`;
 }
+/**
+ * A fetch the operator just pressed a button for, and is looking at: with Git's password window when
+ * there is one (five minutes to type, the window not hidden), quiet otherwise. One connection only —
+ * `remote set-head --auto` would open a second and ask for the password again. Tried once more when
+ * the first try fails (see `gitFetch`), and a window left on screen by a fetch that was given up on is
+ * closed. `refspecs` fetches only those branches; without them the whole remote is fetched and pruned.
+ *
+ * The one fetch behind "Prepare the folder from the remote main branch" and the start window's
+ * remote branches (`startChoice.ts`).
+ */
+export async function fetchAsOperator(repoDir, remote, opts) {
+    const asked = !!opts.askpass;
+    const env = asked ? operatorFetchEnv(opts.askpass) : QUIET_FETCH_ENV;
+    const whole = !opts.refspecs || opts.refspecs.length === 0;
+    const args = [...(asked ? [] : ['-c', 'credential.interactive=false']), 'fetch', '--quiet', '--no-tags', ...(whole ? ['--prune'] : []), remote, ...(opts.refspecs ?? [])];
+    const started = new Date(Date.now() - 1000);
+    const f = await gitFetch(repoDir, args, asked ? 300_000 : 120_000, env, { windowsHide: !asked, killTree: true });
+    // Given up on with the window still open: closed, so it is not left on screen asking for nothing.
+    if (!f.ok && asked && /gave up after/.test(f.stderr))
+        await closePasswordWindows(opts.askpass, started);
+    if (f.ok)
+        return { ok: true, asked, ...(f.retried ? { retried: true, ...(f.firstError ? { firstError: f.firstError } : {}) } : {}) };
+    const why = describeFetchFailure(f.stderr || f.stdout);
+    return { ok: false, detail: why.detail, auth: why.auth, asked };
+}