@miroshnik/elves 2026.1019.0 → 2026.1019.2

package/AGENTS.md

@@ -199,9 +199,9 @@ it.
   PR's CI — fast checks on the merge with it; red — I fix the root cause;
   `main` red by itself (exit code 3) — no merge and no fix in the PR: one bug
   for it, I wait for it to close.
-- A merge that deploys — I wait for the deploy on the merge SHA (`ci-wait`),
-  the epic refresh in parallel; **then `github task close`**. Others'
-  branches, stacks and unmerged work I don't touch.
+- A merge that deploys — I wait for the deploy on the merge SHA (`ci-wait`)
+  **before `github task close`**. Others' branches, stacks and unmerged work
+  I don't touch.
 - Mechanics — the `github` skill, "Git, PRs and merging — mechanics";
   waiting for checks and deploys — `docs/pr-checks.md`.
 
@@ -222,8 +222,9 @@ folder's `exceptions/`, with an `#issue`, a reason and a ratchet. Test names
 are statements in the project language; a code task gets the scenarios
 section (future `it` names) before code. The PR body is `spec-diff` output;
 docs are generated (`spec-doc`) and published by CI to the `spec` branch. A
-recurring decision — a "Standard · …" issue and a rule in `tests/standards/`.
-The full canon and wiring — the `spec` skill (`canon.md`, `checks.md`).
+recurring decision — a "Standard · …" issue and a rule in `tests/standards/`;
+repeats in a PR's files — fixed in it. The full canon and wiring — the `spec`
+skill (`canon.md`, `checks.md`).
 
 ## Tests and code
 
@@ -282,8 +283,8 @@ The full canon and wiring — the `spec` skill (`canon.md`, `checks.md`).
   skill) at `<service>.<N>.<project>.localhost`, not on a host port; others'
   stacks and busy ports I don't touch — `docs/parallel-checkouts.md`.
 - **A subagent gets a unit of ~50 turns** (one decision's folder, one file,
-  one spec), not a 200-turn zone: it carries the same preamble (≈ 100k
-  tokens), and its price is quadratic in turns. The assignment has the task
+  one spec), not a 200-turn zone: with the same ≈ 100k-token preamble its
+  price is quadratic in turns. The assignment has the task
   number after the word for "task" or at the start, the epic after the word
   for "epic" ("Language") — so `est` links its work. **Fewer turns:** a file
   in one full read, independent tool calls in one turn.

package/README.md

@@ -155,7 +155,7 @@ No exaggeration: the spec format isn't the main token cost; what costs more is h
 You need `git` and [Bun](https://bun.sh) ≥ 1.2 — the installer (`bunx`) and the skill scripts run under it; a project's CI on Node adds the `oven-sh/setup-bun` step; the `github`, `est` and `dashboard` skills need [`gh`](https://cli.github.com) with the `project` scope (`gh auth refresh -s project`); `task-env` needs Docker with Compose (Docker Desktop on macOS).
 
 ```bash
-# onto the machine — the canon, skills and the hook for every agent it has; or a global package:
+# onto the machine — the canon, skills and the hook for every agent it has, and the elves command on PATH; or a global package:
 # bun add -g @miroshnik/elves && elves install -g
 bunx @miroshnik/elves install -g
 
@@ -193,7 +193,7 @@ An agent's sandbox (Claude Code's Bash) doesn't let bunx write its cache `~/.bun
 - Updating — `update` bumps the package version: `package.json` and the lockfile, a few lines in the branch of the current task, committed with it. A project with a copy of the flow of an earlier release moves to a thin one in a task of its own, one per project — `check` prints its `task new`, the hook names the canon loaded twice until then: `update` removes the copy, its symlinks and `.gitignore` exceptions, leads imports and CI paths into the copy to the package and lists what else names `.agents`.
 - The manifest, the shim, `AGENTS.md` and `.claude/settings.json`, if the project's git ignores them (`.agents/` or `.claude/` in `.gitignore`), are un-ignored by `install` and `update` with exceptions — an Elves block at the end of `.gitignore`, committed with them; what an exception can't un-ignore (a directory excluded by a personal rule), and anything ignored until `update` runs — `❌` in the output of the install and of `check`.
 
-**Onto the machine** (`-g`) — the canon, the skills and the hook: a thin project keeps no copy of the canon, its agents get it from the machine. `~/.agents/elves/` — `AGENTS.md`, `claude/CLAUDE.md`, `docs/*.md`; Claude Code — symlinks `~/.claude/rules/elves.md` and `elves-claude.md` (loaded in every project without the external-imports dialog), `~/.claude/skills` and the `SessionStart` hook in `~/.claude/settings.json`; the other agents — their global rule file linking to the canon (`~/.codex/AGENTS.md`, `~/.gemini/GEMINI.md`, `~/.copilot/copilot-instructions.md`, `~/.config/opencode/AGENTS.md`, `~/.config/amp/AGENTS.md`; a file of your own stays) and `~/.agents/skills`. A project that still has a copy loads the canon twice until it moves — the hook names it. A Claude Code cloud session gets the same from the project's `SessionStart` hook — `npm i -g bun@latest @miroshnik/elves && elves install -g` (the image's Bun lags behind), then `check --hook`; the machine's hook isn't there (the cloud doesn't read `~/.claude/settings.json`), an environment's setup script with the same command is an optional faster start. In an Elves clone with `--link` the machine's canon is the clone; its `.claude/CLAUDE.md` keeps the root `AGENTS.md` from loading a second time.
+**Onto the machine** (`-g`) — the canon, the skills and the hook: a thin project keeps no copy of the canon, its agents get it from the machine. `~/.agents/elves/` — `AGENTS.md`, `claude/CLAUDE.md`, `docs/*.md`; Claude Code — symlinks `~/.claude/rules/elves.md` and `elves-claude.md` (loaded in every project without the external-imports dialog), `~/.claude/skills` and the `SessionStart` hook in `~/.claude/settings.json`; the other agents — their global rule file linking to the canon (`~/.codex/AGENTS.md`, `~/.gemini/GEMINI.md`, `~/.copilot/copilot-instructions.md`, `~/.config/opencode/AGENTS.md`, `~/.config/amp/AGENTS.md`; a file of your own stays) and `~/.agents/skills`. The `elves` command in the terminal — in `~/.local/bin`, or the first directory of `PATH` inside the home directory you can write to: with `--link` a symlink to the clone's `bin/elves.ts`, otherwise a shim to the machine's release (`bunx @miroshnik/elves@<version>`) that `update -g` rewrites; an `elves` of your own (a script, a global package) stays, and `check -g` names it, a command missing or of another release, an `elves` earlier on `PATH`, and — when `PATH` has no such directory — the command that adds `~/.local/bin`. A project that still has a copy loads the canon twice until it moves — the hook names it. A Claude Code cloud session gets the same from the project's `SessionStart` hook — `npm i -g bun@latest @miroshnik/elves && elves install -g` (the image's Bun lags behind), then `check --hook`; the machine's hook isn't there (the cloud doesn't read `~/.claude/settings.json`), an environment's setup script with the same command is an optional faster start. In an Elves clone with `--link` the machine's canon is the clone; its `.claude/CLAUDE.md` keeps the root `AGENTS.md` from loading a second time.
 
 **Personal configuration** — everything that depends on specific repositories (the registry for `est`, your own model prices, notes) — lives outside the flow, in `~/.config/elves`; another directory — the `ELVES_CONFIG_DIR` variable, read by all skill scripts. `ELVES_PRIVATE=<path>` with `install -g` makes `~/.config/elves` a symlink to a private checkout; with `ELVES_CONFIG_DIR` the symlink isn't needed — the variable points at the checkout itself.
 

package/bin/elves.ts

@@ -6,7 +6,8 @@
  *
  *   bunx @miroshnik/elves install                      — into the project: the git root (or the current directory)
  *   bunx @miroshnik/elves install -g                   — machine-wide: the canon, skills and hook
- *   elves install -g                                   — the same from the npm package (npm i -g @miroshnik/elves)
+ *   elves install -g                                   — the same from the npm package (npm i -g @miroshnik/elves);
+ *                                                        install -g puts the elves command on PATH (`installCommand`)
  *   bun <Elves clone>/bin/elves.ts install -g --link   — from a clone: symlinks to the clone, edits show at once
  *   bunx @miroshnik/elves check [-g]                   — is the install behind: 0 — no, 1 — yes, 2 — can't tell
  *   bunx @miroshnik/elves update [-g]                  — bring the install up to date
@@ -76,7 +77,7 @@
  * proxy name) instead of holding copies. No dependencies, only node: APIs.
  */
 import { execFileSync, spawnSync } from "node:child_process";
-import { cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, readlinkSync, readSync, realpathSync, renameSync, rmSync, statSync, symlinkSync, writeFileSync } from "node:fs";
+import { accessSync, constants as fsConstants, cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, readlinkSync, readSync, realpathSync, renameSync, rmSync, statSync, symlinkSync, writeFileSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { isatty } from "node:tty";
@@ -223,7 +224,10 @@ terminal — the previous one. In an Elves clone writes only auto and language,
 from the clone itself.
 -g — onto the machine: the canon in ~/.agents/elves with Claude Code's rules ~/.claude/rules/elves*.md and the global
 rule files of Codex, Gemini CLI, Copilot, OpenCode and Amp linking to it (someone else's file stays), the skills
-(~/.agents/skills, ~/.claude/skills) and the SessionStart hook; without a terminal too — a cloud session's project hook
+(~/.agents/skills, ~/.claude/skills), the SessionStart hook and the elves command in the terminal — in ~/.local/bin or
+the first directory of PATH inside the home directory that can be written: with --link a symlink to the clone's
+bin/elves.ts, otherwise a shim to the machine's release (bunx ${PACKAGE}@<version>); someone else's elves there stays
+(!), no such directory — no command, check -g names how to add one; without a terminal too — a cloud session's project hook
 or setup script (CLAUDE_CODE_REMOTE=true) gets the canon and skills without the hook: the cloud doesn't read
 ~/.claude/settings.json. From the npm package (npm i -g / bun add -g ${PACKAGE}) — the release of its version, without
 the network. --link — from an Elves clone: symlinks to the clone instead of copies, edits show up immediately.
@@ -242,7 +246,9 @@ mode (auto) and the language, holds the compose file to the task isolation rules
 docker compose; the task-env skill), names a test that runs standards and architecture again next to test:spec (○, the
 ready test without them) and warns (!) if a script in slot calls turbo and turbo.json doesn't pass the queue variables
 to tasks or a line leads into a file of the flow copy that update doesn't rewrite — the file, the line number and its
-text (the exit code stays the same); a thin project behind — update in this session's task (the package version in
+text (the exit code stays the same); for the machine the elves command missing or of another release is falling
+behind, someone else's elves in its place or one earlier on PATH — !, no directory for it — ! with the command that
+adds ~/.local/bin to PATH; a thin project behind — update in this session's task (the package version in
 package.json and the lockfile), a project with a copy of the flow — the move to a thin project in a task of its own: the
 task new command of the github skill, one task per project. For the machine names the task-env proxy of *.localhost
 addresses — running, not running or running
@@ -260,7 +266,7 @@ Examples:
   update: `elves update [-g]
 
 Brings it up to date: a --link clone — git pull --ff-only, the machine's copy — install of the latest release: the
-canon, the skills and the hook; a project — install of the latest release: ${PACKAGE} in package.json and the
+canon, the skills, the hook and the elves shim of that release; a project — install of the latest release: ${PACKAGE} in package.json and the
 lockfile, a few lines in the branch of the current task; a project with a copy of the flow moves to a thin one (install
 --help), by hand after it — a check of the project that knows the queue wrapper by the copy's path (. .agents/slot.sh
 now), AI_DEV_SLOT* in the project's code → ELVES_SLOT*, formatting the shortened imports, git add -A before the first
@@ -1794,6 +1800,150 @@ function agentRules(home: string, has: (dir: string, cmd?: string) => boolean) {
   }
 }
 
+/**
+ * The `elves` command in the terminal (#632): `bunx @miroshnik/elves …` and `bun <clone>/bin/elves.ts …` aren't a
+ * command, and the global package's bin directory (`~/.bun/bin`) may not be on PATH at all — Bun from Homebrew.
+ * Where — `commandDir`; what — with `--link` a symlink to the clone's `bin/elves.ts` (its `sh` shebang works through a
+ * symlink), otherwise a shim to the machine's release through bunx (`commandShim`): the bunx directory is temporary,
+ * and the command matches the canon on the machine — `update -g` rewrites it with the release. Ours (`ownCommand`) is
+ * replaced; someone else's `elves` in that directory — a script of the user's, a global package — stays with a `!`
+ * line, and so does an `elves` earlier on PATH that the shell runs instead. No directory for it — no command: the `!`
+ * line of `check -g` has the command that adds `~/.local/bin` to PATH. Not in a cloud session: there the flow comes
+ * by `npm i -g` (`CLOUD_FLOW`), and its `elves` is the command.
+ */
+const COMMAND = "elves";
+/** The shim's line by which the install knows its own file. */
+const COMMAND_MARK = "# Elves: the machine's elves command";
+/** What a dry run names next to the command's path. */
+const COMMAND_NOTE = "the elves command in the terminal";
+
+/** PATH directories: absolute, in order, without repeats. */
+const pathDirs = () => [...new Set((process.env.PATH ?? "").split(path.delimiter).filter((d) => path.isAbsolute(d)).map((d) => path.resolve(d)))];
+
+/** A directory the install can write into. */
+function writableDir(dir: string) {
+  try {
+    accessSync(dir, fsConstants.W_OK);
+    return statSync(dir).isDirectory();
+  } catch {
+    return false;
+  }
+}
+
+/** A file the shell runs: a regular file (through symlinks) with the execute bit. */
+function runnable(file: string) {
+  try {
+    accessSync(file, fsConstants.X_OK);
+    return statSync(file).isFile();
+  } catch {
+    return false;
+  }
+}
+
+/** Under dir, dir itself aside — by the path as given or by the real one (macOS /var → /private/var). */
+function inside(dir: string, p: string) {
+  const real = (x: string) => {
+    try {
+      return realpathSync(x);
+    } catch {
+      return x;
+    }
+  };
+  return [
+    [dir, p],
+    [real(dir), real(p)],
+  ].some(([d, x]) => {
+    const rel = path.relative(d!, x!);
+    return rel !== "" && !rel.startsWith("..") && !path.isAbsolute(rel);
+  });
+}
+
+/**
+ * The install's own command: a symlink to a clone's `bin/elves.ts` — not into node_modules, that is a global package;
+ * a clone gone or moved too — or a file with COMMAND_MARK.
+ */
+function ownCommand(file: string) {
+  const st = lstat(file);
+  if (st?.isSymbolicLink()) {
+    const to = readlinkSync(file);
+    return /(?:^|\/)bin\/elves\.ts$/.test(to) && !to.split("/").includes("node_modules");
+  }
+  if (!st?.isFile() || st.size > 4096) return false;
+  try {
+    return readFileSync(file, "utf8").includes(COMMAND_MARK);
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * The command's directory: where PATH already has ours; otherwise `~/.local/bin` — if PATH has it (missing — the
+ * install creates it); otherwise the first directory of PATH inside the home directory that can be written — not
+ * outside it: system directories need root, and the install doesn't ask for it. null — no such directory on PATH.
+ */
+function commandDir(home: string): string | null {
+  const dirs = pathDirs();
+  const own = dirs.find((d) => ownCommand(path.join(d, COMMAND)));
+  if (own) return own;
+  const mine = dirs.filter((d) => inside(home, d));
+  const local = path.join(home, ".local/bin");
+  if (mine.includes(local) && (!lstat(local) || writableDir(local))) return local;
+  return mine.find(writableDir) ?? null;
+}
+
+/**
+ * The shim of a machine with a copy: the release it was installed from by its npm package — the bunx package of the
+ * same version as the canon; a release unknown — by the SHA (a clone without `--link`, a package pinned by SHA),
+ * without it — the latest release.
+ */
+function commandShim(src: string) {
+  const version = release ? npmVersion(release) : null;
+  const sha = version ? null : sourceSha(src);
+  const spec = version ? `${PACKAGE}@${version}` : sha ? `github:${SOURCE}#${sha}` : PACKAGE;
+  const what = version ? `release ${release}` : sha ? `Elves ${short(sha)}` : "the latest release";
+  return ["#!/bin/sh", `${COMMAND_MARK} — ${what}; set by \`${RUN} install -g\`, update -g rewrites it`, `exec bunx --silent ${spec} "$@"`, ""].join("\n");
+}
+
+/**
+ * No directory for the command: what the owner runs — `~/.local/bin` into PATH in the shell's profile and the same
+ * install with it on PATH.
+ */
+function pathCommand(src: string, linkMode: boolean) {
+  const shell = path.basename(process.env.SHELL ?? "");
+  const profile = shell === "zsh" ? "~/.zshrc" : shell === "bash" ? "~/.bashrc" : "~/.profile";
+  const again = linkMode ? `bun --no-env-file ${shWord(path.join(src, "bin/elves.ts"))} install -g --link` : `${RUN} update -g`;
+  return `mkdir -p ~/.local/bin && echo 'export PATH="$HOME/.local/bin:$PATH"' >> ${profile} && PATH="$HOME/.local/bin:$PATH" ${again}`;
+}
+
+/** The `elves` command (see COMMAND): a dry run names what it would change and the `!` lines. */
+function installCommand(src: string, home: string, linkMode: boolean) {
+  if (remote()) return;
+  const shown = (p: string) => (inside(home, p) ? `~/${path.relative(home, p)}` : p);
+  const say = (file: string, text: string) => (dry ? void change("!", file, { note: text }) : warn(`${shown(file)} — ${text}`));
+  const dir = commandDir(home);
+  if (!dir) {
+    const text = `${COMMAND_NOTE} isn't installed: PATH has no directory inside the home directory that can be written — add ~/.local/bin: ${pathCommand(src, linkMode)}`;
+    return dry ? void change("!", path.join(home, ".local/bin", COMMAND), { note: text }) : void note(text);
+  }
+  const dst = path.join(dir, COMMAND);
+  const st = lstat(dst);
+  if (st && !ownCommand(dst)) return say(dst, `someone else's elves (a script of the user's, a global package) — left as is; the machine's command goes here once it's removed: ${RUN} update -g`);
+  const target = path.join(src, "bin/elves.ts");
+  const text = linkMode ? linkText(target, dst, home) : commandShim(src);
+  const same = linkMode ? Boolean(st?.isSymbolicLink()) && readlinkSync(dst) === text : Boolean(st?.isFile()) && runnable(dst) && readFileSync(dst, "utf8") === text;
+  if (!same && dry) change(st ? "~" : "+", dst, { note: COMMAND_NOTE });
+  else if (!same) {
+    if (st) rmSync(dst);
+    mkdirSync(dir, { recursive: true });
+    if (linkMode) symlinkSync(text, dst);
+    else writeFileSync(dst, text, { mode: 0o755 });
+    note(`${shown(dst)} — ${COMMAND_NOTE}: ${linkMode ? `→ ${target}` : (/^exec (.*) "\$@"$/m.exec(text)?.[1] ?? "")}`);
+  }
+  const dirs = pathDirs();
+  const first = dirs.slice(0, dirs.indexOf(dir)).map((d) => path.join(d, COMMAND)).find(runnable);
+  if (first) say(first, `comes first on PATH: elves runs it, not ${shown(dst)} — remove it or put ${shown(dir)} before ${shown(path.dirname(first))} in PATH`);
+}
+
 /**
  * The URL of a GitHub origin on the repository's name before the rename (LEGACY_SOURCE, the name is case-insensitive) —
  * the same URL on SOURCE: the form, the credentials, the port and `.git` stay; another repository or host — null.
@@ -1835,8 +1985,8 @@ const remote = () => process.env.CLAUDE_CODE_REMOTE === "true";
 /**
  * The machine (#557): the canon `~/.agents/elves/` — a copy or, with `--link`, a symlink to the clone — with Claude
  * Code's rules `~/.claude/rules/elves*.md` (the same `installRules` and `claudeRules` as in a project: what a previous
- * install left under the flow's former name moves), the other agents' rule files (`agentRules`), skills and the hook.
- * Claude Code is on the machine — `~/.claude`, `claude` on PATH or a cloud session: its project hook (`cloudHook`) or
+ * install left under the flow's former name moves), the other agents' rule files (`agentRules`), skills, the `elves`
+ * command in the terminal (`installCommand`) and the hook. Claude Code is on the machine — `~/.claude`, `claude` on PATH or a cloud session: its project hook (`cloudHook`) or
  * its environment's setup script runs in a fresh home. The cloud doesn't read `~/.claude/settings.json` — no hook there.
  */
 function installGlobal(src: string, linkMode: boolean) {
@@ -1879,6 +2029,8 @@ function installGlobal(src: string, linkMode: boolean) {
       note(`${CONFIG} → ${priv}`);
     }
   }
+  // the last step: an agent's sandbox may refuse a directory of PATH — the canon, the skills and the hook are in place
+  installCommand(src, home, linkMode);
 }
 
 /**

package/dist/github/scripts/github.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 import {
   locale_default
-} from "../../spec/scripts/harness-wqrt5gpa.js";
+} from "../../spec/scripts/harness-tdg4dnq3.js";
 
 // skills/github/scripts/github.ts
 import { spawnSync } from "node:child_process";
@@ -11,12 +11,14 @@ import path from "node:path";
 import { parseArgs } from "node:util";
 var N = locale_default.names(locale_default.projectLanguage());
 var canonViews = () => [
-  { name: N.views.board, layout: "BOARD_LAYOUT" },
-  { name: N.views.table, layout: "TABLE_LAYOUT" },
+  { name: N.views.board, layout: "BOARD_LAYOUT", columns: ["TITLE", STATUS, "LABELS", "SUB_ISSUES_PROGRESS"] },
+  { name: N.views.table, layout: "TABLE_LAYOUT", columns: ["TITLE", STATUS, "LABELS", "ASSIGNEES", "SUB_ISSUES_PROGRESS", N.fields.estimate], groupBy: STATUS },
   { name: N.views.roadmap, layout: "ROADMAP_LAYOUT" }
 ];
+var BUILTIN_COLUMNS = { TITLE: "Title", ASSIGNEES: "Assignees", LABELS: "Labels", SUB_ISSUES_PROGRESS: "Sub-issues progress" };
 var STATUS = "Status";
 var statusOptions = () => [N.status.backlog, N.status.inProgress, N.status.done];
+var STATUS_COLORS = ["GREEN", "YELLOW", "PURPLE"];
 var numberFields = () => [N.fields.estimate, N.fields.actual, N.fields.tokens, N.fields.cost];
 var issueTypes = () => [N.issueTypes.task, N.issueTypes.bug, N.issueTypes.epic];
 var PRIORITY = "Priority";
@@ -36,6 +38,12 @@ var ISSUE_LABEL_LIMIT = 100;
 var WORKFLOW_ADDED = "Item added to project";
 var WORKFLOW_CLOSED = "Item closed";
 var WORKFLOW_AUTO_ADD = "Auto-add to project";
+var WORKFLOW_MERGED = "Pull request merged";
+var WORKFLOW_AUTO_CLOSE = "Auto-close issue";
+var WORKFLOW_SUB_ISSUES = "Auto-add sub-issues to project";
+var WORKFLOW_ARCHIVE = "Auto-archive items";
+var WORKFLOWS = [WORKFLOW_ADDED, WORKFLOW_CLOSED, WORKFLOW_MERGED, WORKFLOW_AUTO_CLOSE, WORKFLOW_AUTO_ADD, WORKFLOW_SUB_ISSUES, WORKFLOW_ARCHIVE];
+var ARCHIVE_FILTER = "is:issue is:closed updated:<@today-2w";
 var DEFAULT_TEMPLATE = "miroshnik/6";
 var RULESET = "elves";
 var FORMER_RULESET = "ai-dev";
@@ -122,6 +130,8 @@ var Q = {
           id number name layout filter
           sortByFields(first: 5) { nodes { direction field { ... on ProjectV2FieldCommon { name } } } }
           verticalGroupByFields(first: 5) { nodes { ... on ProjectV2FieldCommon { name } } }
+          groupByFields(first: 5) { nodes { ... on ProjectV2FieldCommon { name } } }
+          fields(first: 50) { nodes { ... on ProjectV2FieldCommon { id name dataType } } }
         }
       }
       fields(first: 100) {
@@ -650,7 +660,9 @@ function loadProject(io, id, withItems = true) {
       layout: v.layout,
       filter: v.filter ?? null,
       sortBy: (v.sortByFields?.nodes ?? []).map((s) => s.field?.name).filter(Boolean),
-      columnsBy: (v.verticalGroupByFields?.nodes ?? []).map((f) => f?.name).filter(Boolean)
+      columnsBy: (v.verticalGroupByFields?.nodes ?? []).map((f) => f?.name).filter(Boolean),
+      groupBy: (v.groupByFields?.nodes ?? []).map((f) => f?.name).filter(Boolean),
+      columns: (v.fields?.nodes ?? []).filter((f) => f?.id).map((f) => ({ id: f.id, name: f.name, dataType: f.dataType }))
     })),
     fields: p.fields.nodes.filter((f) => f && f.id).map((f) => ({ id: f.id, name: f.name, dataType: f.dataType, isIssueField: !!f.isIssueField, options: f.options ?? null })),
     workflows: p.workflows.nodes.filter(Boolean),
@@ -692,7 +704,12 @@ function analyze(s) {
   for (const other of s.repo.linked.filter((x) => x.id !== p.id)) {
     link(`another project is linked: ${q(other.title)} (${other.url})`, { kind: "confirm", text: `unlink project ${q(other.title)} from the repository`, mutations: [{ op: "UnlinkProject", input: { projectId: other.id, repositoryId: s.repo.id } }] });
   }
-  const views = add("views", `Views ${canonViews().map((v) => q(v.name)).join(", ")} — the right layout, no filter, no others`);
+  const fieldAlias = fieldAliases();
+  const columnKey = (f) => BUILTIN_FIELDS.has(f.dataType) ? f.dataType : fieldAlias[f.name] ?? f.name;
+  const columnName = (key) => p.fields.find((f) => columnKey(f) === key)?.name ?? BUILTIN_COLUMNS[key] ?? key;
+  const columnFields = (keys) => keys.map((k) => p.fields.find((f) => columnKey(f) === k)).filter((f) => !!f);
+  const configuration = (keys) => ({ visibleFieldIds: columnFields(keys).map((f) => f.id) });
+  const views = add("views", `Views ${canonViews().map((v) => q(v.name)).join(", ")} — the right layout, columns and grouping, no filter, no others`);
   const canonNames = new Set(canonViews().map((v) => v.name));
   const spare = p.views.filter((v) => !canonNames.has(v.name));
   for (const c of canonViews()) {
@@ -703,7 +720,8 @@ function analyze(s) {
         spare.splice(spare.indexOf(cand), 1);
         views(`missing ${q(c.name)}`, guarded(`rename view ${q(cand.name)} → ${q(c.name)}`, { op: "UpdateView", input: { viewId: cand.id, name: c.name } }));
       } else {
-        views(`missing ${q(c.name)}`, api(`create view ${q(c.name)} (${c.layout})`, { op: "CreateView", input: { projectId: p.id, name: c.name, layout: c.layout } }));
+        const input = { projectId: p.id, name: c.name, layout: c.layout, ...c.columns ? { configuration: configuration(c.columns) } : {} };
+        views(`missing ${q(c.name)}`, api(`create view ${q(c.name)} (${c.layout})`, { op: "CreateView", input }));
       }
       continue;
     }
@@ -714,13 +732,26 @@ function analyze(s) {
     if (c.layout === "BOARD_LAYOUT" && v.layout === c.layout && v.columnsBy[0] !== STATUS) {
       views(`${q(c.name)} columns not by Status`, ui(`${q(c.name)}: View options → Column by → Status → Save`, `${p.url}/views/${v.number}`));
     }
+    if (c.columns) {
+      const have = v.columns.map(columnKey);
+      const missing = c.columns.filter((k) => !have.includes(k)).map((k) => q(columnName(k)));
+      const extra = v.columns.filter((f) => !c.columns.includes(columnKey(f))).map((f) => q(f.name));
+      if (missing.length || extra.length) {
+        const why = [missing.length ? `missing ${missing.join(", ")}` : "", extra.length ? `extra ${extra.join(", ")}` : ""].filter(Boolean).join("; ");
+        const set = columnFields(c.columns).map((f) => f.name).join(", ");
+        views(`${q(c.name)} columns: ${why}`, api(`${q(c.name)}: columns ${set}`, { op: "UpdateView", input: { viewId: v.id, configuration: configuration(c.columns) } }));
+      }
+    }
+    if (c.groupBy && v.layout === c.layout && v.groupBy[0] !== c.groupBy) {
+      views(`${q(c.name)} not grouped by ${c.groupBy}`, ui(`${q(c.name)}: View options → Group by → ${c.groupBy} → Save`, `${p.url}/views/${v.number}`));
+    }
   }
   for (const v of spare)
     views(`extra ${q(v.name)}`, guarded(`delete view ${q(v.name)}`, { op: "DeleteView", input: { viewId: v.id } }));
-  const status = add("status", `${STATUS}: ${statusOptions().join(" → ")}`);
+  const status = add("status", `${STATUS}: ${statusOptions().join(" → ")} (${STATUS_COLORS.join(", ")})`);
   const sf = p.fields.find((f) => f.name === STATUS && f.options);
   if (!sf) {
-    status(`no ${STATUS} field`, api(`create field ${STATUS}`, { op: "CreateField", input: { projectId: p.id, dataType: "SINGLE_SELECT", name: STATUS, singleSelectOptions: statusOptions().map((name) => ({ name, color: "GRAY", description: "" })) } }));
+    status(`no ${STATUS} field`, api(`create field ${STATUS}`, { op: "CreateField", input: { projectId: p.id, dataType: "SINGLE_SELECT", name: STATUS, singleSelectOptions: statusOptions().map((name, i) => ({ name, color: STATUS_COLORS[i], description: "" })) } }));
   } else if (sf.options.map((o) => o.name).join(`
 `) !== statusOptions().join(`
 `)) {
@@ -730,15 +761,17 @@ function analyze(s) {
       return i < 0 ? null : left.splice(i, 1)[0];
     };
     const aliases = statusAliases();
-    const next = statusOptions().map((name) => {
+    const next = statusOptions().map((name, i) => {
       const o = take((x) => x.name === name) ?? take((x) => aliases[x.name.toLowerCase()] === name);
-      return o ? { id: o.id, name, color: o.color, description: o.description ?? "" } : { name, color: "GRAY", description: "" };
+      return o ? { id: o.id, name, color: STATUS_COLORS[i], description: o.description ?? "" } : { name, color: STATUS_COLORS[i], description: "" };
     });
     const drop = left.length ? `; delete ${left.map((o) => q(o.name)).join(", ")}` : "";
     status(`options: ${sf.options.map((o) => o.name).join(", ") || "none"}`, guarded(`${STATUS}: ${statusOptions().join(", ")} (rename the existing ones keeping the id${drop})`, { op: "UpdateField", input: { fieldId: sf.id, singleSelectOptions: next } }));
+  } else if (sf.options.some((o, i) => o.color !== STATUS_COLORS[i])) {
+    const next = sf.options.map((o, i) => ({ id: o.id, name: o.name, color: STATUS_COLORS[i], description: o.description ?? "" }));
+    status(`colors: ${sf.options.map((o) => `${o.name} ${o.color}`).join(", ")}`, api(`${STATUS}: colors ${STATUS_COLORS.join(", ")} (keeping the id)`, { op: "UpdateField", input: { fieldId: sf.id, singleSelectOptions: next } }));
   }
   const fields = add("fields", `Fields ${numberFields().map(q).join(", ")} (Number), no other custom ones`);
-  const fieldAlias = fieldAliases();
   const renamed = new Set;
   for (const name of numberFields()) {
     const f = p.fields.find((x) => x.name === name);
@@ -804,13 +837,17 @@ function analyze(s) {
       types(`extra ${q(x.name)}`, { kind: "confirm", text: `disable type ${q(x.name)}`, url, mutations: [{ op: "UpdateIssueType", input: { issueTypeId: x.id, isEnabled: false } }] });
     }
   }
-  const wf = add("workflows", `Workflows ${[WORKFLOW_ADDED, WORKFLOW_CLOSED, WORKFLOW_AUTO_ADD].map(q).join(", ")} are on`);
+  const wf = add("workflows", `Workflows ${WORKFLOWS.map(q).join(", ")} are on`);
   const how = {
     [WORKFLOW_ADDED]: `Edit → Set value → ${STATUS}: ${N.status.backlog}`,
     [WORKFLOW_CLOSED]: `Edit → Set value → ${STATUS}: ${N.status.done}`,
-    [WORKFLOW_AUTO_ADD]: `Edit → repository ${s.repo.name}, filter is:issue is:open (Enter)`
+    [WORKFLOW_MERGED]: `Edit → Set value → ${STATUS}: ${N.status.done}`,
+    [WORKFLOW_AUTO_CLOSE]: `Edit → ${STATUS}: ${N.status.done}`,
+    [WORKFLOW_AUTO_ADD]: `Edit → repository ${s.repo.name}, filter is:issue is:open (Enter)`,
+    [WORKFLOW_SUB_ISSUES]: "Edit",
+    [WORKFLOW_ARCHIVE]: `Edit → filter ${ARCHIVE_FILTER} (Enter)`
   };
-  for (const name of [WORKFLOW_ADDED, WORKFLOW_CLOSED, WORKFLOW_AUTO_ADD]) {
+  for (const name of WORKFLOWS) {
     const w = p.workflows.find((x) => x.name === name);
     if (w?.enabled)
       continue;
@@ -1750,11 +1787,16 @@ function cloudBrief(io, slug, issue) {
     state: N.comments.state,
     questions: N.sections.questions
   };
-  for (const line of [N.queue.cloud, N.queue.cloudDoc, N.queue.cloudClose, N.queue.cloudDispatcher, N.queue.cloudQuestion])
+  for (const line of [N.queue.cloud, N.queue.cloudDoc, N.queue.repeats, N.queue.cloudClose, N.queue.cloudDispatcher, N.queue.cloudQuestion])
     io.out(locale_default.fill(line, vars));
   io.out(`Next: the lines above — the cloud session's first prompt as is, the session started from the project folder (the cloud starts from main); ` + `then as a background command: bash ${waitCi()} issue ${number} — a cloud session can't message a local one (docs/cloud-sessions.md), the task's closing is the signal: ` + `PASS — bun --no-env-file ${import.meta.path} task close ${number} (the actual with --write, ${STATUS}, the merged branch), then archive the executor's session in an auto project where the agent has the tool; ` + `TIMEOUT — the task's ${q(N.sections.questions)} and its ${q(N.comments.state)} comment, the executor's session, then the same wait again`);
 }
 var SESSION_ARCHIVE = "an executor session whose task closed — the dispatcher archives it in an auto project where the agent has the tool, " + "not one still working in the background or awaiting the owner's answer; outside auto the owner closes it";
+function openPrOf(io, slug) {
+  const [owner, name] = slug.split("/");
+  const recent = (graphql(io, Q.RecentPrs, { owner, name })?.repository?.pullRequests?.nodes ?? []).filter((p) => p.state === "OPEN");
+  return (i) => i.prs.find((p) => p.state === "OPEN")?.number ?? recent.find((p) => isTaskBranch(p.headRefName ?? "", i.number) || closingInBody(p.body ?? "").includes(i.number))?.number;
+}
 function cmdTaskQueue(io, slug, o) {
   const want = o.type === undefined ? undefined : typeAliases()[o.type.toLowerCase()];
   if (o.type !== undefined && (!want || want === N.issueTypes.epic))
@@ -1780,9 +1822,7 @@ function cmdTaskQueue(io, slug, o) {
       io.out("○ the search gave 100 open tasks — the queue sees only them: narrow it with --epic");
     numbers = found.filter((x) => x?.state === "OPEN").map((x) => x.number);
   }
-  const [owner, name] = slug.split("/");
-  const recent = (graphql(io, Q.RecentPrs, { owner, name })?.repository?.pullRequests?.nodes ?? []).filter((p) => p.state === "OPEN");
-  const openPr = (i) => i.prs.find((p) => p.state === "OPEN")?.number ?? recent.find((p) => isTaskBranch(p.headRefName ?? "", i.number) || closingInBody(p.body ?? "").includes(i.number))?.number;
+  const openPr = openPrOf(io, slug);
   const handed = handedOut(io, slug);
   const states = new Map;
   const isOpen = (n) => {
@@ -2123,7 +2163,7 @@ function cmdTaskAssignment(io, slug, number, o = {}) {
     remaining: N.lastLine.remaining
   };
   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];
+  const lines = o.session ? [N.queue.sessionLead, ...resume, N.queue.sessionIs, N.queue.sessionName, N.queue.sessionWait, N.queue.repeats, 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.repeats, N.queue.found, N.queue.question, N.queue.answer];
   for (const line of lines)
     io.out(locale_default.fill(line, vars));
   if (o.session) {
@@ -2270,6 +2310,7 @@ function cmdTaskActualize(io, slug, number, o = { assignment: false }) {
     refreshMechanics(io, slug, { number, merged: prs.length > 0, epic, open });
   if (!open.length)
     return io.out(`○ refresh not needed: epic #${epic.number} has no open tasks besides #${number}. ${later}`), 0;
+  const ctx = o.assignment ? taskContext(io, slug) : null;
   const vars = { task: N.subagentPrompt.task, epicWord: N.subagentPrompt.epic, number, epic: epic.number, repo: slug };
   const lead = locale_default.fill(N.actualize.lead, vars);
   if (!o.assignment) {
@@ -2287,8 +2328,18 @@ function cmdTaskActualize(io, slug, number, o = { assignment: false }) {
       lines.push(locale_default.fill(N.actualize.files, { pr: p.number }), ...files.map(fileLine));
   }
   lines.push("", locale_default.fill(N.actualize.epic, { ...vars, title: epic.title }), textBlock(epic.body), "", N.actualize.openTasks);
+  const openPr = openPrOf(io, slug);
+  const target = (n) => {
+    const i = loadIssue(io, slug, n);
+    const status = itemIn(ctx, i)?.status ?? null;
+    const pr = openPr(i);
+    const work = [status === N.status.inProgress ? locale_default.fill(N.actualize.taskStatus, { status }) : "", pr === undefined ? "" : locale_default.fill(N.actualize.taskPr, { pr })].filter(Boolean);
+    if (work.length)
+      return [locale_default.fill(N.actualize.inWork, { work: work.join(", ") })];
+    return status === N.status.backlog ? [locale_default.fill(N.actualize.backlog, { status: locale_default.fill(N.actualize.taskStatus, { status }) })] : [];
+  };
   for (const t of open)
-    lines.push("", locale_default.fill(N.actualize.openTask, { number: t.number, title: t.title }), textBlock(t.body));
+    lines.push("", locale_default.fill(N.actualize.openTask, { number: t.number, title: t.title }), ...target(t.number), textBlock(t.body));
   const copies = linkCopies(epic, open);
   if (copies.length)
     lines.push("", N.actualize.copies, ...copies.map((c) => locale_default.fill(N.actualize.copy, c)));

package/dist/spec/scripts/architecture.js

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

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

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

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

@@ -64,6 +64,10 @@ var en_default = {
     epic: "## Epic #{epic} «{title}»",
     openTasks: "## The epic's open tasks — its sub-issues, not a list in the epic's description",
     openTask: "### #{number} «{title}»",
+    backlog: "{status} — a repeat finding of the same kind (the same helper, module or standard) goes here as an item in «What to do» (and a scenario, if needed), not into a new task.",
+    inWork: "{work} — the task is already going: a repeat finding of the same kind isn't appended here but filed as a new task.",
+    taskStatus: "Status «{status}»",
+    taskPr: "PR #{pr} is open",
     noBody: "(no description)",
     copies: "## Copies of links in text — remove them: GitHub keeps the links (sub-issue, blocked by)",
     copy: "- #{number}: «{line}»",
@@ -71,8 +75,8 @@ var en_default = {
     commentAnswer: "- #{number}, question {k}: «{text}» — {url}",
     checks: "## Checks by meaning — yours (canon — reference.md of the github skill, «Epic refresh on task close»); the mechanics — blocked by on done tasks, the questions label without open questions, milestones without open tasks — the script did",
     scope: "You change only GitHub tasks — description, «{questions}», links, status; the github skill script — `{script}`: not done — `task drop <N>`, a new one — `task new … --branch-type <type> --epic {epic}` (it sets the estimate itself); an answer at a question — `task answer <N> <k> \"<answer>\"`. Don't touch code, branches or git; don't close #{number}, epic #{epic} or their milestones — task close does that after you.",
-    comment: "The result — always, as the last step: a comment on epic #{epic} (`gh issue comment {epic} --repo {repo}`), one line «{report}» — after the colon what you fixed, nothing to fix — «the block is current». By it `task close {number}` sees the refresh is over: without it the close refuses.",
-    answer: "Answer — fixes one per line with task numbers and questions to the owner, if any; otherwise «The block is current».",
+    comment: "The result — always, as the last step: a comment on epic #{epic} (`gh issue comment {epic} --repo {repo}`), one line «{report}» — after the colon what you fixed, a repeat finding — with where it went: «appended to #N» or «filed #M»; nothing to fix — «the block is current». By it `task close {number}` sees the refresh is over: without it the close refuses.",
+    answer: "Answer — fixes one per line with task numbers (a repeat finding — «appended to #N» or «filed #M») and questions to the owner, if any; otherwise «The block is current».",
     linkWords: "blocked by|blocks|after|depends on|waits for",
     report: "Refresh after #{number}, result: {text}",
     mechanics: "Refresh after #{number}, script: {fixes}.",
@@ -92,6 +96,7 @@ var en_default = {
     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>"`;',
+    repeats: "- before the PR — repeats in the files the task changes anyway: fix them in the same PR, don't file a task for them; a repeat outside the task's files is the epic refresh's;",
     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>`.",
@@ -522,6 +527,10 @@ var ru_default = {
     epic: "## Эпик #{epic} «{title}»",
     openTasks: "## Открытые задачи эпика — его подзадачи (sub-issues), а не список в описании эпика",
     openTask: "### #{number} «{title}»",
+    backlog: "{status} — находку-повтор того же рода (тот же помощник, модуль или стандарт) дописать сюда пунктом в «Что сделать» (и сценарий, если нужен), новую задачу не заводить.",
+    inWork: "{work} — задача уже идёт: находку-повтор того же рода сюда не дописывать, а завести новой задачей.",
+    taskStatus: "Статус «{status}»",
+    taskPr: "PR #{pr} открыт",
     noBody: "(описания нет)",
     copies: "## Копии связей в тексте — убрать: связи держит GitHub (sub-issue, blocked by)",
     copy: "- #{number}: «{line}»",
@@ -529,8 +538,8 @@ var ru_default = {
     commentAnswer: "- #{number}, вопрос {k}: «{text}» — {url}",
     checks: "## Проверки по смыслу — твои (канон — reference.md скилла github, «Epic refresh on task close»); механику — blocked by на выполненных задачах, метку вопросов без открытых вопросов, milestone без открытых задач — сделал скрипт",
     scope: 'Меняешь только задачи GitHub — описание, «{questions}», связи, статус; скрипт скилла github — `{script}`: без выполнения — `task drop <N>`, новая — `task new … --branch-type <тип> --epic {epic}` (оценку ставит сама); ответ у вопроса — `task answer <N> <k> "<ответ>"`. Код, ветки и git не трогать; #{number}, эпик #{epic} и их milestone не закрывать — это сделает task close после тебя.',
-    comment: "Итог — всегда, последним шагом: комментарий к эпику #{epic} (`gh issue comment {epic} --repo {repo}`) одной строкой «{report}» — после двоеточия что поправил, а править нечего — «блок актуален». По нему `task close {number}` видит, что актуализация закончена: без него закрытие откажет.",
-    answer: "Ответ — правки по строке с номерами задач и вопросы владельцу, если есть; иначе «Блок актуален».",
+    comment: "Итог — всегда, последним шагом: комментарий к эпику #{epic} (`gh issue comment {epic} --repo {repo}`) одной строкой «{report}» — после двоеточия что поправил, находку-повтор — с тем, куда она ушла: «дописано в #N» или «заведена #M»; править нечего — «блок актуален». По нему `task close {number}` видит, что актуализация закончена: без него закрытие откажет.",
+    answer: "Ответ — правки по строке с номерами задач (находка-повтор — «дописано в #N» или «заведена #M») и вопросы владельцу, если есть; иначе «Блок актуален».",
     linkWords: "после|зависит от|заблокирована|заблокирован|заблокировано|блокирует|ждёт|ждет",
     report: "Актуализация после #{number}, итог: {text}",
     mechanics: "Актуализация после #{number}, скрипт: {fixes}.",
@@ -550,6 +559,7 @@ var ru_default = {
     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 "<итог>"`;',
+    repeats: "- перед PR — повторы в файлах, которые задача и так правит: исправь в том же PR, новую задачу на них не заводи; повтор вне файлов задачи — дело актуализации эпика;",
     found: "- найденная работа вне задачи — `{script} task new …` (работа эпика задачи — с `--epic`: диспетчер её подхватит) — назови её в ответе: ставить ли её в очередь, решает владелец;",
     question: "- вопрос без ясной рекомендации — в «{questions}» задачи; код, который от него зависит, не начинай и ответь диспетчеру: ответ владельца придёт сюда же.",
     answer: "Ответ диспетчеру — одной строкой: `влито #<PR>` · `вопрос: <вопрос, варианты, рекомендация>` · `ждёт субагентов: <какие и что делают>` · `сломалось: <что и где остановилось>`.",

package/dist/spec/scripts/harness.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miroshnik/elves",
-  "version": "2026.1019.0",
+  "version": "2026.1019.2",
   "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": {
@@ -71,5 +71,5 @@
     "eslint-plugin-boundaries": "^7.2.0",
     "knip": "^6.41.0"
   },
-  "gitHead": "42576112e74dfdc383f64b0edb5e08a24ff4afa2"
+  "gitHead": "006208c32b61d184886a5b77dbdffa39bba751f2"
 }

package/skills/github/locales/en.json

@@ -60,6 +60,10 @@
     "epic": "## Epic #{epic} «{title}»",
     "openTasks": "## The epic's open tasks — its sub-issues, not a list in the epic's description",
     "openTask": "### #{number} «{title}»",
+    "backlog": "{status} — a repeat finding of the same kind (the same helper, module or standard) goes here as an item in «What to do» (and a scenario, if needed), not into a new task.",
+    "inWork": "{work} — the task is already going: a repeat finding of the same kind isn't appended here but filed as a new task.",
+    "taskStatus": "Status «{status}»",
+    "taskPr": "PR #{pr} is open",
     "noBody": "(no description)",
     "copies": "## Copies of links in text — remove them: GitHub keeps the links (sub-issue, blocked by)",
     "copy": "- #{number}: «{line}»",
@@ -67,8 +71,8 @@
     "commentAnswer": "- #{number}, question {k}: «{text}» — {url}",
     "checks": "## Checks by meaning — yours (canon — reference.md of the github skill, «Epic refresh on task close»); the mechanics — blocked by on done tasks, the questions label without open questions, milestones without open tasks — the script did",
     "scope": "You change only GitHub tasks — description, «{questions}», links, status; the github skill script — `{script}`: not done — `task drop <N>`, a new one — `task new … --branch-type <type> --epic {epic}` (it sets the estimate itself); an answer at a question — `task answer <N> <k> \"<answer>\"`. Don't touch code, branches or git; don't close #{number}, epic #{epic} or their milestones — task close does that after you.",
-    "comment": "The result — always, as the last step: a comment on epic #{epic} (`gh issue comment {epic} --repo {repo}`), one line «{report}» — after the colon what you fixed, nothing to fix — «the block is current». By it `task close {number}` sees the refresh is over: without it the close refuses.",
-    "answer": "Answer — fixes one per line with task numbers and questions to the owner, if any; otherwise «The block is current».",
+    "comment": "The result — always, as the last step: a comment on epic #{epic} (`gh issue comment {epic} --repo {repo}`), one line «{report}» — after the colon what you fixed, a repeat finding — with where it went: «appended to #N» or «filed #M»; nothing to fix — «the block is current». By it `task close {number}` sees the refresh is over: without it the close refuses.",
+    "answer": "Answer — fixes one per line with task numbers (a repeat finding — «appended to #N» or «filed #M») and questions to the owner, if any; otherwise «The block is current».",
     "linkWords": "blocked by|blocks|after|depends on|waits for",
     "report": "Refresh after #{number}, result: {text}",
     "mechanics": "Refresh after #{number}, script: {fixes}.",
@@ -88,6 +92,7 @@
     "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>\"`;",
+    "repeats": "- before the PR — repeats in the files the task changes anyway: fix them in the same PR, don't file a task for them; a repeat outside the task's files is the epic refresh's;",
     "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>`.",

package/skills/github/locales/ru.json

@@ -60,6 +60,10 @@
     "epic": "## Эпик #{epic} «{title}»",
     "openTasks": "## Открытые задачи эпика — его подзадачи (sub-issues), а не список в описании эпика",
     "openTask": "### #{number} «{title}»",
+    "backlog": "{status} — находку-повтор того же рода (тот же помощник, модуль или стандарт) дописать сюда пунктом в «Что сделать» (и сценарий, если нужен), новую задачу не заводить.",
+    "inWork": "{work} — задача уже идёт: находку-повтор того же рода сюда не дописывать, а завести новой задачей.",
+    "taskStatus": "Статус «{status}»",
+    "taskPr": "PR #{pr} открыт",
     "noBody": "(описания нет)",
     "copies": "## Копии связей в тексте — убрать: связи держит GitHub (sub-issue, blocked by)",
     "copy": "- #{number}: «{line}»",
@@ -67,8 +71,8 @@
     "commentAnswer": "- #{number}, вопрос {k}: «{text}» — {url}",
     "checks": "## Проверки по смыслу — твои (канон — reference.md скилла github, «Epic refresh on task close»); механику — blocked by на выполненных задачах, метку вопросов без открытых вопросов, milestone без открытых задач — сделал скрипт",
     "scope": "Меняешь только задачи GitHub — описание, «{questions}», связи, статус; скрипт скилла github — `{script}`: без выполнения — `task drop <N>`, новая — `task new … --branch-type <тип> --epic {epic}` (оценку ставит сама); ответ у вопроса — `task answer <N> <k> \"<ответ>\"`. Код, ветки и git не трогать; #{number}, эпик #{epic} и их milestone не закрывать — это сделает task close после тебя.",
-    "comment": "Итог — всегда, последним шагом: комментарий к эпику #{epic} (`gh issue comment {epic} --repo {repo}`) одной строкой «{report}» — после двоеточия что поправил, а править нечего — «блок актуален». По нему `task close {number}` видит, что актуализация закончена: без него закрытие откажет.",
-    "answer": "Ответ — правки по строке с номерами задач и вопросы владельцу, если есть; иначе «Блок актуален».",
+    "comment": "Итог — всегда, последним шагом: комментарий к эпику #{epic} (`gh issue comment {epic} --repo {repo}`) одной строкой «{report}» — после двоеточия что поправил, находку-повтор — с тем, куда она ушла: «дописано в #N» или «заведена #M»; править нечего — «блок актуален». По нему `task close {number}` видит, что актуализация закончена: без него закрытие откажет.",
+    "answer": "Ответ — правки по строке с номерами задач (находка-повтор — «дописано в #N» или «заведена #M») и вопросы владельцу, если есть; иначе «Блок актуален».",
     "linkWords": "после|зависит от|заблокирована|заблокирован|заблокировано|блокирует|ждёт|ждет",
     "report": "Актуализация после #{number}, итог: {text}",
     "mechanics": "Актуализация после #{number}, скрипт: {fixes}.",
@@ -88,6 +92,7 @@
     "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 \"<итог>\"`;",
+    "repeats": "- перед PR — повторы в файлах, которые задача и так правит: исправь в том же PR, новую задачу на них не заводи; повтор вне файлов задачи — дело актуализации эпика;",
     "found": "- найденная работа вне задачи — `{script} task new …` (работа эпика задачи — с `--epic`: диспетчер её подхватит) — назови её в ответе: ставить ли её в очередь, решает владелец;",
     "question": "- вопрос без ясной рекомендации — в «{questions}» задачи; код, который от него зависит, не начинай и ответь диспетчеру: ответ владельца придёт сюда же.",
     "answer": "Ответ диспетчеру — одной строкой: `влито #<PR>` · `вопрос: <вопрос, варианты, рекомендация>` · `ждёт субагентов: <какие и что делают>` · `сломалось: <что и где остановилось>`.",

package/skills/github/reference.md

@@ -97,9 +97,15 @@ Every repository has **exactly one** GitHub Project linked to the repo
 per epic/area (an area = an epic inside the shared project). All tasks are
 added to the project right on creation (`github task new`). Required:
 
-- **Three views**, with exactly these names: `Board` (BOARD_LAYOUT, columns
-  by `Status`), `Table` (TABLE_LAYOUT), `Roadmap` (ROADMAP_LAYOUT).
-- **The `Status` field** with options `Backlog` → `In progress` → `Done`.
+- **Three views**, with exactly these names, as in the template:
+  - `Board` (BOARD_LAYOUT, columns by `Status`) — cards show Title, Status,
+    Labels, Sub-issues progress;
+  - `Table` (TABLE_LAYOUT, grouped by `Status`) — columns Title, Status,
+    Labels, Assignees, Sub-issues progress, «Estimate, h»;
+  - `Roadmap` (ROADMAP_LAYOUT).
+- **The `Status` field** with options `Backlog` → `In progress` → `Done`,
+  colored `GREEN`, `YELLOW`, `PURPLE` (a new GitHub project's colors);
+  option descriptions are the project's own.
   I change the status **myself, immediately**, without waiting to be asked
   (`github task status <N> <status>`):
   - a new task — I set Backlog on creation;
@@ -118,12 +124,15 @@ added to the project right on creation (`github task new`). Required:
   (those closed as not planned don't count — they are no longer in the
   project).
   Safety net — the project's built-in workflows "Item added to project" →
-  Backlog, "Item closed" → Done and "Auto-add to project" (new open issues of
-  the repository get into the project by themselves): the status gets set
-  even if there is no one to set it (a cloud session, another agent, closing
-  from the GitHub UI). The agent sets the status anyway; a task closed as not
-  planned it removes from the project — otherwise the workflow puts it into
-  Done.
+  Backlog, "Item closed" and "Pull request merged" → Done, "Auto-close issue"
+  (Done → the issue is closed), "Auto-add to project" (new open issues of
+  the repository get into the project by themselves) and "Auto-add sub-issues
+  to project": the status gets set even if there is no one to set it (a cloud
+  session, another agent, closing from the GitHub UI). The agent sets the
+  status anyway; a task closed as not planned it removes from the project —
+  otherwise the workflow puts it into Done. "Auto-archive items" (`is:issue
+  is:closed updated:<@today-2w`) takes a task closed and untouched for two
+  weeks off the board and the table.
 - **The `Estimate, h` field** (Number) — the agent's active hours
   (`AGENTS.md`, section "Estimate and actual — the `est` skill"). Set **only
   by `github task new`** (the `est` script inside) — from analogs with
@@ -149,8 +158,11 @@ added to the project right on creation (`github task new`). Required:
   unblocked. A personal account has no issue fields — no priority is kept.
   `github task new` sets it (`--priority`, `Medium` by default).
 
-Nothing extra: there are no other fields (Iteration, Readiness…) or views
-until they are added here. Readiness — the status and *blocked by*; stages —
+Nothing extra: there are no other fields (Iteration, Readiness…), views or
+columns until they are added here. What the public API doesn't read — the
+slice by a field, the sub-issue hierarchy, column widths, the project's
+description and README — isn't in the canon: a copy of the template carries
+it, nothing checks it. Readiness — the status and *blocked by*; stages —
 milestones (the `Milestone` field).
 
 The project — the `github` skill: `project check` once per session before
@@ -234,12 +246,20 @@ line `○ refresh not needed`, no subagent. Five checks:
    of subtasks in the epic, an order, "⛔" or "after #N" marks — is removed.
 5. **Repetition is a standard.** A decision that, in what shipped, repeats an
    existing one in two or more places — a `Standard · …` issue
-   (a rule in `tests/standards/` and a refactoring). First a search among the
-   open `Standard · …`: one exists — don't file another; an extension of a
-   neighboring one — a comment in it. A standard's priority — by the cost of
-   the mistake it prevents; standards of one area — as an epic: otherwise
-   they are born faster than they are worked off. Something deferred as "not
-   in this PR" — an issue or dropped explicitly, not forgotten.
+   (a rule in `tests/standards/` and a refactoring); a repeat in the files a
+   task changes anyway is fixed in its PR by its executor, without a task.
+   First — an open task of the epic of the same kind (the same helper, module
+   or standard) in Backlog: the finding is an item in its «What to do» (and a
+   scenario, if needed), not a new task; one In progress or with an open PR is
+   already going — a new task (the assignment names each one's status). Then
+   a search among the open `Standard · …`: one exists — don't file another; an
+   extension of a neighboring one — a comment in it. The result names where
+   the finding went: «appended to #N» or «filed #M». A standard's priority —
+   by the cost of the mistake it prevents; standards of one area — as an epic:
+   otherwise they are born faster than they are worked off (#636: seven tasks
+   in a day on one helper's copies, each refresh finding the next). Something
+   deferred as "not in this PR" — an issue or dropped explicitly, not
+   forgotten.
 
 What was fixed — one comment on the epic, the history of decisions in one
 place; it is the subagent's last step, always: nothing to fix — «the block is
@@ -313,16 +333,23 @@ description is rewritten.
 
 1. The project is linked to the repository, it is the only one, its title =
    the repository name.
-2. Views `Board` (BOARD, columns by `Status`), `Table` (TABLE), `Roadmap`
-   (ROADMAP), filters empty, no others.
-3. `Status`: `Backlog` → `In progress` → `Done`.
+2. Views `Board` (BOARD, columns by `Status`), `Table` (TABLE, grouped by
+   `Status`), `Roadmap` (ROADMAP), filters empty, no others; the columns of
+   `Board` and `Table` — the canon's set (a built-in field by its type, the
+   rest by name), `fix` sets them in the template's order. The roadmap's
+   columns aren't compared: the API gives it the default ones.
+3. `Status`: `Backlog` → `In progress` → `Done`, colors `GREEN`, `YELLOW`,
+   `PURPLE`; descriptions aren't compared.
 4. Fields «Estimate, h», «Actual, h», «Tokens, M», «Cost, $» (Number), no
    custom fields beyond the canon.
 5. Organization only: `Priority` — the organization's issue field, connected,
    `Table` and `Board` are sorted by it; issue types — exactly «Task»,
    «Bug», «Epic». A personal account has none — a `➖` line.
-6. Workflows "Item added to project" (→ Backlog), "Item closed" (→ Done),
-   "Auto-add to project" (`is:issue is:open`) are on.
+6. The template's workflows are on: "Item added to project" (→ Backlog),
+   "Item closed" and "Pull request merged" (→ Done), "Auto-close issue",
+   "Auto-add to project" (`is:issue is:open`), "Auto-add sub-issues to
+   project", "Auto-archive items" (`is:issue is:closed updated:<@today-2w`).
+   Others aren't checked.
 7. Closed tasks — in Done; those closed without being done (not planned,
    duplicate) — outside the project.
 8. The repository's open tasks — in the project, each has a `Status`.
@@ -379,7 +406,8 @@ description is rewritten.
 ### fix: who does what
 
 - **API — the script itself:** linking, a template copy or a new project,
-  missing views and fields, view layout, removing a filter, `Status` options,
+  missing views and fields, view layout and columns, removing a filter,
+  `Status` options and colors,
   the `Priority` issue field, task statuses, adding open tasks, removing tasks
   closed without being done from the project, decision labels (creation,
   color), the default-branch ruleset (creation, editing its own), merge
@@ -409,14 +437,19 @@ description is rewritten.
   deleted (options were replaced without ids): pick it again.
   - "Item added to project": trigger `issue, pull request` (default), Set
     value → `Status: Backlog`.
-  - "Item closed": Set value → `Status: Done`.
+  - "Item closed", "Pull request merged": Set value → `Status: Done`.
+  - "Auto-close issue": `Status: Done` → close the issue.
   - "Auto-add to project": the repository — this project's, filter
     `is:issue is:open`, Enter — the "See N existing items" counter should
     update. Without `is:open` an updated closed task (a not planned one too)
     comes back into the project. Auto-add doesn't add already existing tasks —
     `fix` adds them.
-- **Sorting by Priority, board columns:** the view → the `View` button on the
-  right → `Sort by: Priority` / `Column by: Status` → `Save view` → the dialog
+  - "Auto-add sub-issues to project": nothing to set — Save and turn on.
+  - "Auto-archive items": filter `is:issue is:closed updated:<@today-2w`,
+    Enter.
+- **Sorting by Priority, board columns, table grouping:** the view → the
+  `View` button on the right → `Sort by: Priority` / `Column by: Status` /
+  `Group by: Status` → `Save view` → the dialog
   "Save display options for …?" → `Save`. Escape closes the dialog without
   saving: the sorting stays only in the URL (`?sortedBy…`), and the tab's
   unsaved marker lies — `check` verifies the result.
@@ -435,8 +468,9 @@ description is rewritten.
   Done and leaves a step to check the target in the UI.
 - **`Status` options are renamed keeping the same id**
   (`updateProjectV2Field`, `singleSelectOptions[].id`): task values and the
-  "Item closed" target are kept. Replacing options without ids gives new ids —
-  task statuses vanish, "Item closed" sets the deleted `Done`.
+  "Item closed" target are kept, recoloring too. Replacing options without
+  ids gives new ids — task statuses vanish, "Item closed" sets the deleted
+  `Done`.
 - **The template** — the elves project (`miroshnik/6`): everything the API
   lacks is configured there once. A copy (`copyProjectV2`) carries over views
   with their settings, fields and configured workflows, except auto-add; it
@@ -444,12 +478,16 @@ description is rewritten.
   is unavailable (someone else's account) or `--template none` — the project is
   created from scratch (`createProjectV2`) and brought up via the API:
   `Todo / In Progress / Done` → the canon with the same ids, `View 1` →
-  `Table`, the rest is created.
+  `Table`, the rest is created; the table's grouping is a UI step.
 - **The view filter is empty:** `iteration:@current` without an Iteration field
   silently hides tasks from the board.
 - **`Priority` is the organization's issue field** (`isIssueField`), not a
   project field of the same name. The API reads the sorting (`sortByFields`)
-  but doesn't set it; the board grouping too (`verticalGroupByFields`).
+  but doesn't set it; the board grouping and the table grouping too
+  (`verticalGroupByFields`, `groupByFields`).
+- **A view's columns are set** (`updateProjectV2View`,
+  `configuration.visibleFieldIds` in order) and read (`fields` of the view; a
+  roadmap without configured columns gives the default ones).
 - **A project that has been used** — it has tasks.
 
 ## Task and PR commands — details

package/skills/github/scripts/github.ts

@@ -57,13 +57,27 @@ type Any = any;
  */
 let N: Names = locale.names(locale.projectLanguage());
 
-const canonViews = () => [
-  { name: N.views.board, layout: "BOARD_LAYOUT" },
-  { name: N.views.table, layout: "TABLE_LAYOUT" },
+/**
+ * Views as in the template: columns by `columnKey` in the template's order, the table grouped by Status. The roadmap's
+ * columns aren't compared: the API gives it the default ones, it has no configured columns.
+ */
+interface CanonView {
+  name: string;
+  layout: string;
+  columns?: string[];
+  groupBy?: string;
+}
+const canonViews = (): CanonView[] => [
+  { name: N.views.board, layout: "BOARD_LAYOUT", columns: ["TITLE", STATUS, "LABELS", "SUB_ISSUES_PROGRESS"] },
+  { name: N.views.table, layout: "TABLE_LAYOUT", columns: ["TITLE", STATUS, "LABELS", "ASSIGNEES", "SUB_ISSUES_PROGRESS", N.fields.estimate], groupBy: STATUS },
   { name: N.views.roadmap, layout: "ROADMAP_LAYOUT" },
 ];
+/** A built-in column's name when the project has no such field yet (a column key is its type). */
+const BUILTIN_COLUMNS: Record<string, string> = { TITLE: "Title", ASSIGNEES: "Assignees", LABELS: "Labels", SUB_ISSUES_PROGRESS: "Sub-issues progress" };
 export const STATUS = "Status";
 const statusOptions = () => [N.status.backlog, N.status.inProgress, N.status.done];
+/** The template's colors of the Status options, in order — GitHub's colors of a new project's Todo / In Progress / Done. */
+const STATUS_COLORS = ["GREEN", "YELLOW", "PURPLE"];
 const numberFields = () => [N.fields.estimate, N.fields.actual, N.fields.tokens, N.fields.cost];
 const issueTypes = () => [N.issueTypes.task, N.issueTypes.bug, N.issueTypes.epic];
 export const PRIORITY = "Priority";
@@ -98,6 +112,14 @@ const ISSUE_LABEL_LIMIT = 100;
 export const WORKFLOW_ADDED = "Item added to project";
 export const WORKFLOW_CLOSED = "Item closed";
 export const WORKFLOW_AUTO_ADD = "Auto-add to project";
+const WORKFLOW_MERGED = "Pull request merged";
+const WORKFLOW_AUTO_CLOSE = "Auto-close issue";
+const WORKFLOW_SUB_ISSUES = "Auto-add sub-issues to project";
+const WORKFLOW_ARCHIVE = "Auto-archive items";
+/** The template's workflows, all on. */
+const WORKFLOWS = [WORKFLOW_ADDED, WORKFLOW_CLOSED, WORKFLOW_MERGED, WORKFLOW_AUTO_CLOSE, WORKFLOW_AUTO_ADD, WORKFLOW_SUB_ISSUES, WORKFLOW_ARCHIVE];
+/** The template's auto-archive filter: a task closed and untouched for two weeks leaves the board and the table. */
+const ARCHIVE_FILTER = "is:issue is:closed updated:<@today-2w";
 /** The template: a new project is its copy (views, fields, configured workflows except auto-add). */
 export const DEFAULT_TEMPLATE = "miroshnik/6";
 /**
@@ -203,6 +225,9 @@ interface View {
   filter: string | null;
   sortBy: string[];
   columnsBy: string[];
+  groupBy: string[];
+  /** The visible fields (`fields` of the view). */
+  columns: { id: string; name: string; dataType: string }[];
 }
 interface Option {
   id: string;
@@ -388,6 +413,8 @@ export const Q = {
           id number name layout filter
           sortByFields(first: 5) { nodes { direction field { ... on ProjectV2FieldCommon { name } } } }
           verticalGroupByFields(first: 5) { nodes { ... on ProjectV2FieldCommon { name } } }
+          groupByFields(first: 5) { nodes { ... on ProjectV2FieldCommon { name } } }
+          fields(first: 50) { nodes { ... on ProjectV2FieldCommon { id name dataType } } }
         }
       }
       fields(first: 100) {
@@ -1014,6 +1041,8 @@ function loadProject(io: Io, id: string, withItems = true): Project {
       filter: v.filter ?? null,
       sortBy: (v.sortByFields?.nodes ?? []).map((s: Any) => s.field?.name).filter(Boolean),
       columnsBy: (v.verticalGroupByFields?.nodes ?? []).map((f: Any) => f?.name).filter(Boolean),
+      groupBy: (v.groupByFields?.nodes ?? []).map((f: Any) => f?.name).filter(Boolean),
+      columns: (v.fields?.nodes ?? []).filter((f: Any) => f?.id).map((f: Any) => ({ id: f.id, name: f.name, dataType: f.dataType })),
     })),
     fields: p.fields.nodes
       .filter((f: Any) => f && f.id)
@@ -1066,8 +1095,17 @@ export function analyze(s: State): Check[] {
     link(`another project is linked: ${q(other.title)} (${other.url})`, { kind: "confirm", text: `unlink project ${q(other.title)} from the repository`, mutations: [{ op: "UnlinkProject", input: { projectId: other.id, repositoryId: s.repo.id } }] });
   }
 
+  // Columns: a built-in field by its type, the rest by name; a numeric field in another dictionary language is the same
+  // column — the Fields item renames it keeping the id.
+  const fieldAlias = fieldAliases();
+  const columnKey = (f: { name: string; dataType: string }) => (BUILTIN_FIELDS.has(f.dataType) ? f.dataType : (fieldAlias[f.name] ?? f.name));
+  const columnName = (key: string) => p.fields.find((f) => columnKey(f) === key)?.name ?? BUILTIN_COLUMNS[key] ?? key;
+  // a field the project doesn't have yet is skipped: the step's text changes when it appears, and the next round sets it
+  const columnFields = (keys: string[]) => keys.map((k) => p.fields.find((f) => columnKey(f) === k)).filter((f): f is Field => !!f);
+  const configuration = (keys: string[]) => ({ visibleFieldIds: columnFields(keys).map((f) => f.id) });
+
   // Views: by name; missing — rename an extra one of the same layout or create one; extra ones — delete.
-  const views = add("views", `Views ${canonViews().map((v) => q(v.name)).join(", ")} — the right layout, no filter, no others`);
+  const views = add("views", `Views ${canonViews().map((v) => q(v.name)).join(", ")} — the right layout, columns and grouping, no filter, no others`);
   const canonNames = new Set<string>(canonViews().map((v) => v.name));
   const spare = p.views.filter((v) => !canonNames.has(v.name));
   for (const c of canonViews()) {
@@ -1078,7 +1116,8 @@ export function analyze(s: State): Check[] {
         spare.splice(spare.indexOf(cand), 1);
         views(`missing ${q(c.name)}`, guarded(`rename view ${q(cand.name)} → ${q(c.name)}`, { op: "UpdateView", input: { viewId: cand.id, name: c.name } }));
       } else {
-        views(`missing ${q(c.name)}`, api(`create view ${q(c.name)} (${c.layout})`, { op: "CreateView", input: { projectId: p.id, name: c.name, layout: c.layout } }));
+        const input = { projectId: p.id, name: c.name, layout: c.layout, ...(c.columns ? { configuration: configuration(c.columns) } : {}) };
+        views(`missing ${q(c.name)}`, api(`create view ${q(c.name)} (${c.layout})`, { op: "CreateView", input }));
       }
       continue;
     }
@@ -1087,14 +1126,29 @@ export function analyze(s: State): Check[] {
     if (c.layout === "BOARD_LAYOUT" && v.layout === c.layout && v.columnsBy[0] !== STATUS) {
       views(`${q(c.name)} columns not by Status`, ui(`${q(c.name)}: View options → Column by → Status → Save`, `${p.url}/views/${v.number}`));
     }
+    if (c.columns) {
+      const have = v.columns.map(columnKey);
+      const missing = c.columns.filter((k) => !have.includes(k)).map((k) => q(columnName(k)));
+      const extra = v.columns.filter((f) => !c.columns!.includes(columnKey(f))).map((f) => q(f.name));
+      if (missing.length || extra.length) {
+        const why = [missing.length ? `missing ${missing.join(", ")}` : "", extra.length ? `extra ${extra.join(", ")}` : ""].filter(Boolean).join("; ");
+        const set = columnFields(c.columns).map((f) => f.name).join(", ");
+        views(`${q(c.name)} columns: ${why}`, api(`${q(c.name)}: columns ${set}`, { op: "UpdateView", input: { viewId: v.id, configuration: configuration(c.columns) } }));
+      }
+    }
+    // the API reads the grouping but doesn't set it
+    if (c.groupBy && v.layout === c.layout && v.groupBy[0] !== c.groupBy) {
+      views(`${q(c.name)} not grouped by ${c.groupBy}`, ui(`${q(c.name)}: View options → Group by → ${c.groupBy} → Save`, `${p.url}/views/${v.number}`));
+    }
   }
   for (const v of spare) views(`extra ${q(v.name)}`, guarded(`delete view ${q(v.name)}`, { op: "DeleteView", input: { viewId: v.id } }));
 
-  // Status: options by name or by a known English name — with the same id; missing ones — new.
-  const status = add("status", `${STATUS}: ${statusOptions().join(" → ")}`);
+  // Status: options by name or by a known English name — with the same id; missing ones — new; colors — the template's,
+  // descriptions are the project's own.
+  const status = add("status", `${STATUS}: ${statusOptions().join(" → ")} (${STATUS_COLORS.join(", ")})`);
   const sf = p.fields.find((f) => f.name === STATUS && f.options);
   if (!sf) {
-    status(`no ${STATUS} field`, api(`create field ${STATUS}`, { op: "CreateField", input: { projectId: p.id, dataType: "SINGLE_SELECT", name: STATUS, singleSelectOptions: statusOptions().map((name) => ({ name, color: "GRAY", description: "" })) } }));
+    status(`no ${STATUS} field`, api(`create field ${STATUS}`, { op: "CreateField", input: { projectId: p.id, dataType: "SINGLE_SELECT", name: STATUS, singleSelectOptions: statusOptions().map((name, i) => ({ name, color: STATUS_COLORS[i], description: "" })) } }));
   } else if (sf.options!.map((o) => o.name).join("\n") !== statusOptions().join("\n")) {
     const left = [...sf.options!];
     const take = (pred: (o: Option) => boolean) => {
@@ -1102,18 +1156,21 @@ export function analyze(s: State): Check[] {
       return i < 0 ? null : left.splice(i, 1)[0]!;
     };
     const aliases = statusAliases();
-    const next = statusOptions().map((name) => {
+    const next = statusOptions().map((name, i) => {
       const o = take((x) => x.name === name) ?? take((x) => aliases[x.name.toLowerCase()] === name);
-      return o ? { id: o.id, name, color: o.color, description: o.description ?? "" } : { name, color: "GRAY", description: "" };
+      return o ? { id: o.id, name, color: STATUS_COLORS[i]!, description: o.description ?? "" } : { name, color: STATUS_COLORS[i]!, description: "" };
     });
     const drop = left.length ? `; delete ${left.map((o) => q(o.name)).join(", ")}` : "";
     status(`options: ${sf.options!.map((o) => o.name).join(", ") || "none"}`, guarded(`${STATUS}: ${statusOptions().join(", ")} (rename the existing ones keeping the id${drop})`, { op: "UpdateField", input: { fieldId: sf.id, singleSelectOptions: next } }));
+  } else if (sf.options!.some((o, i) => o.color !== STATUS_COLORS[i])) {
+    // recoloring keeps the ids — the tasks' values and the workflows' targets, no confirmation needed
+    const next = sf.options!.map((o, i) => ({ id: o.id, name: o.name, color: STATUS_COLORS[i]!, description: o.description ?? "" }));
+    status(`colors: ${sf.options!.map((o) => `${o.name} ${o.color}`).join(", ")}`, api(`${STATUS}: colors ${STATUS_COLORS.join(", ")} (keeping the id)`, { op: "UpdateField", input: { fieldId: sf.id, singleSelectOptions: next } }));
   }
 
   // Fields: four numeric ones; a field in another dictionary language is renamed with the same id (the tasks' values are
   // kept); no custom fields beyond the canon; in an organization Priority is an issue field.
   const fields = add("fields", `Fields ${numberFields().map(q).join(", ")} (Number), no other custom ones`);
-  const fieldAlias = fieldAliases();
   const renamed = new Set<Field>();
   for (const name of numberFields()) {
     const f = p.fields.find((x) => x.name === name);
@@ -1177,14 +1234,18 @@ export function analyze(s: State): Check[] {
   }
 
   // Workflows: the API doesn't turn them on or show the target — only the UI. An unconfigured one isn't in the list.
-  const wf = add("workflows", `Workflows ${[WORKFLOW_ADDED, WORKFLOW_CLOSED, WORKFLOW_AUTO_ADD].map(q).join(", ")} are on`);
+  const wf = add("workflows", `Workflows ${WORKFLOWS.map(q).join(", ")} are on`);
   const how: Record<string, string> = {
     [WORKFLOW_ADDED]: `Edit → Set value → ${STATUS}: ${N.status.backlog}`,
     [WORKFLOW_CLOSED]: `Edit → Set value → ${STATUS}: ${N.status.done}`,
+    [WORKFLOW_MERGED]: `Edit → Set value → ${STATUS}: ${N.status.done}`,
+    [WORKFLOW_AUTO_CLOSE]: `Edit → ${STATUS}: ${N.status.done}`,
     // is:open — otherwise an updated closed task (not planned too) comes back into the project
     [WORKFLOW_AUTO_ADD]: `Edit → repository ${s.repo.name}, filter is:issue is:open (Enter)`,
+    [WORKFLOW_SUB_ISSUES]: "Edit",
+    [WORKFLOW_ARCHIVE]: `Edit → filter ${ARCHIVE_FILTER} (Enter)`,
   };
-  for (const name of [WORKFLOW_ADDED, WORKFLOW_CLOSED, WORKFLOW_AUTO_ADD]) {
+  for (const name of WORKFLOWS) {
     const w = p.workflows.find((x) => x.name === name);
     if (w?.enabled) continue;
     // an unconfigured workflow isn't in the API — a link to the list, it's in the menu on the left there
@@ -2354,7 +2415,7 @@ function cloudBrief(io: Io, slug: string, issue: Issue): void {
     state: N.comments.state,
     questions: N.sections.questions,
   };
-  for (const line of [N.queue.cloud, N.queue.cloudDoc, N.queue.cloudClose, N.queue.cloudDispatcher, N.queue.cloudQuestion]) io.out(locale.fill(line, vars));
+  for (const line of [N.queue.cloud, N.queue.cloudDoc, N.queue.repeats, N.queue.cloudClose, N.queue.cloudDispatcher, N.queue.cloudQuestion]) io.out(locale.fill(line, vars));
   io.out(
     `Next: the lines above — the cloud session's first prompt as is, the session started from the project folder (the cloud starts from main); ` +
       `then as a background command: bash ${waitCi()} issue ${number} — a cloud session can't message a local one (docs/cloud-sessions.md), the task's closing is the signal: ` +
@@ -2375,6 +2436,17 @@ const SESSION_ARCHIVE =
   "an executor session whose task closed — the dispatcher archives it in an auto project where the agent has the tool, " +
   "not one still working in the background or awaiting the owner's answer; outside auto the owner closes it";
 
+/**
+ * A task's open PR: linked to it by GitHub, or one of the repository's recent ones by the task branch or `Closes #N` in
+ * its body. The queue's «=» (the executor waits for its CI) and the epic refresh's «already going» (#636).
+ */
+function openPrOf(io: Io, slug: string): (i: Issue) => number | undefined {
+  const [owner, name] = slug.split("/");
+  const recent = (graphql(io, Q.RecentPrs, { owner, name })?.repository?.pullRequests?.nodes ?? []).filter((p: Any) => p.state === "OPEN");
+  return (i) =>
+    i.prs.find((p) => p.state === "OPEN")?.number ?? recent.find((p: Any) => isTaskBranch(p.headRefName ?? "", i.number) || closingInBody(p.body ?? "").includes(i.number))?.number;
+}
+
 /**
  * The dispatcher's queue: its ready tasks go to background executors (subagents), K at a time; the queue is re-read
  * after each answer, so tasks that appeared meanwhile are picked up. A session with its own task dispatches too (#546:
@@ -2405,10 +2477,7 @@ export function cmdTaskQueue(io: Io, slug: string, o: QueueFilter): number {
     if (found.length >= 100) io.out("○ the search gave 100 open tasks — the queue sees only them: narrow it with --epic");
     numbers = found.filter((x) => x?.state === "OPEN").map((x) => x.number);
   }
-  const [owner, name] = slug.split("/");
-  const recent = (graphql(io, Q.RecentPrs, { owner, name })?.repository?.pullRequests?.nodes ?? []).filter((p: Any) => p.state === "OPEN");
-  const openPr = (i: Issue) =>
-    i.prs.find((p) => p.state === "OPEN")?.number ?? recent.find((p: Any) => isTaskBranch(p.headRefName ?? "", i.number) || closingInBody(p.body ?? "").includes(i.number))?.number;
+  const openPr = openPrOf(io, slug);
   const handed = handedOut(io, slug);
   /** Issue states the queue has read; a hand-out's task outside the queue is read when its worktree is up for removal. */
   const states = new Map<number, string>();
@@ -2869,8 +2938,8 @@ export function cmdTaskAssignment(io: Io, slug: string, number: number, o: { clo
   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];
+    ? [N.queue.sessionLead, ...resume, N.queue.sessionIs, N.queue.sessionName, N.queue.sessionWait, N.queue.repeats, 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.repeats, 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(
@@ -3063,8 +3132,9 @@ const textBlock = (body: string) => (body ? `~~~~markdown\n${body}\n~~~~` : N.ac
  * its open tasks and the PR files run to tens of KB, and the session at peak context would copy them into the subagent
  * call as output tokens. In it — the task and its PR with its files, the epic and its open tasks with their texts, the
  * copies of links and the answers in comments the script found, the checks by meaning quoted from reference.md as is,
- * what may be changed and the answer form; in the project language (the `actualize` keys). No epic, or no open tasks in
- * it besides this one — the checks by meaning have nothing to go through: a "not needed" line, no subagent.
+ * what may be changed and the answer form; under each open task — where a repeat finding of check 5 goes, by its Status
+ * and open PR (#636); in the project language (the `actualize` keys). No epic, or no open tasks in it besides this one
+ * — the checks by meaning have nothing to go through: a "not needed" line, no subagent.
  */
 export function cmdTaskActualize(io: Io, slug: string, number: number, o: { assignment: boolean } = { assignment: false }): number {
   const issue = loadIssue(io, slug, number);
@@ -3076,6 +3146,8 @@ export function cmdTaskActualize(io: Io, slug: string, number: number, o: { assi
   const open = epic.subIssues.filter((x) => x.state === "OPEN" && x.number !== number).map((x) => loadTaskText(io, slug, x.number));
   if (!o.assignment) refreshMechanics(io, slug, { number, merged: prs.length > 0, epic, open });
   if (!open.length) return io.out(`○ refresh not needed: epic #${epic.number} has no open tasks besides #${number}. ${later}`), 0;
+  // the board with its Status (and its language) — the assignment names where a repeat finding goes (#636)
+  const ctx = o.assignment ? taskContext(io, slug) : null;
   const vars = { task: N.subagentPrompt.task, epicWord: N.subagentPrompt.epic, number, epic: epic.number, repo: slug };
   const lead = locale.fill(N.actualize.lead, vars);
   if (!o.assignment) {
@@ -3094,7 +3166,17 @@ export function cmdTaskActualize(io: Io, slug: string, number: number, o: { assi
     if (files.length) lines.push(locale.fill(N.actualize.files, { pr: p.number }), ...files.map(fileLine));
   }
   lines.push("", locale.fill(N.actualize.epic, { ...vars, title: epic.title }), textBlock(epic.body), "", N.actualize.openTasks);
-  for (const t of open) lines.push("", locale.fill(N.actualize.openTask, { number: t.number, title: t.title }), textBlock(t.body));
+  const openPr = openPrOf(io, slug);
+  /** Where a repeat finding of check 5 goes (#636): a task in Backlog takes it as an item, one already going doesn't. */
+  const target = (n: number): string[] => {
+    const i = loadIssue(io, slug, n);
+    const status = itemIn(ctx!, i)?.status ?? null;
+    const pr = openPr(i);
+    const work = [status === N.status.inProgress ? locale.fill(N.actualize.taskStatus, { status }) : "", pr === undefined ? "" : locale.fill(N.actualize.taskPr, { pr })].filter(Boolean);
+    if (work.length) return [locale.fill(N.actualize.inWork, { work: work.join(", ") })];
+    return status === N.status.backlog ? [locale.fill(N.actualize.backlog, { status: locale.fill(N.actualize.taskStatus, { status }) })] : [];
+  };
+  for (const t of open) lines.push("", locale.fill(N.actualize.openTask, { number: t.number, title: t.title }), ...target(t.number), textBlock(t.body));
   const copies = linkCopies(epic, open);
   if (copies.length) lines.push("", N.actualize.copies, ...copies.map((c) => locale.fill(N.actualize.copy, c)));
   const answers = commentAnswers([epic, ...open]);

package/skills/github/scripts/locale.ts

@@ -73,6 +73,14 @@ export interface Names {
     epic: string;
     openTasks: string;
     openTask: string;
+    /**
+     * Where a repeat finding of check 5 goes, under an open task's heading (#636): a task in Backlog takes it as an item
+     * (`backlog`), one already going — In progress or with an open PR — doesn't (`inWork`); `taskStatus`, `taskPr` — why.
+     */
+    backlog: string;
+    inWork: string;
+    taskStatus: string;
+    taskPr: string;
     noBody: string;
     copies: string;
     copy: string;
@@ -104,6 +112,8 @@ export interface Names {
     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;
+    /** Repeats in the files the task changes anyway — fixed in its PR, not a new task (#636); every kind of executor. */
+    repeats: string;
     found: string;
     question: string;
     answer: string;