@miroshnik/elves 2026.1018.2 → 2026.1019.0

package/dist/github/scripts/github.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 import {
   locale_default
-} from "../../spec/scripts/harness-qzb932c8.js";
+} from "../../spec/scripts/harness-wqrt5gpa.js";
 
 // skills/github/scripts/github.ts
 import { spawnSync } from "node:child_process";
@@ -1280,6 +1280,7 @@ var handedOutFile = (io) => {
   return file && `${file}.tasks`;
 };
 var CLOUD_HANDOUT = "@cloud";
+var SESSION_HANDOUT = "@session";
 function handedOut(io, slug) {
   const file = handedOutFile(io);
   return file ? handOutsIn(file, slug) : [];
@@ -1292,7 +1293,8 @@ function handOutsIn(file, slug) {
   return lines.filter((l) => l.startsWith(`${slug}#`)).map((l) => {
     const [number, ...rest] = l.slice(slug.length + 1).split(" ");
     const worktree = rest.join(" ").trim();
-    return { number: Number(number), worktree: worktree === CLOUD_HANDOUT ? null : worktree || null, cloud: worktree === CLOUD_HANDOUT };
+    const executor = worktree === CLOUD_HANDOUT ? "cloud" : worktree === SESSION_HANDOUT ? "session" : "subagent";
+    return { number: Number(number), worktree: executor === "subagent" ? worktree || null : null, executor };
   }).filter((h) => Number.isInteger(h.number) && h.number > 0);
 }
 function realPath(p) {
@@ -1809,8 +1811,10 @@ function cmdTaskQueue(io, slug, o) {
     const pr = openPr(i);
     const work = [status === N.status.inProgress ? q(N.status.inProgress) : "", pr === undefined ? "" : `open PR #${pr} https://github.com/${slug}/pull/${pr}`].filter(Boolean);
     const hand = handed.find((h) => h.number === i.number);
-    if (!work.length && hand?.cloud)
+    if (!work.length && hand?.executor === "cloud")
       work.push(`handed out to a cloud executor of this session, its wait — a background command: bash ${waitCi()} issue ${i.number}`);
+    else if (!work.length && hand?.executor === "session")
+      work.push("handed out to an app executor session of this session (start_session) — the end of each of its turns comes as the app's note");
     else if (!work.length && hand)
       work.push("handed out to an executor of this session");
     if (work.length) {
@@ -2079,7 +2083,7 @@ function taskBranchesHere(io, slug, number) {
   const refs = [...git("for-each-ref", "--format=%(refname)", "refs/heads/"), ...git("ls-remote", "--heads", "origin").map((l) => l.split("\t")[1] ?? "")];
   return [...new Set(refs.map((r) => r.trim().replace(/^refs\/heads\//, "")).filter((b) => isTaskBranch(b, number)))].sort();
 }
-function cmdTaskAssignment(io, slug, number, o = { cloud: false }) {
+function cmdTaskAssignment(io, slug, number, o = {}) {
   const issue = loadIssue(io, slug, number);
   const file = handedOutFile(io);
   const own = pinnedTask(io)?.task;
@@ -2096,7 +2100,7 @@ function cmdTaskAssignment(io, slug, number, o = { cloud: false }) {
     mkdirSync(path.dirname(file), { recursive: true });
     writeFileSync(path.join(path.dirname(file), ".gitignore"), `*
 `);
-    const where = o.cloud ? CLOUD_HANDOUT : worktree;
+    const where = o.cloud ? CLOUD_HANDOUT : o.session ? SESSION_HANDOUT : worktree;
     appendFileSync(file, `${slug}#${number}${where ? ` ${where}` : ""}
 `);
   }
@@ -2114,11 +2118,17 @@ function cmdTaskAssignment(io, slug, number, o = { cloud: false }) {
     inProgress: N.status.inProgress,
     done: N.lastLine.done,
     questions: N.sections.questions,
-    branches: restart.map((b) => `\`${b}\``).join(", ")
+    branches: restart.map((b) => `\`${b}\``).join(", "),
+    doneQuestions: N.lastLine.questions,
+    remaining: N.lastLine.remaining
   };
-  const lines = [N.queue.lead, ...restart.length ? [N.queue.resume] : [], N.queue.subagent, N.queue.session, N.queue.wait, N.queue.git, N.queue.subagents, N.queue.live, N.queue.found, N.queue.question, N.queue.answer];
+  const resume = restart.length ? [N.queue.resume] : [];
+  const lines = o.session ? [N.queue.sessionLead, ...resume, N.queue.sessionIs, N.queue.sessionName, N.queue.sessionWait, N.queue.sessionFound, N.queue.sessionQuestion, N.queue.sessionEnd] : [N.queue.lead, ...resume, N.queue.subagent, N.queue.session, N.queue.wait, N.queue.git, N.queue.subagents, N.queue.live, N.queue.refresh, N.queue.found, N.queue.question, N.queue.answer];
   for (const line of lines)
     io.out(locale_default.fill(line, vars));
+  if (o.session) {
+    io.out(`Next: the lines above — the executor session's prompt as is: start_session, initiation "user_asked", cwd — the folder of the ${slug} checkout on this machine (not a worktree), ` + `use_worktree true, background — the first line above; keep the session's id it returns. ` + `The end of each of its turns comes as the app's note, like an executor's answer — task queue again: in a queue of ${slug} the task is =; ${SESSION_ARCHIVE}.`);
+  }
   return 0;
 }
 function actualizeChecks() {
@@ -2308,7 +2318,8 @@ function cmdTaskClose(io, slug, number, o) {
     const prs = [...issue.prs, ...fresh].map((p) => `#${p.number} ${p.state === "OPEN" ? "open" : "closed without a merge"}`).join(", ");
     const what = prs ? `PR ${prs}` : `the task is ${issue.state === "OPEN" ? "open" : "closed without being done"}, no merged PR`;
     const checked = found ? `; checked: the PR–task link, the branch <type>/${number}-<slug> and «Closes #${number}» in the body of the last ${RECENT_PRS} PRs into ${found.base}` : "";
-    throw new GhError(`#${number} is too early to close: ${what}${checked} — close after the PR is merged or the task is closed`);
+    const noPr = !prs && issue.state === "OPEN" ? `; a task without a PR (a data edit, a reconciliation, research) — close the issue as completed with a result comment: gh issue close ${number} --repo ${slug} --reason completed --comment "<result>", then task close ${number} again` : "";
+    throw new GhError(`#${number} is too early to close: ${what}${checked} — close after the PR is merged or the task is closed${noPr}`);
   }
   if (issue.parent) {
     const epic = loadTaskText(io, slug, issue.parent.number);
@@ -3121,7 +3132,7 @@ that can't be continued, in the worktree of its task's branch.
 Examples:
   github task resume`,
   "task queue": `github task queue [--epic N] [--type Task|Bug] [--priority Urgent,High] [--repo owner/repo]
-github task queue --assignment <N> [--cloud] [--repo owner/repo]
+github task queue --assignment <N> [--cloud | --session] [--repo owner/repo]
 
 The dispatcher session's queue: ready tasks (open, not an epic, not in work, no open blockers — other repositories'
 too —, no external blocker label) by Priority, then number, each with its executor's prompt; the rest — in work (=: In
@@ -3140,13 +3151,17 @@ such a subagent at work or HEAD moved in the last ${QUIET_MINUTES} min — code
 dispatcher wait, no hand-out. --cloud — printed by the dispatcher: the brief of a cloud executor (claude.ai/code) —
 whole, # only at its task — and the dispatcher's steps: a cloud session can't message a local one, so the dispatcher
 waits for the task's closing (ci-wait issue N, background) and closes it locally; the hand-out has no worktree, and the
-queue's = line names that wait.
+queue's = line names that wait. --session — printed by the dispatcher: the prompt of an app executor session
+(start_session in the folder of another project, its own worktree) — a session by its project's canon and mode, named
+by the task, waiting in the background, ending with the canon's last line — and how to start it; the hand-out has no
+worktree, the task is = in the queue.
 
 Examples:
   github task queue --epic 40
   github task queue --type Bug --priority Urgent,High
   github task queue --assignment 42
-  github task queue --assignment 42 --cloud`,
+  github task queue --assignment 42 --cloud
+  github task queue --assignment 42 --session`,
   "task close": `github task close <N> [--no-git] [--repo owner/repo]
 
 After the PR merge and the deploy (or a close without a PR) in one call: the actual (est fact --write), Status Done, the
@@ -3299,6 +3314,7 @@ function main(argv, io) {
           "no-git": { type: "boolean", default: false },
           assignment: { type: "boolean", default: false },
           cloud: { type: "boolean", default: false },
+          session: { type: "boolean", default: false },
           auto: { type: "boolean", default: false }
         }
       });
@@ -3324,10 +3340,14 @@ function main(argv, io) {
       if (cmd === "queue") {
         if (values.cloud && !values.assignment)
           throw new GhError("--cloud — only with --assignment <N>: the brief of one task's cloud executor");
+        if (values.session && !values.assignment)
+          throw new GhError("--session — only with --assignment <N>: the prompt of one task's app executor session");
+        if (values.cloud && values.session)
+          throw new GhError("--cloud or --session, not both: a cloud executor or an app session");
         if (values.assignment) {
           if (positionals.length !== 1)
             throw new GhError("task queue --assignment <N>: one task number");
-          return cmdTaskAssignment(io, slug, issueNumber(positionals[0], "task queue --assignment"), { cloud: values.cloud });
+          return cmdTaskAssignment(io, slug, issueNumber(positionals[0], "task queue --assignment"), { cloud: values.cloud, session: values.session });
         }
         if (positionals.length)
           throw new GhError(`extra arguments: ${positionals.join(" ")} — the queue is chosen by --epic, --type and --priority`);

package/dist/spec/scripts/architecture.js

@@ -1,11 +1,11 @@
 import {
   locale_default
-} from "./harness-qzb932c8.js";
+} from "./harness-wqrt5gpa.js";
 import {
   invariant2,
   codeOnly2,
   envNamesInCode2
-} from "./harness-v9s1v9w3.js";
+} from "./harness-ay62ws50.js";
 
 // skills/spec/scripts/architecture.ts
 import { readdirSync, readFileSync } from "node:fs";

package/dist/spec/scripts/{harness-v9s1v9w3.js → harness-ay62ws50.js}

@@ -1,6 +1,6 @@
 import {
   locale_default
-} from "./harness-qzb932c8.js";
+} from "./harness-wqrt5gpa.js";
 var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;

package/dist/spec/scripts/{harness-qzb932c8.js → harness-wqrt5gpa.js}

@@ -91,6 +91,7 @@ var en_default = {
     git: "- git — in separate calls, without `cd`, `&&` and `|`: worktree isolation refuses a compound command with git;",
     subagents: "- writing subagents — launch as needed, no limit: each gets its own worktree and «{task} #{number}» at the start of its prompt (`est` links its work by it); bring their commits into your branch, remove their worktrees and branches yourself after the merge — what didn't go, name in the answer;",
     live: "- while any of your subagents works, don't answer: wait for their answers — a background subagent wakes you with its answer; an answer with live subagents looks like a failure, and the dispatcher would give the task to a second executor next to you. Can't wait — answer `waits for subagents: <which and what they do>`: it isn't `failed`, there will be no second executor;",
+    refresh: '- the epic refresh — the subagent `task actualize` prints, without a worktree of its own (in yours) and not in the background (`run_in_background: false`): its answer — in the same turn, then `{script} task close {number}`, and only then the answer to the dispatcher: once you answer, a worktree without changes is removed, and a background subagent is left without a directory; a task without a PR (a data edit, a reconciliation, research) — first close the issue as completed with a result comment: `gh issue close {number} --repo {repo} --reason completed --comment "<result>"`;',
     found: "- work found outside the task — `{script} task new …` (work of the task's epic — with `--epic`: the dispatcher picks it up) — name it in the answer: whether to queue it is the owner's call;",
     question: "- a question without a clear recommendation — into «{questions}» of the task; don't start the code that depends on it and answer the dispatcher: the owner's answer comes back here.",
     answer: "The answer to the dispatcher — one line: `merged #<PR>` · `question: <the question, options, recommendation>` · `waits for subagents: <which and what they do>` · `failed: <what stopped and where>`.",
@@ -100,7 +101,14 @@ var en_default = {
     cloudDoc: "- the cloud — by `docs/cloud-sessions.md` of the canon, read it first: of the github skill's scripts `task show`, `task answer` and `task new` work there (over REST), the rest refuse, the scenarios section — by editing the description over REST, project fields aren't set from the cloud; the branch is the one the cloud assigned, don't rename it;",
     cloudClose: "- after the merge — its section «Closing a task from the cloud»: the «{actual}» comment of `est fact {number}` and a «{state}» comment with what the cloud can't do — both into the task;",
     cloudDispatcher: "- the dispatcher waits for the task to close and closes it locally — the actual, the status, the merged branch, archiving this session: don't message it, don't archive the session;",
-    cloudQuestion: "- a question without a clear recommendation — into «{questions}» of the task and to the owner in this session, don't start the code that depends on it; stopped (a question, a failure, a limit) — a «{state}» comment into the task."
+    cloudQuestion: "- a question without a clear recommendation — into «{questions}» of the task and to the owner in this session, don't start the code that depends on it; stopped (a question, a failure, a limit) — a «{state}» comment into the task.",
+    sessionLead: "{task} #{number} «{title}» in {repo}{epic}: you are an executor session of the dispatcher session — do the task whole by the canon of this project, in its mode (`check` prints it; outside auto — commit, push and merge on the owner's «yes»): the task's questions, `{script} task status {number} \"{inProgress}\" --branch <type>/{number}-<slug>`, the branch from a fresh origin/main, code and tests, PR, green CI, `pr premerge`, merge, deploy, the epic refresh, `{script} task close {number}`.",
+    sessionIs: "You are a session, not a subagent:",
+    sessionName: "- name the session `#{number} {title}` (`set_session_title`) once the task is taken — `est` links the session to the task by it;",
+    sessionWait: "- wait for CI and the deploy with a background command — `{waitCi} pr <PR>` (after the merge — `merged <PR>`): its completion wakes the session; no `Monitor`, watcher loop or `ScheduleWakeup` on top;",
+    sessionFound: "- work found outside the task — `{script} task new …` and the question «queue it?» by the canon; work of the task's epic — with `--epic` and without an executor of yours: the dispatcher's queue picks it up;",
+    sessionQuestion: "- a question without a clear recommendation — into «{questions}» of the task and to the owner in this session; don't start the code that depends on it: the answer comes here, from the owner or the dispatcher;",
+    sessionEnd: "- the end — the canon's last line («{done}» · «{doneQuestions} …» · «{remaining} …»), in auto mode after «{done}» — archiving the session by the canon: the dispatcher reads the end of each of your turns as your answer."
   },
   est: {
     answer: "Answer",
@@ -541,6 +549,7 @@ var ru_default = {
     git: "- git — отдельными вызовами, без `cd`, `&&` и `|`: составную команду с git изоляция worktree не пропускает;",
     subagents: "- пишущих субагентов запускай по необходимости, без лимита: каждому — свой worktree и «{task} #{number}» в начале промпта (по нему `est` привяжет его работу); их коммиты перенеси в свою ветку, их worktree и ветки после мержа убери сам — что не убралось, назови в ответе;",
     live: "- пока работает хоть один твой субагент, ответ не отдавай: жди их ответов — фоновый субагент будит тебя своим ответом; ответ при живых субагентах выглядит провалом, и диспетчер отдал бы задачу второму исполнителю рядом с тобой. Ждать нельзя — ответь `ждёт субагентов: <какие и что делают>`: это не «сломалось», второго исполнителя не будет;",
+    refresh: '- актуализация эпика — субагент, которого печатает `task actualize`, без своего worktree (в твоём) и не в фоне (`run_in_background: false`): его ответ — в том же ходе, затем `{script} task close {number}`, и только потом ответ диспетчеру: стоит тебе ответить, worktree без изменений убирают, и фоновый субагент остаётся без каталога; у задачи без PR (правка данных, сверка, исследование) — сначала закрой issue как выполненную с итоговым комментарием: `gh issue close {number} --repo {repo} --reason completed --comment "<итог>"`;',
     found: "- найденная работа вне задачи — `{script} task new …` (работа эпика задачи — с `--epic`: диспетчер её подхватит) — назови её в ответе: ставить ли её в очередь, решает владелец;",
     question: "- вопрос без ясной рекомендации — в «{questions}» задачи; код, который от него зависит, не начинай и ответь диспетчеру: ответ владельца придёт сюда же.",
     answer: "Ответ диспетчеру — одной строкой: `влито #<PR>` · `вопрос: <вопрос, варианты, рекомендация>` · `ждёт субагентов: <какие и что делают>` · `сломалось: <что и где остановилось>`.",
@@ -550,7 +559,14 @@ var ru_default = {
     cloudDoc: "- облако — по `docs/cloud-sessions.md` канона, прочитай его первым: из скриптов скилла github там работают `task show`, `task answer` и `task new` (через REST), остальные отказывают, раздел сценариев — правкой описания через REST, поля проекта из облака не ставятся; ветка — та, что назначило облако, не переименовывай;",
     cloudClose: "- после мержа — его раздел «Closing a task from the cloud»: комментарий «{actual}» от `est fact {number}` и комментарий «{state}» с тем, что из облака не сделать, — оба в задачу;",
     cloudDispatcher: "- диспетчер ждёт закрытия задачи и закрывает её локально — факт, статус, влитая ветка, архив этой сессии: сообщать ему не нужно, сессию не архивируй;",
-    cloudQuestion: "- вопрос без ясной рекомендации — в «{questions}» задачи и владельцу в этой сессии, код, который от него зависит, не начинай; остановился (вопрос, сбой, лимит) — комментарий «{state}» в задачу."
+    cloudQuestion: "- вопрос без ясной рекомендации — в «{questions}» задачи и владельцу в этой сессии, код, который от него зависит, не начинай; остановился (вопрос, сбой, лимит) — комментарий «{state}» в задачу.",
+    sessionLead: '{task} #{number} «{title}» в {repo}{epic}: ты сессия-исполнитель сессии-диспетчера — сделай задачу целиком по канону этого проекта, в его режиме (его печатает `check`; не в auto — коммит, пуш и мерж по «да» владельца): вопросы задачи, `{script} task status {number} "{inProgress}" --branch <тип>/{number}-<slug>`, ветка от свежего origin/main, код и тесты, PR, зелёный CI, `pr premerge`, мерж, деплой, актуализация эпика, `{script} task close {number}`.',
+    sessionIs: "Ты сессия, а не субагент:",
+    sessionName: "- назови сессию `#{number} {title}` (`set_session_title`), как только взял задачу, — по имени `est` привяжет сессию к задаче;",
+    sessionWait: "- CI и деплой жди фоновой командой — `{waitCi} pr <PR>` (после мержа — `merged <PR>`): её завершение будит сессию; без `Monitor`, цикла-наблюдателя и `ScheduleWakeup` поверх;",
+    sessionFound: "- найденная работа вне задачи — `{script} task new …` и вопрос «ставить в очередь?» по канону; работа эпика задачи — с `--epic` и без твоего исполнителя: её подхватит очередь диспетчера;",
+    sessionQuestion: "- вопрос без ясной рекомендации — в «{questions}» задачи и владельцу в этой сессии; код, который от него зависит, не начинай: ответ придёт сюда же — от владельца или диспетчера;",
+    sessionEnd: "- конец — последняя строка канона («{done}» · «{doneQuestions} …» · «{remaining} …»), в режиме auto после «{done}» — архивация сессии по канону: конец каждого твоего хода диспетчер читает как твой ответ."
   },
   est: {
     answer: "Ответ",

package/dist/spec/scripts/harness.js

@@ -23,8 +23,8 @@ import {
   envNamesInCode2,
   dotenvNames2,
   envVars2
-} from "./harness-v9s1v9w3.js";
-import"./harness-qzb932c8.js";
+} from "./harness-ay62ws50.js";
+import"./harness-wqrt5gpa.js";
 export {
   ENV_SERVICE2 as ENV_SERVICE,
   codeFiles2 as codeFiles,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miroshnik/elves",
-  "version": "2026.1018.2",
+  "version": "2026.1019.0",
   "type": "module",
   "description": "Elves — a development flow with AI agents: shared rules and skills for any agent; install — bunx @miroshnik/elves install -g; the installer and skill scripts — TypeScript under Bun, tests — bun test in tests/",
   "repository": {
@@ -66,9 +66,10 @@
     "@playwright/test": "^1.63.0",
     "@types/bun": "^1.4.2",
     "@types/node": "^26.6.2",
+    "corepack": "^0.36.0",
     "eslint": "^10.11.0",
     "eslint-plugin-boundaries": "^7.2.0",
     "knip": "^6.41.0"
   },
-  "gitHead": "40c5e0387c9bfa5dfb56d6a7f5b05a99333aabac"
+  "gitHead": "42576112e74dfdc383f64b0edb5e08a24ff4afa2"
 }

package/skills/ci-wait/SKILL.md

@@ -173,7 +173,9 @@ What to do next:
   (a preview deploy) won't change it, so FAIL comes at once.
 - PASS counts only when a snapshot without pending repeats for two polls in
   a row; `--expect N` — the minimum number of checks, below which we keep
-  waiting.
+  waiting. A snapshot without pending on the deadline gets its confirming
+  poll past it, at most one `--interval` (#627): otherwise the last poll,
+  which lands on the deadline, gave TIMEOUT at "N/N done".
 - Without branch protection `gh pr merge --auto` merges without waiting for
   CI — so `--auto` doesn't replace waiting.
 - One wait at a time: don't start a second `ci-wait` on the same PR in

package/skills/ci-wait/scripts/wait-ci.sh

@@ -12,7 +12,8 @@
 # The spec publish job (spec-publish) is not a check: neither awaited nor a FAIL — only by --context.
 # An empty list of checks — pending; PASS counts when a snapshot without pending repeats
 # two polls in a row (late-registering checks don't slip through) and there are no fewer checks
-# than --expect. The first failed check — FAIL right away; --wait-all — FAIL when all have finished.
+# than --expect; a snapshot without pending on the deadline gets its confirming poll past it, at most one
+# interval. The first failed check — FAIL right away; --wait-all — FAIL when all have finished.
 # --interval is the first interval: it grows with the wait — a tenth of the elapsed time, up to 5 min.
 # REST only: the GraphQL quota is shared by all sessions; a REST rate limit — waiting until the reset, and that wait
 # doesn't count toward --timeout (up to an hour). A gh failure (also in requests before the first poll) — retry, ERROR
@@ -370,8 +371,12 @@ while :; do
     echo "$(ts) $label: gh error ($errors): ${out:0:200}" >&2
     [ "$errors" -ge 5 ] && finish "ERROR gh: ${out:0:200}" 3
   fi
+  # the deadline doesn't take away an outcome already seen (#627): the last poll lands on the deadline (the nap is cut to
+  # it), and a snapshot without pending there awaited its confirming poll — TIMEOUT at "N/N done". Such a snapshot gets
+  # its confirming poll at the first interval, past the deadline too, but at most one interval past it
+  limit=$deadline; [ -n "$prev_terminal" ] && limit=$((deadline + interval))
   now=$(date +%s)
-  [ "$now" -ge "$deadline" ] && finish "TIMEOUT after $(dur $((now - start))) ($full)" 2
-  [ "$nap" -gt $((deadline - now)) ] && nap=$((deadline - now))
+  [ "$now" -ge "$limit" ] && finish "TIMEOUT after $(dur $((now - start))) ($full)" 2
+  [ "$nap" -gt $((limit - now)) ] && nap=$((limit - now))
   sleep "$nap"
 done

package/skills/github/SKILL.md

@@ -148,26 +148,26 @@ session, its own task stays pinned; one started for it — in the project
 folder, not a worktree: executors (subagents, cloud sessions) start from
 `main`. `task queue` prints ready
 tasks, each with an indented line — its executor's prompt. In Claude Code: an executor — `Agent` with
-`isolation: "worktree"` and `run_in_background: true`, the prompt — the
-indented line as is; at most 3 subagents and 5 cloud sessions at once, the
+`isolation: "worktree"` and `run_in_background: true`, the prompt — as
+is; at most 3 subagents and 5 cloud sessions at once, the
 owner's number replaces either; another project's task — an app session in
 its folder (`start_session`, own worktree);
 `=` — a task in work (In progress, an open PR, handed out to an executor of
 this session), not launched again. Before each launch — `get_usage`: the 5-hour limit at 85% and more —
 no new executors, the running ones finish, then `Remaining: N tasks, the
-limit`. After each executor's answer — `task queue` again: it removes
-finished executors' worktrees (`+`); its last line names the step:
+limit`. After each executor's answer — `task queue` again: it alone
+removes finished executors' worktrees (`+`), not `git worktree remove`; its last line names the step:
 an executor session whose task closed — the dispatcher archives it in an
 auto project, not one still working in the background or awaiting the
 owner's answer; outside auto the owner closes it. A question — to the
-owner in text; the answer — ✅ in the task's questions section and to the same
+owner in text; the answer — ✅ in the task and to the same
 executor with `SendMessage`. After the app restarts — each stopped executor
 is continued with `SendMessage` by its id, not replaced (`task resume`). Waits for subagents — it answers again. Failed — a
 task comment, no restart (the owner's restart:
 `--assignment` refuses while the previous executor lives); external
 blockers — `reference.md`, "Dependencies". Queue empty and nothing running — the summary, the last
-line (a session with its own task — after it) and, in auto mode, archiving. The executor's side (`--assignment`,
-a cloud one's: `--cloud`) — `reference.md`, "task queue".
+line (a session with its own task — after it) and, in auto mode, archiving. The executor's side (`--assignment`;
+`--cloud`, `--session`) — `reference.md`, "task queue".
 
 ## Git, PRs and merging — mechanics
 

package/skills/github/locales/en.json

@@ -87,6 +87,7 @@
     "git": "- git — in separate calls, without `cd`, `&&` and `|`: worktree isolation refuses a compound command with git;",
     "subagents": "- writing subagents — launch as needed, no limit: each gets its own worktree and «{task} #{number}» at the start of its prompt (`est` links its work by it); bring their commits into your branch, remove their worktrees and branches yourself after the merge — what didn't go, name in the answer;",
     "live": "- while any of your subagents works, don't answer: wait for their answers — a background subagent wakes you with its answer; an answer with live subagents looks like a failure, and the dispatcher would give the task to a second executor next to you. Can't wait — answer `waits for subagents: <which and what they do>`: it isn't `failed`, there will be no second executor;",
+    "refresh": "- the epic refresh — the subagent `task actualize` prints, without a worktree of its own (in yours) and not in the background (`run_in_background: false`): its answer — in the same turn, then `{script} task close {number}`, and only then the answer to the dispatcher: once you answer, a worktree without changes is removed, and a background subagent is left without a directory; a task without a PR (a data edit, a reconciliation, research) — first close the issue as completed with a result comment: `gh issue close {number} --repo {repo} --reason completed --comment \"<result>\"`;",
     "found": "- work found outside the task — `{script} task new …` (work of the task's epic — with `--epic`: the dispatcher picks it up) — name it in the answer: whether to queue it is the owner's call;",
     "question": "- a question without a clear recommendation — into «{questions}» of the task; don't start the code that depends on it and answer the dispatcher: the owner's answer comes back here.",
     "answer": "The answer to the dispatcher — one line: `merged #<PR>` · `question: <the question, options, recommendation>` · `waits for subagents: <which and what they do>` · `failed: <what stopped and where>`.",
@@ -96,7 +97,14 @@
     "cloudDoc": "- the cloud — by `docs/cloud-sessions.md` of the canon, read it first: of the github skill's scripts `task show`, `task answer` and `task new` work there (over REST), the rest refuse, the scenarios section — by editing the description over REST, project fields aren't set from the cloud; the branch is the one the cloud assigned, don't rename it;",
     "cloudClose": "- after the merge — its section «Closing a task from the cloud»: the «{actual}» comment of `est fact {number}` and a «{state}» comment with what the cloud can't do — both into the task;",
     "cloudDispatcher": "- the dispatcher waits for the task to close and closes it locally — the actual, the status, the merged branch, archiving this session: don't message it, don't archive the session;",
-    "cloudQuestion": "- a question without a clear recommendation — into «{questions}» of the task and to the owner in this session, don't start the code that depends on it; stopped (a question, a failure, a limit) — a «{state}» comment into the task."
+    "cloudQuestion": "- a question without a clear recommendation — into «{questions}» of the task and to the owner in this session, don't start the code that depends on it; stopped (a question, a failure, a limit) — a «{state}» comment into the task.",
+    "sessionLead": "{task} #{number} «{title}» in {repo}{epic}: you are an executor session of the dispatcher session — do the task whole by the canon of this project, in its mode (`check` prints it; outside auto — commit, push and merge on the owner's «yes»): the task's questions, `{script} task status {number} \"{inProgress}\" --branch <type>/{number}-<slug>`, the branch from a fresh origin/main, code and tests, PR, green CI, `pr premerge`, merge, deploy, the epic refresh, `{script} task close {number}`.",
+    "sessionIs": "You are a session, not a subagent:",
+    "sessionName": "- name the session `#{number} {title}` (`set_session_title`) once the task is taken — `est` links the session to the task by it;",
+    "sessionWait": "- wait for CI and the deploy with a background command — `{waitCi} pr <PR>` (after the merge — `merged <PR>`): its completion wakes the session; no `Monitor`, watcher loop or `ScheduleWakeup` on top;",
+    "sessionFound": "- work found outside the task — `{script} task new …` and the question «queue it?» by the canon; work of the task's epic — with `--epic` and without an executor of yours: the dispatcher's queue picks it up;",
+    "sessionQuestion": "- a question without a clear recommendation — into «{questions}» of the task and to the owner in this session; don't start the code that depends on it: the answer comes here, from the owner or the dispatcher;",
+    "sessionEnd": "- the end — the canon's last line («{done}» · «{doneQuestions} …» · «{remaining} …»), in auto mode after «{done}» — archiving the session by the canon: the dispatcher reads the end of each of your turns as your answer."
   },
   "est": {
     "answer": "Answer",

package/skills/github/locales/ru.json

@@ -87,6 +87,7 @@
     "git": "- git — отдельными вызовами, без `cd`, `&&` и `|`: составную команду с git изоляция worktree не пропускает;",
     "subagents": "- пишущих субагентов запускай по необходимости, без лимита: каждому — свой worktree и «{task} #{number}» в начале промпта (по нему `est` привяжет его работу); их коммиты перенеси в свою ветку, их worktree и ветки после мержа убери сам — что не убралось, назови в ответе;",
     "live": "- пока работает хоть один твой субагент, ответ не отдавай: жди их ответов — фоновый субагент будит тебя своим ответом; ответ при живых субагентах выглядит провалом, и диспетчер отдал бы задачу второму исполнителю рядом с тобой. Ждать нельзя — ответь `ждёт субагентов: <какие и что делают>`: это не «сломалось», второго исполнителя не будет;",
+    "refresh": "- актуализация эпика — субагент, которого печатает `task actualize`, без своего worktree (в твоём) и не в фоне (`run_in_background: false`): его ответ — в том же ходе, затем `{script} task close {number}`, и только потом ответ диспетчеру: стоит тебе ответить, worktree без изменений убирают, и фоновый субагент остаётся без каталога; у задачи без PR (правка данных, сверка, исследование) — сначала закрой issue как выполненную с итоговым комментарием: `gh issue close {number} --repo {repo} --reason completed --comment \"<итог>\"`;",
     "found": "- найденная работа вне задачи — `{script} task new …` (работа эпика задачи — с `--epic`: диспетчер её подхватит) — назови её в ответе: ставить ли её в очередь, решает владелец;",
     "question": "- вопрос без ясной рекомендации — в «{questions}» задачи; код, который от него зависит, не начинай и ответь диспетчеру: ответ владельца придёт сюда же.",
     "answer": "Ответ диспетчеру — одной строкой: `влито #<PR>` · `вопрос: <вопрос, варианты, рекомендация>` · `ждёт субагентов: <какие и что делают>` · `сломалось: <что и где остановилось>`.",
@@ -96,7 +97,14 @@
     "cloudDoc": "- облако — по `docs/cloud-sessions.md` канона, прочитай его первым: из скриптов скилла github там работают `task show`, `task answer` и `task new` (через REST), остальные отказывают, раздел сценариев — правкой описания через REST, поля проекта из облака не ставятся; ветка — та, что назначило облако, не переименовывай;",
     "cloudClose": "- после мержа — его раздел «Closing a task from the cloud»: комментарий «{actual}» от `est fact {number}` и комментарий «{state}» с тем, что из облака не сделать, — оба в задачу;",
     "cloudDispatcher": "- диспетчер ждёт закрытия задачи и закрывает её локально — факт, статус, влитая ветка, архив этой сессии: сообщать ему не нужно, сессию не архивируй;",
-    "cloudQuestion": "- вопрос без ясной рекомендации — в «{questions}» задачи и владельцу в этой сессии, код, который от него зависит, не начинай; остановился (вопрос, сбой, лимит) — комментарий «{state}» в задачу."
+    "cloudQuestion": "- вопрос без ясной рекомендации — в «{questions}» задачи и владельцу в этой сессии, код, который от него зависит, не начинай; остановился (вопрос, сбой, лимит) — комментарий «{state}» в задачу.",
+    "sessionLead": "{task} #{number} «{title}» в {repo}{epic}: ты сессия-исполнитель сессии-диспетчера — сделай задачу целиком по канону этого проекта, в его режиме (его печатает `check`; не в auto — коммит, пуш и мерж по «да» владельца): вопросы задачи, `{script} task status {number} \"{inProgress}\" --branch <тип>/{number}-<slug>`, ветка от свежего origin/main, код и тесты, PR, зелёный CI, `pr premerge`, мерж, деплой, актуализация эпика, `{script} task close {number}`.",
+    "sessionIs": "Ты сессия, а не субагент:",
+    "sessionName": "- назови сессию `#{number} {title}` (`set_session_title`), как только взял задачу, — по имени `est` привяжет сессию к задаче;",
+    "sessionWait": "- CI и деплой жди фоновой командой — `{waitCi} pr <PR>` (после мержа — `merged <PR>`): её завершение будит сессию; без `Monitor`, цикла-наблюдателя и `ScheduleWakeup` поверх;",
+    "sessionFound": "- найденная работа вне задачи — `{script} task new …` и вопрос «ставить в очередь?» по канону; работа эпика задачи — с `--epic` и без твоего исполнителя: её подхватит очередь диспетчера;",
+    "sessionQuestion": "- вопрос без ясной рекомендации — в «{questions}» задачи и владельцу в этой сессии; код, который от него зависит, не начинай: ответ придёт сюда же — от владельца или диспетчера;",
+    "sessionEnd": "- конец — последняя строка канона («{done}» · «{doneQuestions} …» · «{remaining} …»), в режиме auto после «{done}» — архивация сессии по канону: конец каждого твоего хода диспетчер читает как твой ответ."
   },
   "est": {
     "answer": "Ответ",

package/skills/github/reference.md

@@ -727,7 +727,10 @@ its epic refresh still ran in its directory, and the queue removed it): such a
 subagent — `parentAgentId` without its own `worktreePath` in Claude Code's
 subagent metadata of this session and of the sessions with hand-outs
 (`dispatchers/*.tasks`), at any depth; at work — its transcript
-(`agent-<id>.jsonl`) written in the last 15 minutes.
+(`agent-<id>.jsonl`) written in the last 15 minutes. An executor's worktree is
+removed only by the queue, not by the dispatcher's `git worktree remove` after
+a clean `git status` (#628): a live subagent without a worktree of its own
+leaves no trace in `git status`, and its directory goes from under it.
 A session started to dispatch works in the project folder, not a worktree
 (#588): the app starts a cloud session from the branch in the starting
 session's record (`get_session` → `branch`), not from git — a session from
@@ -771,7 +774,14 @@ branches removed by the executor after the merge, no answer while any of its
 subagents works (#565: an answer with live subagents reads as a failure — the
 executor of #545 answered failed, its subagents' answers woke it, and it merged
 the task while a second executor, launched on the owner's restart, worked on the
-same branch), found work — `task new`,
+same branch), the epic refresh — the subagent of `task actualize` without a
+worktree of its own and not in the background: its answer in the same turn,
+then `task close`, then the answer (#628: an executor of a task without
+commits answered «waits for subagents» while its refresh ran, and its
+worktree, without changes, was removed under the refresh subagent once it
+answered), a task without a PR — first the issue closed as completed with a
+result comment (`gh issue close N --reason completed --comment …`: `task
+close` needs it closed), found work — `task new`,
 named in the answer (whether to queue it is the owner's call); the answer — one
 line: merged, a question, waits for subagents (it can't wait — not a failure) or
 failed.
@@ -815,7 +825,13 @@ The app's sessions are executors too: another project's task — an app session
 in its folder (`start_session` with its own worktree), while a subagent works
 in a worktree of the dispatcher's repository. Such a session works as a session
 of its project, by its mode; the end of its turn comes as the app's note, like
-an answer, — `task queue` again. Archiving, app and cloud executors alike
+an answer, — `task queue` again. Its prompt — `--assignment N --session`,
+called by the dispatcher itself (#624): the lines before `Next:` as is — a
+session, not a subagent, so the subagent's lines don't apply: by the canon of its
+project and its mode, named `#N <title>`, CI and the deploy waited for with a
+background command, the canon's last line at the end; `Next:` — `start_session`
+with `cwd` the project folder and `use_worktree` true. The hand-out — without a
+worktree (`@session`): the task is `=` in the queue. Archiving, app and cloud executors alike
 (#621): an executor session whose task closed — the dispatcher archives it in
 an auto project, not one still working in the background or awaiting the
 owner's answer; outside auto the owner closes it. Closed — `task close` passed:
@@ -888,7 +904,11 @@ the background the subagent with the assignment, if a refresh is needed; a wait
 notification with code 0 — `task close N` right away, don't read the output
 file (not 0 — the `RESULT:` line in it); the subagent hasn't reported yet —
 close refuses before any change: close again after its answer; then the last
-line of the answer and archiving — in one turn.
+line of the answer and archiving — in one turn. A dispatcher's executor runs
+the subagent not in the background and waits for its answer in the same turn,
+before `task close` and its own answer (its assignment, #628): once it answers,
+its worktree without changes is removed, and a background subagent is left
+without a directory.
 
 ### task close
 
@@ -900,7 +920,10 @@ then the task's PR is searched among the default branch's recent PRs by the
 branch `<type>/<N>-<slug>` and "Closes #N" in the body: merged — the task is
 closed with the comment «Closed by PR #M: GitHub didn't link the PR to the
 task», none — a refusal
-listing what was checked (no manual `gh issue close` needed). The epic has
+listing what was checked (no manual `gh issue close` needed). No PR at all and
+the task open — the refusal also names the step a task without commits (a data
+edit, a reconciliation, research) lacks: `gh issue close N --reason completed
+--comment "<result>"`, then `task close N` again (#628). The epic has
 open tasks besides this one and no report of the refresh on it — a comment
 with «Refresh after #N, result:» in any language of the dictionary, case and
 markup aside; the script's own «Refresh after #N, script: …» comes before the

package/skills/github/scripts/github.ts

@@ -21,8 +21,9 @@
  *   github task close    — after the merge and the deploy: the actual, "Done", the epic and the milestone, the task's
  *                          stacks (task-env) and the task's merged branches removed
  *   github task queue    — the dispatcher's ready tasks with the prompts of their executors (subagents);
- *                          --assignment — an executor's whole assignment
- *   github pr labels     — decision labels for the task from "Closes #N" by the PR diff, for its epic — the union
+ *                          --assignment — an executor's whole assignment (--cloud, --session — the prompt of a cloud
+ *                          executor or an app executor session, printed by the dispatcher)
+ *   github pr labels    — decision labels for the task from "Closes #N" by the PR diff, for its epic — the union
  *   github pr premerge   — before the merge: the default branch moved after the PR's CI — typecheck and test:spec on
  *                          the merge with it
  *
@@ -1773,23 +1774,29 @@ const isDispatcher = (io: Io) => {
  * with `SendMessage` (`task resume`) — dropped, it would make a task not yet In progress ready for a second executor.
  * The worktree — the checkout the executor called its assignment in (#533): the queue keeps it while the task is open. A
  * cloud executor's (`--assignment N --cloud`, #609) — `CLOUD_HANDOUT` in its place: the dispatcher printed its brief,
- * there is no worktree, and the queue names the wait for the task's closing.
+ * there is no worktree, and the queue names the wait for the task's closing. An app executor session's (`--assignment N
+ * --session`, #624) — `SESSION_HANDOUT`: the dispatcher printed its prompt, the app makes the session's worktree later.
  */
 const handedOutFile = (io: Io) => {
   const file = dispatcherFile(io);
   return file && `${file}.tasks`;
 };
 
-/** A hand-out: the task and its executor's worktree; the assignment called outside a checkout or a cloud one — null. */
+/** A hand-out: the task and its executor's worktree; the assignment called outside a checkout, a cloud or a session one — null. */
 interface HandOut {
   number: number;
   worktree: string | null;
-  /** A cloud executor's (#609): the dispatcher waits for the task's closing. */
-  cloud: boolean;
+  /**
+   * Who executes it: a subagent of this session; a cloud session (#609) — the dispatcher waits for the task's closing; an
+   * app session (#624) — the end of each of its turns comes as the app's note.
+   */
+  executor: "subagent" | "cloud" | "session";
 }
 
 /** A cloud executor's mark in place of the worktree: a worktree is an absolute path. */
 const CLOUD_HANDOUT = "@cloud";
+/** An app executor session's mark in place of the worktree (#624): the app makes the session's worktree after the hand-out. */
+const SESSION_HANDOUT = "@session";
 
 /** The repository's tasks handed out to this dispatcher's executors (`handedOutFile`); a line without a worktree — `null`. */
 function handedOut(io: Io, slug: string): HandOut[] {
@@ -1806,7 +1813,8 @@ function handOutsIn(file: string, slug: string): HandOut[] {
     .map((l) => {
       const [number, ...rest] = l.slice(slug.length + 1).split(" ");
       const worktree = rest.join(" ").trim();
-      return { number: Number(number), worktree: worktree === CLOUD_HANDOUT ? null : worktree || null, cloud: worktree === CLOUD_HANDOUT };
+      const executor: HandOut["executor"] = worktree === CLOUD_HANDOUT ? "cloud" : worktree === SESSION_HANDOUT ? "session" : "subagent";
+      return { number: Number(number), worktree: executor === "subagent" ? worktree || null : null, executor };
     })
     .filter((h) => Number.isInteger(h.number) && h.number > 0);
 }
@@ -2429,7 +2437,9 @@ export function cmdTaskQueue(io: Io, slug: string, o: QueueFilter): number {
     const work = [status === N.status.inProgress ? q(N.status.inProgress) : "", pr === undefined ? "" : `open PR #${pr} https://github.com/${slug}/pull/${pr}`].filter(Boolean);
     const hand = handed.find((h) => h.number === i.number);
     // a cloud executor's wait for the task's closing dies with the app's process: the line names it, task resume — the queue
-    if (!work.length && hand?.cloud) work.push(`handed out to a cloud executor of this session, its wait — a background command: bash ${waitCi()} issue ${i.number}`);
+    if (!work.length && hand?.executor === "cloud") work.push(`handed out to a cloud executor of this session, its wait — a background command: bash ${waitCi()} issue ${i.number}`);
+    // an app executor session (#624): the app continues the dispatcher at the end of each of its turns
+    else if (!work.length && hand?.executor === "session") work.push("handed out to an app executor session of this session (start_session) — the end of each of its turns comes as the app's note");
     else if (!work.length && hand) work.push("handed out to an executor of this session");
     if (work.length) {
       running.push(`= ${label} — ${work.join(", ")}`);
@@ -2812,8 +2822,14 @@ function taskBranchesHere(io: Io, slug: string, number: number): string[] {
  * queue` refuses in the cloud; `#` only at its task (`est` links a cloud session by the only `#N` of its first
  * prompt — docs/cloud-sessions.md, "The brief"); no restart line — the cloud assigns its own branch. A cloud session
  * can't message a local one, so `Next:` gives the dispatcher the wait for the task's closing and the local close.
+ * The epic refresh — in the same turn, not in the background, then `task close`, then the answer (#628): an executor of a
+ * task without commits answered «waits for subagents» while its refresh ran, and its worktree without changes was
+ * removed under the refresh subagent; a task without a PR is closed as completed first — `task close` needs it closed.
+ * `session` — the prompt of an app executor session (`start_session`: another project's task, #624), printed by the
+ * dispatcher: a session, not a subagent — by the canon of its project and its mode, named by the task, waits in the
+ * background, the canon's last line; the subagent's lines say the opposite. `Next:` — how to start it.
  */
-export function cmdTaskAssignment(io: Io, slug: string, number: number, o: { cloud: boolean } = { cloud: false }): number {
+export function cmdTaskAssignment(io: Io, slug: string, number: number, o: { cloud?: boolean; session?: boolean } = {}): number {
   const issue = loadIssue(io, slug, number);
   const file = handedOutFile(io);
   const own = pinnedTask(io)?.task;
@@ -2830,7 +2846,7 @@ export function cmdTaskAssignment(io: Io, slug: string, number: number, o: { clo
     mkdirSync(path.dirname(file), { recursive: true });
     // the configuration directory may be a personal git checkout (ELVES_PRIVATE) — hand-outs aren't committed into it
     writeFileSync(path.join(path.dirname(file), ".gitignore"), "*\n");
-    const where = o.cloud ? CLOUD_HANDOUT : worktree;
+    const where = o.cloud ? CLOUD_HANDOUT : o.session ? SESSION_HANDOUT : worktree;
     appendFileSync(file, `${slug}#${number}${where ? ` ${where}` : ""}\n`);
   }
   if (o.cloud) return cloudBrief(io, slug, issue), 0;
@@ -2847,9 +2863,22 @@ export function cmdTaskAssignment(io: Io, slug: string, number: number, o: { clo
     done: N.lastLine.done,
     questions: N.sections.questions,
     branches: restart.map((b) => `\`${b}\``).join(", "),
+    doneQuestions: N.lastLine.questions,
+    remaining: N.lastLine.remaining,
   };
-  const lines = [N.queue.lead, ...(restart.length ? [N.queue.resume] : []), N.queue.subagent, N.queue.session, N.queue.wait, N.queue.git, N.queue.subagents, N.queue.live, N.queue.found, N.queue.question, N.queue.answer];
+  const resume = restart.length ? [N.queue.resume] : [];
+  // the epic refresh in the same turn (`refresh`, #628) — the subagent's: a session runs it by the canon, with the deploy's wait
+  const lines = o.session
+    ? [N.queue.sessionLead, ...resume, N.queue.sessionIs, N.queue.sessionName, N.queue.sessionWait, N.queue.sessionFound, N.queue.sessionQuestion, N.queue.sessionEnd]
+    : [N.queue.lead, ...resume, N.queue.subagent, N.queue.session, N.queue.wait, N.queue.git, N.queue.subagents, N.queue.live, N.queue.refresh, N.queue.found, N.queue.question, N.queue.answer];
   for (const line of lines) io.out(locale.fill(line, vars));
+  if (o.session) {
+    io.out(
+      `Next: the lines above — the executor session's prompt as is: start_session, initiation "user_asked", cwd — the folder of the ${slug} checkout on this machine (not a worktree), ` +
+        `use_worktree true, background — the first line above; keep the session's id it returns. ` +
+        `The end of each of its turns comes as the app's note, like an executor's answer — task queue again: in a queue of ${slug} the task is =; ${SESSION_ARCHIVE}.`,
+    );
+  }
   return 0;
 }
 
@@ -3119,7 +3148,12 @@ export function cmdTaskClose(io: Io, slug: string, number: number, o: { git: boo
     const prs = [...issue.prs, ...fresh].map((p) => `#${p.number} ${p.state === "OPEN" ? "open" : "closed without a merge"}`).join(", ");
     const what = prs ? `PR ${prs}` : `the task is ${issue.state === "OPEN" ? "open" : "closed without being done"}, no merged PR`;
     const checked = found ? `; checked: the PR–task link, the branch <type>/${number}-<slug> and «Closes #${number}» in the body of the last ${RECENT_PRS} PRs into ${found.base}` : "";
-    throw new GhError(`#${number} is too early to close: ${what}${checked} — close after the PR is merged or the task is closed`);
+    // no PR at all and the task open — a task without commits closes its issue itself, and its executor didn't know (#628)
+    const noPr =
+      !prs && issue.state === "OPEN"
+        ? `; a task without a PR (a data edit, a reconciliation, research) — close the issue as completed with a result comment: gh issue close ${number} --repo ${slug} --reason completed --comment "<result>", then task close ${number} again`
+        : "";
+    throw new GhError(`#${number} is too early to close: ${what}${checked} — close after the PR is merged or the task is closed${noPr}`);
   }
   if (issue.parent) {
     const epic = loadTaskText(io, slug, issue.parent.number);
@@ -4151,7 +4185,7 @@ that can't be continued, in the worktree of its task's branch.
 Examples:
   github task resume`,
   "task queue": `github task queue [--epic N] [--type Task|Bug] [--priority Urgent,High] [--repo owner/repo]
-github task queue --assignment <N> [--cloud] [--repo owner/repo]
+github task queue --assignment <N> [--cloud | --session] [--repo owner/repo]
 
 The dispatcher session's queue: ready tasks (open, not an epic, not in work, no open blockers — other repositories'
 too —, no external blocker label) by Priority, then number, each with its executor's prompt; the rest — in work (=: In
@@ -4170,13 +4204,17 @@ such a subagent at work or HEAD moved in the last ${QUIET_MINUTES} min — code
 dispatcher wait, no hand-out. --cloud — printed by the dispatcher: the brief of a cloud executor (claude.ai/code) —
 whole, # only at its task — and the dispatcher's steps: a cloud session can't message a local one, so the dispatcher
 waits for the task's closing (ci-wait issue N, background) and closes it locally; the hand-out has no worktree, and the
-queue's = line names that wait.
+queue's = line names that wait. --session — printed by the dispatcher: the prompt of an app executor session
+(start_session in the folder of another project, its own worktree) — a session by its project's canon and mode, named
+by the task, waiting in the background, ending with the canon's last line — and how to start it; the hand-out has no
+worktree, the task is = in the queue.
 
 Examples:
   github task queue --epic 40
   github task queue --type Bug --priority Urgent,High
   github task queue --assignment 42
-  github task queue --assignment 42 --cloud`,
+  github task queue --assignment 42 --cloud
+  github task queue --assignment 42 --session`,
   "task close": `github task close <N> [--no-git] [--repo owner/repo]
 
 After the PR merge and the deploy (or a close without a PR) in one call: the actual (est fact --write), Status Done, the
@@ -4347,6 +4385,7 @@ export function main(argv: string[], io: Io): number {
           "no-git": { type: "boolean", default: false },
           assignment: { type: "boolean", default: false },
           cloud: { type: "boolean", default: false },
+          session: { type: "boolean", default: false },
           auto: { type: "boolean", default: false },
         },
       });
@@ -4368,9 +4407,11 @@ export function main(argv: string[], io: Io): number {
       }
       if (cmd === "queue") {
         if (values.cloud && !values.assignment) throw new GhError("--cloud — only with --assignment <N>: the brief of one task's cloud executor");
+        if (values.session && !values.assignment) throw new GhError("--session — only with --assignment <N>: the prompt of one task's app executor session");
+        if (values.cloud && values.session) throw new GhError("--cloud or --session, not both: a cloud executor or an app session");
         if (values.assignment) {
           if (positionals.length !== 1) throw new GhError("task queue --assignment <N>: one task number");
-          return cmdTaskAssignment(io, slug, issueNumber(positionals[0], "task queue --assignment"), { cloud: values.cloud! });
+          return cmdTaskAssignment(io, slug, issueNumber(positionals[0], "task queue --assignment"), { cloud: values.cloud!, session: values.session! });
         }
         if (positionals.length) throw new GhError(`extra arguments: ${positionals.join(" ")} — the queue is chosen by --epic, --type and --priority`);
         const priority = values.priority === undefined ? undefined : values.priority.split(",").map((x) => x.trim()).filter(Boolean);

package/skills/github/scripts/locale.ts

@@ -102,6 +102,8 @@ export interface Names {
     subagents: string;
     /** The executor's answer waits for its own subagents (#565). */
     live: string;
+    /** The epic refresh — in the same turn, before `task close` and the answer; a task without a PR closed first (#628). */
+    refresh: string;
     found: string;
     question: string;
     answer: string;
@@ -114,6 +116,17 @@ export interface Names {
     cloudClose: string;
     cloudDispatcher: string;
     cloudQuestion: string;
+    /**
+     * An app executor session's prompt (`--assignment N --session`, #624): a session of another project, not a subagent —
+     * by its canon and mode, named by the task, waits in the background, the canon's last line.
+     */
+    sessionLead: string;
+    sessionIs: string;
+    sessionName: string;
+    sessionWait: string;
+    sessionFound: string;
+    sessionQuestion: string;
+    sessionEnd: string;
   };
   /** The est skill's "Estimate" and "Actual" comments and the lines a human appends to them. */
   est: {