@detergent-software/conductor 3.0.0-dev.4 → 3.0.0-dev.40

package/build/help.js

@@ -41,7 +41,7 @@ const WINDOW = [
     '<when>',
     'for --since or --until: now, today, yesterday, a span ago (30m, 24h, 7d), a date, or a date and time',
 ];
-const WORKER = ['<worker>', 'its item (ATK-309), its name (probe-ATK-309) or #<id>'];
+const WORKER = ['<worker>', 'its item (ENG-309), its name (probe-ENG-309) or #<id>'];
 const REPORT_OPTIONS = [
     ['--json', 'print the report as JSON'],
     ['--project <name>', 'one project only'],
@@ -51,12 +51,12 @@ const REPORT_OPTIONS = [
 export const COMMANDS = [
     {
         arguments: [
-            ['<item>', "the item (ATK-312), or the inbox item's id as '#12' (quoted: a shell reads #12 as a comment)"],
+            ['<item>', "the item (ENG-312), or the inbox item's id as '#12' (quoted: a shell reads #12 as a comment)"],
         ],
         description: ['Posts "approve" on the item as you and wakes its worker.'],
         examples: [
-            ["approve ATK-312's plan", 'approve ATK-312'],
-            ['the same, with a word for the worker', 'approve ATK-312 --text "skip the docs"'],
+            ["approve ENG-312's plan", 'approve ENG-312'],
+            ['the same, with a word for the worker', 'approve ENG-312 --text "skip the docs"'],
         ],
         group: 'Inbox and approvals',
         name: 'approve',
@@ -67,8 +67,11 @@ export const COMMANDS = [
     },
     {
         arguments: [WORKER],
-        description: ['Wakes a parked worker (with no event text) and opens its session in a tab.'],
-        examples: [["open ATK-309's worker in a tab", 'attach ATK-309']],
+        description: [
+            "Wakes a parked worker (with no event text) and opens its session in a tab, whatever config.json's workers.tab says: in the terminal workers.terminal names (Windows Terminal, iTerm or Terminal on macOS, tmux elsewhere).",
+            'A tmux tab is in a detached session, and the command prints how to attach to it. With no terminal to open, it prints the claude attach to run yourself.',
+        ],
+        examples: [["open ENG-309's worker in a tab", 'attach ENG-309']],
         group: 'Projects and workers',
         name: 'attach',
         seeAlso: ['launch', 'retire', 'status'],
@@ -81,10 +84,10 @@ export const COMMANDS = [
             ['<slug>', 'a few words for the branch, joined by dashes'],
         ],
         description: [
-            "Renames the worktree's branch (worktree-ATK-454) to <type>/<key>-<slug>, such as feat/atk-454-code-host-writes, with the item from the worktree's name (or --item).",
+            "Renames the worktree's branch (worktree-ENG-454) to <type>/<key>-<slug>, such as feat/eng-454-code-host-writes, with the item from the worktree's name (or --item).",
             'Prints JSON. Runs here, with or without a conductor.',
         ],
-        examples: [['in the ATK-454 worktree: feat/atk-454-code-host-writes', 'branch feat code-host-writes']],
+        examples: [['in the ENG-454 worktree: feat/eng-454-code-host-writes', 'branch feat code-host-writes']],
         group: 'Used by work skills',
         name: 'branch',
         options: [ITEM],
@@ -93,7 +96,7 @@ export const COMMANDS = [
         usage: ['branch <type> <slug> [--item <item>]'],
     },
     {
-        arguments: [['<item>', 'the item (ATK-312)']],
+        arguments: [['<item>', 'the item (ENG-312)']],
         description: [
             "The item's context for a worker's orient step, read by the conductor from the tracker (no MCP): title, status, project, Area and labels, blockers, the items it blocks and related items, its phase notes, the approve or revise: after the newest Plan, and the description.",
             "Also the work skill's phase (orient, plan, awaiting-approval, implement, wait, land, done, abandoned, canceled), from the status, the notes and the PR; and the PR (its worker's, else the newest PR opened note's) as its code host has it, with its verdict.",
@@ -101,8 +104,8 @@ export const COMMANDS = [
             "With no conductor, it is read here from this checkout's project, as its account.",
         ],
         examples: [
-            ['orient on ATK-312', 'brief ATK-312'],
-            ['check for an approval after a wake', 'brief ATK-312 --fresh'],
+            ['orient on ENG-312', 'brief ENG-312'],
+            ['check for an approval after a wake', 'brief ENG-312 --fresh'],
         ],
         exitCodes: [
             [
@@ -132,9 +135,7 @@ export const COMMANDS = [
             "The clone stays out of the worktree's git status, and conduct retire checks it for unpushed work.",
             'Prints JSON. Runs here.',
         ],
-        examples: [
-            ['clone the registry for a skill fix', 'checkout EmergentSoftware/agentic-toolkit-registry fix lock-path'],
-        ],
+        examples: [['clone the registry for a skill fix', 'checkout contoso/skills-registry fix lock-path']],
         group: 'Used by work skills',
         name: 'checkout',
         options: [ITEM],
@@ -143,13 +144,13 @@ export const COMMANDS = [
         usage: ['checkout <owner>/<repo> <type> <slug> [--item <item>]'],
     },
     {
-        arguments: [['<item>', 'the item (ATK-312)']],
+        arguments: [['<item>', 'the item (ENG-312)']],
         description: [
             "Every comment on the item, oldest first, with its whole text: when, who, and whether an approver wrote it. Read as conduct brief reads the item: by the conductor (no MCP), else here from this checkout's project, as its account.",
         ],
         examples: [
-            ['read ATK-312 whole', 'comments ATK-312'],
-            ['what was said since the plan', 'comments ATK-312 --since 2026-10-15T09:00Z'],
+            ['read ENG-312 whole', 'comments ENG-312'],
+            ['what was said since the plan', 'comments ENG-312 --since 2026-10-15T09:00Z'],
         ],
         exitCodes: [[1, 'refused, or nothing was read, as for conduct brief: the message says why']],
         group: 'Used by work skills',
@@ -165,9 +166,9 @@ export const COMMANDS = [
     },
     {
         description: [
-            "Opens the console, the Claude session the conductor mod serves, in a Windows Terminal tab in the conductor's own folder (~/.conductor/console): it belongs to no project, so it opens with none registered.",
+            "Opens the console, the Claude session the conductor mod serves, in a tab in the conductor's own folder (~/.conductor/console): it belongs to no project, so it opens with none registered.",
             'It starts with the conductor plugin (--plugin-dir ~/.conductor/plugin), which brings the mod and /conductor:conductor-console.',
-            'The tab needs Windows Terminal, and refuses while CONDUCTOR_HOME is set (a tab would not see it): use --here then.',
+            'The tab opens in the terminal config.json\'s workers.terminal names: Windows Terminal (window "conductor"), iTerm or Terminal on macOS, or tmux elsewhere (session conductor: the command prints its tmux attach). It starts with this terminal\'s CONDUCTOR_HOME. With no terminal to open (no tmux), it refuses: the start is claimed by then, so run `conduct console --here --force`.',
             'Also how to get it back after it closed: it keeps no state of its own.',
             'One at a time: it refuses while a console is open, or started in the last minute and not yet following the events.',
         ],
@@ -249,8 +250,8 @@ export const COMMANDS = [
         ],
         examples: [
             [
-                'a follow-up in apps/conductor that waits on ATK-480',
-                'file --title "conductor: color the status" --body-file follow-up.md --area apps/conductor --blocked-by ATK-480',
+                'a follow-up in apps/web that waits on ENG-480',
+                'file --title "web: color the status" --body-file follow-up.md --area apps/web --blocked-by ENG-480',
             ],
         ],
         exitCodes: [[1, 'refused or failed'], LOST_LOGIN],
@@ -259,7 +260,7 @@ export const COMMANDS = [
         options: [
             [
                 '--area <area>',
-                "one of the tracker's Areas: a label of the Area group, a path below a board's root, or the name after a GitHub Issues area prefix",
+                "one of the tracker's Areas: a label of the Area group, a path below a board's root, or the name after a GitHub Issues area prefix; left out for a Linear team with no Area group (tracker.areaLabelGroup null)",
             ],
             ['--blocked-by <item>…', 'the items it waits on; repeated or comma-separated'],
             ['--body-file <file>', 'its description'],
@@ -275,7 +276,7 @@ export const COMMANDS = [
         seeAlso: ['brief', 'note'],
         summary: 'file a follow-up of the item, in Backlog with its Area',
         usage: [
-            'file --title <title> --body-file <file> --area <area> [--related <item>…] [--blocked-by <item>…] [--human] [--waits-release] [--item <item>]',
+            'file --title <title> --body-file <file> [--area <area>] [--related <item>…] [--blocked-by <item>…] [--human] [--waits-release] [--item <item>]',
         ],
     },
     {
@@ -284,8 +285,8 @@ export const COMMANDS = [
             "Sets the project's slots or ordering weight until <when>; with neither, its items go first (weight 100).",
         ],
         examples: [
-            ['work atk first until 17:00', 'focus atk --until 17:00'],
-            ['six slots for atk until tomorrow', 'focus atk --slots 6 --until tomorrow'],
+            ['work web first until 17:00', 'focus web --until 17:00'],
+            ['six slots for web until tomorrow', 'focus web --slots 6 --until tomorrow'],
         ],
         group: 'Scheduling',
         name: 'focus',
@@ -306,7 +307,7 @@ export const COMMANDS = [
         ],
         examples: [
             ['the last 24 hours', 'history'],
-            ['a week of atk', 'history 7d --project atk'],
+            ['a week of web', 'history 7d --project web'],
             ['the last 30 minutes', 'history --since 30m'],
         ],
         group: 'Logs and reports',
@@ -326,29 +327,71 @@ export const COMMANDS = [
         summary: 'what waits on you',
         usage: ['inbox [--json]'],
     },
+    {
+        arguments: [['<path>', 'a checkout of the repo; by default the one you are in']],
+        description: [
+            "Onboards the repo of a checkout. It detects what it can: the code host from origin (GitHub or Azure DevOps), CI as the code host's own, the base branch from origin/HEAD, setup from the lockfiles at the root, a verify-* skill in .claude/skills, and the item key the commits carry. It asks for the rest, each detected value the default.",
+            "It writes a starter profile to ~/.conductor/projects/<name>.json, or with --shared to the checkout's .claude/conductor.json, which counts once it is pushed. A profile file that is there is never overwritten, and a repo profile on origin/<base> that names the project means nothing is written. Then it runs project add and project check.",
+            "Run it again after each step it prints: trust the new clone with `claude` once, and with no verify skill, the conductor plugin's /conductor:create-verification-skill in the checkout (in `claude --plugin-dir <the plugin>`), committed and pushed. Each run goes on from what is done, so a run on a project that is set up only fetches and checks it.",
+            'Without --yes it asks in the terminal, and refuses with no terminal (Git Bash under mintty is none to node).',
+        ],
+        examples: [
+            ['onboard the repo of the checkout you are in, answering its questions', 'init'],
+            ['the same with no questions, for a GitHub repo with GitHub Issues', 'init --yes --key PAR'],
+            ['with a Linear team as the tracker', 'init --tracker linear --team ENG'],
+            ['a profile the team shares, committed to the repo', 'init --shared'],
+        ],
+        group: 'Projects and workers',
+        name: 'init',
+        options: [
+            ['--name <name>', "the project's name; by default the repo's, or the one it was added under"],
+            ['--base <branch>', 'the base branch; by default origin/HEAD'],
+            ['--tracker <kind>', "github-issues, ado-boards or linear; by default the code host's own"],
+            ['--key <KEY>', 'the item key on GitHub Issues or ADO Boards (PAR-12 is issue #12)'],
+            ['--team <key>', 'the Linear team key, with --tracker linear'],
+            ['--query <query>', 'the saved Boards query that is the queue, with ADO Boards'],
+            ['--shared', "write the repo's .claude/conductor.json instead of the machine profile"],
+            ['--yes', 'ask nothing: take what was detected, and refuse what is missing with its flag'],
+        ],
+        seeAlso: ['project', 'profile', 'launch'],
+        summary: 'onboard a repo: a starter profile, then add and check it',
+        usage: [
+            'init [<path>] [--name <name>] [--base <branch>] [--tracker <kind>] [--key <KEY>] [--team <key>] [--query <query>] [--shared] [--yes]',
+        ],
+    },
     {
         description: [
-            "Registers a Windows Task Scheduler task that runs conduct supervise at logon, which restarts the daemon if it dies. Run it from the main checkout: a worktree's build goes away.",
+            "Registers what runs conduct supervise at logon, which restarts the daemon if it dies, with this build. Run it from the main checkout: a worktree's build goes away.",
+            'Windows: a Task Scheduler task, "Conductor", which it registers without starting.',
+            'macOS: a launchd agent, ~/Library/LaunchAgents/software.detergent.conductor.plist, which it loads into your login session, and that starts it. Its output goes to ~/.conductor/logs/startup.log. Run it in a terminal on the Mac, not over ssh alone.',
+            'Linux: a systemd user unit, ~/.config/systemd/user/conductor.service, which it enables and starts. Its output goes to the journal (journalctl --user -u conductor). It starts at your login; on a machine nobody logs in to, loginctl enable-linger starts it at boot, and the command says so.',
+            "The agent and the unit keep this terminal's PATH, since a login gives them a short one with no claude or git: run it again after that changes.",
+            'On macOS and Linux, running it again restarts a daemon the agent or unit started, so the new one counts. A daemon started another way keeps running, and the one the startup starts beside it ends on its lock. --remove leaves a running daemon alone.',
         ],
         examples: [['start the daemon at every logon', 'install-startup']],
         group: 'Setup',
         name: 'install-startup',
-        options: [['--remove', 'remove that logon task']],
+        options: [['--remove', 'remove that task, agent or unit']],
         seeAlso: ['supervise', 'start'],
-        summary: 'start the daemon at logon (Windows Task Scheduler)',
+        summary: 'start the daemon at every logon',
         usage: ['install-startup', 'install-startup --remove'],
     },
     {
         arguments: [['<pr>', 'the PR number']],
         description: [
-            "Sets the worker's PR up to land, then gives its first verdict. Safe to repeat. A brake already on the PR (a comment, a failed build, conflicts) is reported and nothing is armed. Otherwise it arms the host's own landing: on Azure DevOps a +10 vote (auto mode) and auto-complete with noFastForward; on GitHub, auto-merge with a merge commit (auto mode, where the repo allows it, refused with the reason where it doesn't). Then it posts the Landing note.",
+            "Sets the worker's PR up to land, then gives its first verdict. Safe to repeat, except with --requeue. A brake already on the PR (a comment, a failed build, conflicts) is reported and nothing is armed. Otherwise it arms the host's own landing: on Azure DevOps a +10 vote (auto mode) and auto-complete with noFastForward; on GitHub, auto-merge with a merge commit (auto mode, where the repo allows it, refused with the reason where it doesn't). Then it posts the Landing note.",
             'A Landing note with auto-complete or auto-merge gone means someone cancelled it: auto-merge-cancelled, until --rearm. A PR ADO started completing in the last few minutes, which clears auto-complete, is waiting instead.',
             'With a conductor, the daemon records the landing and keeps it armed while the worker waits (conduct wait pr <pr>): it queues an expired build again and restores a cleared vote.',
+            "--requeue <run> queues one of a build-failed PR's failed builds again, for a flake no change caused, then arms as above: on Azure Repos through its policy evaluation, on GitHub by re-running the failed jobs of the check's Actions run (a PR the item opened from a checkout; one a hook's publish opened has none, so land refuses it). It posts a closed Requeue note with the run, the build and the PR's head commit first, and refuses a second requeue of that build on that head, even for the new run: a second failure is fixed and pushed. Each build that failed on the head can be queued again once. It refuses while a comment waits for an answer, and a GitHub run with a job still running. Until the PR shows the new run, the verdict waits on the build instead of reporting the old failure, for 15 minutes at most. A GitHub re-run keeps the run's id, so a failed check of it that finished after the note is the new attempt's failure, reported at once.",
             'Prints JSON with the verdict and "via".',
         ],
         examples: [
             ['land PR 1850 by itself', 'land 1850 --mode auto --reason "S fix, no review paths"'],
             ['arm it again after a cancel', 'land 1850 --rearm --reason "the operator said go on"'],
+            [
+                'queue a flaky build again, once',
+                'land 1850 --requeue 8040 --reason "ENG-637: the known flake, no change caused it"',
+            ],
         ],
         exitCodes: [[1, 'refused'], LOST_LOGIN],
         group: 'Used by work skills',
@@ -359,23 +402,30 @@ export const COMMANDS = [
                 '--mode auto|review',
                 "held to the profile's landing rules for the PR's files and the plan's tier: auto where they allow it, else refused; without it the rules pick",
             ],
-            ['--reason <why>', 'why this mode, for the Landing note (required)'],
+            [
+                '--reason <why>',
+                'why this mode, for the Landing note (required); with --requeue, why the build is queued again, for the Requeue note',
+            ],
             ['--rearm', 'arm it again after someone cancelled it'],
             PR_REPO,
+            ['--requeue <run>', 'queue that failed build again first, once per build and head commit'],
             ['--tier S|M|L', "the plan's tier without a conductor; the daemon takes it from the item's Plan note"],
         ],
         seeAlso: ['wait', 'pr', 'runs'],
         summary: "arm the worker's PR to land, and its first verdict",
-        usage: ['land <pr> --reason <why> [--mode auto|review] [--rearm] [--tier S|M|L] [--repo <repo>] [--item <item>]'],
+        usage: [
+            'land <pr> --reason <why> [--mode auto|review] [--rearm] [--requeue <run>] [--tier S|M|L] [--repo <repo>] [--item <item>]',
+        ],
     },
     {
-        arguments: [['<item>', 'the item to work (ATK-312)']],
+        arguments: [['<item>', 'the item to work (ENG-312)']],
         description: [
-            "Starts a worker on the item: its worktree, a background session running the project's work skill, and a tab.",
+            "Starts a worker on the item: its worktree, and a background session running the project's work skill.",
+            "Workers run headless. With config.json's workers.tab, each launch also opens a tab attached to the session (as conduct attach does); a tab that fails to open never fails the launch.",
         ],
         examples: [
-            ['start a worker on ATK-312', 'launch ATK-312'],
-            ['a probe with its own prompt', 'launch ATK-312 --probe --prompt "time the test suite"'],
+            ['start a worker on ENG-312', 'launch ENG-312'],
+            ['a probe with its own prompt', 'launch ENG-312 --probe --prompt "time the test suite"'],
         ],
         group: 'Projects and workers',
         name: 'launch',
@@ -386,7 +436,7 @@ export const COMMANDS = [
             ['--prompt <text>', "the session's first prompt instead of the work skill (or the probe prompt)"],
         ],
         seeAlso: ['attach', 'retire', 'status'],
-        summary: 'start a worker: its worktree, a background session, a tab',
+        summary: 'start a worker: its worktree and a background session',
         usage: ['launch <item> [--project <name>] [--probe] [--prompt <text>] [--conductor <name>]'],
     },
     {
@@ -438,7 +488,7 @@ export const COMMANDS = [
     },
     {
         arguments: [
-            ['<item>', 'the item (ATK-312)'],
+            ['<item>', 'the item (ENG-312)'],
             ['<file>', 'the note, its heading first'],
         ],
         description: [
@@ -447,7 +497,7 @@ export const COMMANDS = [
             "With no conductor, it is posted from this checkout as its project's account, and the item moves the same way.",
             `The note must keep worker protocol ${PROTOCOL} (protocol/PROTOCOL.md in the package): a known phase (${PHASES.join(', ')}), a Handoff with a kind and one line (${HANDOFF_KINDS.join(', ')}), no kind on a phase that carries none, and a Plan with its **Size tier** and **Landing:** lines. One that breaks it is refused, with the rule, before anything is posted.`,
         ],
-        examples: [['post the Plan note', 'note ATK-312 plan.md']],
+        examples: [['post the Plan note', 'note ENG-312 plan.md']],
         exitCodes: [
             [
                 1,
@@ -466,14 +516,14 @@ export const COMMANDS = [
         usage: ['note <item> <file> [--worker <worker>]'],
     },
     {
-        arguments: [['<item>', 'the item (ATK-312)']],
+        arguments: [['<item>', 'the item (ENG-312)']],
         description: [
             "The item's phase notes with their whole text, oldest first: what conduct brief lists as one line each. --phase and --kind keep the ones that match, and --last the newest of those, such as the Handoff an escalation is about.",
             "Read as conduct brief reads the item: by the conductor (no MCP), else here from this checkout's project, as its account.",
         ],
         examples: [
-            ['every note on ATK-312', 'notes ATK-312'],
-            ['the newest conductor Handoff', 'notes ATK-312 --phase Handoff --kind conductor --last'],
+            ['every note on ENG-312', 'notes ENG-312'],
+            ['the newest conductor Handoff', 'notes ENG-312 --phase Handoff --kind conductor --last'],
         ],
         exitCodes: [[1, 'refused, or nothing was read, as for conduct brief: the message says why']],
         group: 'Used by work skills',
@@ -509,7 +559,7 @@ export const COMMANDS = [
         group: 'Inbox and approvals',
         name: 'notify',
         options: [
-            ['--channel remote-control|pushover', 'with test: push on that channel'],
+            ['--channel remote-control|pushover|webhook', 'with test: push on that channel'],
             ['--json', 'print the state as JSON'],
             ['--kind <kind>', 'with test: the kind of item (npm-otp by default)'],
             ['--raise', 'with test: put a real item in the inbox instead; it takes no --channel'],
@@ -520,7 +570,7 @@ export const COMMANDS = [
         usage: [
             'notify [--json]',
             'notify profile [<name>] [--until <when>]',
-            'notify test [--kind <kind>] [--channel remote-control|pushover] [--raise]',
+            'notify test [--kind <kind>] [--channel remote-control|pushover|webhook] [--raise]',
         ],
     },
     {
@@ -528,7 +578,7 @@ export const COMMANDS = [
         description: ['No new launches in the project, or in every project without one, until <when> or conduct unpause.'],
         examples: [
             ['pause every project until tomorrow', 'pause --until tomorrow'],
-            ['pause atk until you unpause it', 'pause atk'],
+            ['pause web until you unpause it', 'pause web'],
         ],
         group: 'Scheduling',
         name: 'pause',
@@ -557,6 +607,10 @@ export const COMMANDS = [
     },
     {
         commands: [
+            [
+                'abandon <pr>',
+                "close the worker's PR unmerged (Azure DevOps abandons it), then post a closed `<skill> · Abandoned` note on it with --reason. Only the item's PR: its title and head branch carry the item key, and it is from the branch the checkout is on now (--force: from another branch of the item). A merged PR is refused; one closed already only gets the note if it lacks one, so it is safe to repeat",
+            ],
             [
                 'create',
                 "check the title carries the item key, the branch carries it too, the description fits the host, no PR is open from the branch, nothing is uncommitted, the branch is ahead of its base, and commitlint passes, all before anything is pushed. Then push and open the PR into the base branch (--repo: into the other repo's default branch, from its checkout)",
@@ -567,17 +621,18 @@ export const COMMANDS = [
             ],
         ],
         description: [
-            "Opens the worker's PR, checked and pushed, or reads its threads.",
+            "Opens the worker's PR, checked and pushed, reads its threads, or abandons it.",
             "The description ends with the tracker's reference when it has one (AB#<id> for an ADO Boards item on a GitHub PR, so the Boards GitHub app links it), counted in its length.",
-            'With a conductor, the daemon opens it for the worker that owns this checkout, checking the ownership again, and records the PR on the worker. Without one (or an older one) it opens it here.',
+            'With a conductor, the daemon opens or abandons it for the worker that owns this checkout, checking the ownership again, and records the PR on the worker. Without one (or an older one) it does it here.',
             'Prints JSON with "via": "daemon" or "local".',
         ],
         examples: [
             [
                 'check everything, push nothing',
-                'pr create --title "feat(conductor): help sections (ATK-478)" --body-file pr.md --dry-run',
+                'pr create --title "feat(web): help sections (ENG-478)" --body-file pr.md --dry-run',
             ],
             ["PR 1850's threads", 'pr threads 1850'],
+            ['drop PR 1850, which another PR made redundant', 'pr abandon 1850 --reason "ENG-412\'s PR merged the same fix"'],
         ],
         exitCodes: [[1, 'refused or failed'], LOST_LOGIN],
         group: 'Used by work skills',
@@ -585,53 +640,82 @@ export const COMMANDS = [
         options: [
             ['--body-file <file>', 'with create: its description'],
             ['--dry-run', 'with create: stop before the push'],
+            ['--force', "with abandon: the item's PR from a branch the checkout isn't on"],
             ITEM,
+            ['--reason <why>', 'with abandon: why, in its note'],
             PR_REPO,
             ['--title <title>', 'with create: its title, with the item key'],
         ],
         seeAlso: ['land', 'reply', 'state'],
-        summary: "open the worker's PR, checked and pushed; read its threads",
+        summary: "open the worker's PR, read its threads, or abandon it",
         usage: [
+            'pr abandon <pr> --reason <why> [--repo <repo>] [--item <item>] [--force]',
             'pr create --title <title> --body-file <file> [--repo <repo>] [--item <item>] [--dry-run]',
             'pr threads <pr> [--repo <repo>]',
         ],
     },
+    {
+        arguments: [['<project>', 'a project added with conduct project add']],
+        description: [
+            "A project's profile as the conductor reads it: its machine profile (~/.conductor/projects/<project>.json) over the repo's .claude/conductor.json at origin/<base> in its clone, when there is one.",
+            "Objects merge key by key and the machine's wins; arrays are replaced whole; rules stack, the machine's first, so a machine rule shadows a repo rule with its id. Each field says whether it came from the machine, the repo or a default.",
+            'Read here from the files and the clone as fetched last, with or without the daemon.',
+        ],
+        examples: [
+            ["web's profile and where each field came from", 'profile web'],
+            ['the same as JSON', 'profile web --json'],
+        ],
+        exitCodes: [[1, 'no clone of the project, or its profile is invalid (the message names the files)']],
+        group: 'Projects and workers',
+        name: 'profile',
+        options: [['--json', 'print the profile and its sources as JSON']],
+        seeAlso: ['project', 'rules'],
+        summary: "a project's profile, each field with its source",
+        usage: ['profile <project> [--json]'],
+    },
     {
         commands: [
-            ['add <path>', 'register the project whose checkout holds .claude/conductor.json; works without the daemon'],
+            [
+                'add <url | path>',
+                "clone the project's remote into ~/.conductor/projects/<name>/repo and register it. A path names a checkout whose origin is cloned: the folder itself is never cloned or touched again. The name is the one the repo's .claude/conductor.json gives, or --name. Adding a project again fetches its clone and updates the registration in place, and moves a project registered by its checkout to a clone. Works without the daemon",
+            ],
             ['list [--json]', 'the registered projects'],
             [
                 'remove <name>',
-                "drop a registration: a renamed project's old name, or a project no longer conducted. Resolves its open inbox items; refused while it has workers in flight. Works without the daemon",
+                'drop a registration: a project no longer conducted. Resolves its open inbox items; refused while it has workers in flight. Its clone and machine profile stay. Works without the daemon',
             ],
             [
                 'check <name>',
-                'whether the project can be conducted, before its first launch finds out: its profile (and what differs from the stored copy), tracker, code host and base branch, release pipelines, a throwaway worktree made and removed through its hooks, its installed skills, a free port slot and its health URLs. One ok, warn, fail or skip line each, with the fix',
+                'whether the project can be conducted, before its first launch finds out: its profile (what differs from the stored copy, and fields newer than its conductor minimum), tracker, code host and base branch, release pipelines, a throwaway worktree made from the clone and removed, with its skills and Claude Code trust, the plugin skills, free ports and its health URLs. One ok, warn, fail or skip line each, with the fix',
             ],
         ],
         description: [
             'Registers a project, lists the registered ones, removes one, or checks one.',
-            'After that the daemon takes the profile from disk when it starts and each time the file is saved.',
-            'A project keeps the name it was registered under. To rename one, remove the old name, then add it again: with both registered, both would read the same queue.',
+            'A project is a clone the conductor owns: its worktrees are made there (~/.conductor/projects/<name>/worktrees), never in a checkout of yours. The daemon fetches the clone every clones.fetchMinutes and takes the profile again when its .claude/conductor.json on the base branch changes, or when the machine profile (~/.conductor/projects/<name>.json) is saved. `conduct profile <name>` shows how the two merge.',
+            'Claude Code trusts a worktree by its repository: run `claude` in a new clone once and accept the trust prompt before its first launch.',
             "check goes through the daemon, as its accounts, or runs here as the machine's when it isn't running. Only the worktree check writes, and it removes what it made.",
         ],
         examples: [
-            ['register the checkout you are in', 'project add .'],
+            ['conduct the repo of the checkout you are in', 'project add .'],
+            [
+                'conduct a repo by its URL, under a name of your own',
+                'project add https://github.com/owner/repo.git --name mine',
+            ],
             ['the registered projects', 'project list'],
-            ['drop the old name before adding the renamed project', 'project remove atk-old'],
-            ['check atk before conducting it', 'project check atk'],
-            ['the same without the worktree (its hook runs pnpm install)', 'project check atk --no-worktree'],
+            ['check web before conducting it', 'project check web'],
+            ['the same without the worktree (its setup runs pnpm install)', 'project check web --no-worktree'],
         ],
         group: 'Projects and workers',
         name: 'project',
         options: [
             ['--json', 'with list or check: print them as JSON'],
+            ['--name <name>', "with add: the project's name, when the repo's profile gives none or another"],
             ['--no-worktree', 'with check: skip the throwaway worktree'],
         ],
-        seeAlso: ['launch', 'ports', 'status'],
+        seeAlso: ['init', 'profile', 'launch', 'ports', 'status'],
         summary: 'register a project, or list, remove or check them',
         usage: [
-            'project add <path>',
+            'project add <url | path> [--name <name>]',
             'project list [--json]',
             'project remove <name>',
             'project check <name> [--no-worktree] [--json]',
@@ -674,9 +758,9 @@ export const COMMANDS = [
     {
         arguments: [WORKER],
         description: [
-            "Stops the worker's session and removes its worktree. It refuses while the worker's turn runs or its worktree has unfinished work (uncommitted or unpushed).",
+            "Stops the worker's session and removes its worktree. It refuses while the worker's turn runs, while it is attached (open in a tab), or while its worktree has unfinished work (uncommitted or unpushed).",
         ],
-        examples: [['retire ATK-309 once it is done', 'retire ATK-309']],
+        examples: [['retire ENG-309 once it is done', 'retire ENG-309']],
         group: 'Projects and workers',
         name: 'retire',
         options: [['--force', 'retire it anyway and throw that work away']],
@@ -689,7 +773,7 @@ export const COMMANDS = [
         description: ['The same report as conduct history, as Markdown.', 'Give a <range> or --since/--until, not both.'],
         examples: [
             ["yesterday's retro", 'retro yesterday'],
-            ['a week of atk, to a file', 'retro 7d --project atk > retro.md'],
+            ['a week of web, to a file', 'retro 7d --project web > retro.md'],
         ],
         group: 'Logs and reports',
         name: 'retro',
@@ -700,13 +784,14 @@ export const COMMANDS = [
     },
     {
         arguments: [
-            ['<item>', "the item (ATK-312), or the inbox item's id as '#12' (quoted: a shell reads #12 as a comment)"],
+            ['<item>', "the item (ENG-312), or the inbox item's id as '#12' (quoted: a shell reads #12 as a comment)"],
             ['<text>', 'what to change in the plan'],
         ],
         description: [
             'Posts "revise: <text>" on the item as you and wakes its worker. Every word after <item> is the text, quoted or not.',
+            "With no plan of the item in the inbox, it revises the item's approved plan: the conductor posts the revise, wakes its parked worker to re-plan (not once its PR has merged), and holds back the worker's next note until it does.",
         ],
-        examples: [['ask for a smaller plan', 'revise ATK-312 put the web change in a PR of its own']],
+        examples: [['ask for a smaller plan', 'revise ENG-312 put the web change in a PR of its own']],
         group: 'Inbox and approvals',
         name: 'revise',
         seeAlso: ['approve', 'inbox'],
@@ -726,7 +811,7 @@ export const COMMANDS = [
         ],
         description: [
             'The rules in force, and a dry run of them on a sample. A sample for rules test:',
-            { pre: ['{ "event": "pr.comment", "project": "atk",', '  "fields": { "wait.kind": "merge" } }'] },
+            { pre: ['{ "event": "pr.comment", "project": "web",', '  "fields": { "wait.kind": "merge" } }'] },
         ],
         examples: [
             ['the rules in force', 'rules'],
@@ -744,14 +829,24 @@ export const COMMANDS = [
         description: [
             "One look at a merge's runs: on Azure Pipelines for the project's Azure DevOps repo (the pipelines whose YAML trigger the merge fires, read in this worktree), on GitHub Actions for a GitHub repo (the runs the merge's push started). The outcome is succeeded, failed, cancelled, waiting-for-approval, missing, none (nothing ran: at once on Azure Pipelines, after 5 minutes on GitHub) or waiting (look again, or conduct wait merge).",
             "Each failed run comes with its failed tasks and the end of its log (logs). For the project's repo, each of the profile's releases whose run succeeded gives what it staged (stages): package, version, stageId, the npm stage approve line, and whether npm has it (published).",
-            "On Azure Pipelines a cancelled run (a newer push's batch, or a person) gives way to a later run on the base whose commit contains the merge: that run is the merge's, with supersedes naming the cancelled one. So cancelled means no newer run carries the merge, and the note gives the --requeue line.",
-            "--requeue <pipeline> queues that pipeline again on the base at its tip, for the item's own merge (its branch's PR merged as <sha>) when its run was cancelled and no newer run carries it; it refuses a run that is waiting, running, succeeded or failed, a pipeline the merge didn't trigger, a merge under 15 minutes old (Azure DevOps can still list a newer run), and GitHub. By the daemon for the worker that owns this checkout, else here. conduct wait merge <sha> then follows the new run.",
+            "On Azure Pipelines a cancelled run (a newer push's batch, or a person) gives way to a later run on the base whose commit contains the merge: that run is the merge's, with supersedes naming the cancelled one (or the failed one, for a run queued again for a failure: retryOf). So cancelled means no newer run carries the merge, and the note gives the --requeue line.",
+            "A batched pipeline (batch: true) holds the merge's push while its run on the base still goes, so a merge with no run yet waits as long as that run does and 2 minutes after (behind names it), not 15 minutes. Missing means no run, and none ahead of its batch, 15 minutes after the merge; the note gives the --requeue line.",
+            "--requeue <pipeline> queues that pipeline on the base at its tip, for the item's own merge (its branch's PR merged as <sha>) when its run was cancelled and no newer run carries it, when it failed, or when it is missing; it refuses a run that is waiting, running or succeeded, a batch still behind a run, a pipeline the merge didn't trigger, a cancelled or missing run under 15 minutes after the merge (Azure DevOps can still list a newer run). By the daemon for the worker that owns this checkout, else here. conduct wait merge <sha> then follows the new run.",
+            "On GitHub Actions (the project's repo, or one the item checked out under .scratch/repos, with --repo) --requeue re-runs the merge's run itself, at its own commit: the failed jobs of a failed run, all of a cancelled one. The run keeps its id, and conduct wait merge <sha> --repo <repo> follows its new attempt. It re-runs a run once (GitHub's run_attempt above 1 is refused), only while the run is its workflow's newest run on the base the PR merged into, of any event (re-running an older one would build an older commit after a newer one), and never a missing run, which has nothing to re-run.",
+            "A failed run is queued again once, for a flake its log shows that no change caused (a timeout in a test nothing touched, an agent or network error; not another merge's real failure); the note gives the line. A run queued by hand after the failed one stands in for it and names it (retryOf), so a second --requeue, of a run queued again that failed too, is refused. A newer push's run never stands in for a failed one.",
+            "--grep <pattern> searches every task log of the --for pipelines' runs, whatever their result, for a JavaScript regular expression (case-sensitive). grep.runs gives, for each run, the matching lines by stage and task (matches, at most 200 a task) and every task it searched with its line count (searched), so no match shows the run never printed it. A pipeline with no run, a run not finished or waiting on an approval, and a log that can't be read each say so in a note.",
             'Prints JSON. A read, so it runs here, except with --requeue.',
         ],
         examples: [
             ['the runs of the merge a1b2c3d', 'runs a1b2c3d'],
             ['its API deploy alone', 'runs a1b2c3d --for deploy-api'],
+            ['what its API deploy printed about deploying', 'runs a1b2c3d --for deploy-api --grep Deploying'],
             ['queue its cancelled conductor release again', 'runs a1b2c3d --requeue release-conductor'],
+            ['queue its CLI release again once, after a flaky test failed it', 'runs a1b2c3d --requeue release-cli'],
+            [
+                "re-run the registry merge's failed Build Registry once",
+                'runs 9ad075d --requeue build-registry --repo github:contoso/skills-registry',
+            ],
         ],
         exitCodes: [[1, 'refused or failed'], LOST_LOGIN],
         group: 'Used by work skills',
@@ -765,12 +860,20 @@ export const COMMANDS = [
                 '--repo <repo>',
                 "github:<owner>/<repo> for another repo, such as the registry; the profile's code host by default",
             ],
-            ['--requeue <pipeline>', "queue the merge's cancelled run of this pipeline again (Azure Pipelines)"],
+            ['--grep <pattern>', "with --for: the lines of those runs' logs that match, by task, whatever the run's result"],
+            [
+                '--requeue <pipeline>',
+                "queue the merge's cancelled, failed (once) or missing run of this pipeline; on GitHub Actions, re-run its failed or cancelled run once",
+            ],
             ['--item <KEY-n>', "with --requeue: the item whose merge it is, when the worktree's name has no key"],
         ],
-        seeAlso: ['wait', 'land'],
+        seeAlso: ['wait', 'land', 'timeline'],
         summary: "a merge's runs, their verdict, failed logs and npm stages",
-        usage: ['runs <sha> [--for <pipeline>[,<pipeline>…]] [--repo <repo>]', 'runs <sha> --requeue <pipeline>'],
+        usage: [
+            'runs <sha> [--for <pipeline>[,<pipeline>…]] [--repo <repo>]',
+            'runs <sha> --for <pipeline>[,<pipeline>…] --grep <pattern> [--repo <repo>]',
+            'runs <sha> --requeue <pipeline> [--repo <repo>]',
+        ],
     },
     {
         arguments: [['<terms…>', 'the words to look for; an item matches only with every one']],
@@ -798,7 +901,7 @@ export const COMMANDS = [
     },
     {
         description: [
-            'Starts the logon task when it runs this build, else a detached conduct supervise --fail-fast, and waits until the daemon answers. Does nothing when one runs already.',
+            "Starts the logon startup (install-startup's task, agent or unit) when it runs this build, else a detached conduct supervise --fail-fast, and waits until the daemon answers. Does nothing when one runs already.",
         ],
         examples: [['start the daemon', 'start']],
         group: 'Daemon',
@@ -814,7 +917,7 @@ export const COMMANDS = [
         ],
         examples: [
             ['where this worktree stands', 'state'],
-            ['the registry checkout alone', 'state --repo EmergentSoftware/agentic-toolkit-registry'],
+            ['the registry checkout alone', 'state --repo contoso/skills-registry'],
         ],
         exitCodes: [LOST_LOGIN],
         group: 'Used by work skills',
@@ -849,9 +952,9 @@ export const COMMANDS = [
     },
     {
         description: [
-            'Runs conduct serve and starts it again when it dies (a crash, a kill, a start that fails), after 1 s, 5 s, 15 s, 30 s, then every minute, and every 5 minutes once it has pushed. A daemon down 2 minutes sends one Pushover push, held through quiet hours. A stop (conduct stop, upgrade, Ctrl+C), or another daemon holding the lock, ends it. The logon task runs it.',
+            'Runs conduct serve and starts it again when it dies (a crash, a kill, a start that fails), after 1 s, 5 s, 15 s, 30 s, then every minute, and every 5 minutes once it has pushed. A daemon down 2 minutes sends one Pushover push, held through quiet hours. A stop (conduct stop, upgrade, Ctrl+C), or another daemon holding the lock, ends it. The logon startup (install-startup) runs it.',
         ],
-        examples: [['what the logon task runs', 'supervise']],
+        examples: [['what the logon startup runs', 'supervise']],
         group: 'Daemon',
         name: 'supervise',
         options: [['--fail-fast', 'end when the first serve exits before it comes up, as conduct start runs it']],
@@ -859,6 +962,49 @@ export const COMMANDS = [
         summary: 'run the daemon and restart it when it dies',
         usage: ['supervise [--fail-fast]'],
     },
+    {
+        arguments: [['<run>', 'a run id (an Azure Pipelines build, a GitHub Actions run)']],
+        description: [
+            "A run's tasks and when each ran: on Azure Pipelines each timeline task under its stage and job, on GitHub Actions each step under its job, in the order they started, with started, finished and seconds (null until a task has both times), and the host's own state and result. The run itself has the same times.",
+            "--for <pipeline> reads the last finished runs of one pipeline on a branch instead (the profile's base by default, 3 runs, at most 20), newest first, so a step can be measured across runs without their merge commits.",
+            "--task <regex> keeps the tasks whose name matches (a JavaScript regular expression, not case-sensitive), so Cache Next build also matches its Post-job: Cache Next build save. --grep <regex> (case-sensitive, with --task) gives those tasks' log lines that match, as runs --grep does: the matches by task (at most 200 a task) and every task it searched with its line count. A run not finished, a --task that matches nothing (it lists the run's tasks) and a log that can't be read each say so in a note.",
+            'Prints JSON. A read, so it runs here.',
+        ],
+        examples: [
+            ['every task of build 8123 and how long it took', 'timeline 8123'],
+            [
+                'the Next cache and export steps of the last 3 web deploys on develop, with what they printed',
+                'timeline --for deploy-web --task "Cache Next build|Static export build" --grep "Cache restored|cache miss|Compiled successfully"',
+            ],
+            [
+                "the registry's last 5 Build Registry runs on main",
+                'timeline --for build-registry --branch main --count 5 --repo github:contoso/skills-registry',
+            ],
+        ],
+        exitCodes: [[1, 'refused or failed'], LOST_LOGIN],
+        group: 'Used by work skills',
+        name: 'timeline',
+        options: [
+            [
+                '--for <pipeline>',
+                'one pipeline (YAML file name such as deploy-web, its path, or its name): its last finished runs',
+            ],
+            ['--branch <branch>', "with --for: the runs on this branch; the profile's base by default"],
+            ['--count <n>', 'with --for: how many runs, 1 to 20; 3 by default'],
+            ['--task <regex>', 'only the tasks whose name matches, not case-sensitive'],
+            ['--grep <regex>', "with --task: those tasks' log lines that match"],
+            [
+                '--repo <repo>',
+                "github:<owner>/<repo> for another repo, such as the registry; the profile's code host by default",
+            ],
+        ],
+        seeAlso: ['runs'],
+        summary: "a run's tasks and their times; a pipeline's last runs",
+        usage: [
+            'timeline <run> [--task <regex>] [--grep <regex>] [--repo <repo>]',
+            'timeline --for <pipeline> [--branch <branch>] [--count <n>] [--task <regex>] [--grep <regex>] [--repo <repo>]',
+        ],
+    },
     {
         arguments: [['<project>', "a registered project; without it, the checkout you're in"]],
         description: [
@@ -867,7 +1013,7 @@ export const COMMANDS = [
         ],
         examples: [
             ['what a train would take and leave out', 'train --dry-run'],
-            ["merge atk's waiting publishes", 'train atk'],
+            ["merge web's waiting publishes", 'train web'],
         ],
         group: 'Projects and workers',
         name: 'train',
@@ -883,7 +1029,7 @@ export const COMMANDS = [
         ],
         examples: [
             ['launch again everywhere', 'unpause'],
-            ['launch again in atk', 'unpause atk'],
+            ['launch again in web', 'unpause web'],
         ],
         group: 'Scheduling',
         name: 'unpause',
@@ -940,7 +1086,7 @@ export const COMMANDS = [
                 "the project's login to the provider works again (projects.<name> in config.json says which account)",
             ],
             ['time <when>', 'such as 17:00 (the next one) or 2026-10-10T09:00 (local)'],
-            ['<full form>', 'such as pr:ado:Emergent.AgenticToolkit#1850:merged'],
+            ['<full form>', 'such as pr:ado:Contoso.Web#1850:merged'],
         ],
         description: [
             "In a worker's worktree with the daemon running, registers the wait and exits 0 at once: end the turn, and the daemon resumes the session when the condition holds. Otherwise checks it here and blocks until it holds or --timeout passes.",
@@ -950,7 +1096,7 @@ export const COMMANDS = [
             ['wait for PR 1850 to merge', 'wait pr 1850 merged'],
             ["wait on PR 1850's merge, checks and comments at once", 'wait pr 1850 merged checks comment'],
             ['wait for the plan approval', 'wait approval'],
-            ['wait for a dev release on npm', 'wait npm 8.7.0-dev.8 --tag dev --package @detergent-software/atk'],
+            ['wait for a dev release on npm', 'wait npm 8.7.0-dev.8 --tag dev --package @contoso/cli'],
         ],
         exitCodes: [
             [0, 'the condition holds, or the daemon registered the wait'],
@@ -979,12 +1125,12 @@ export const COMMANDS = [
         usage: ['wait <condition> [--local] [--timeout <minutes>] [--worker <worker>] [--item <item>]'],
     },
     {
-        arguments: [['<event id | item>', 'an event id (4200) or an item (ATK-312)']],
+        arguments: [['<event id | item>', 'an event id (4200) or an item (ENG-312)']],
         description: [
             "With an event id, that event's rule and the events that led to it; with an item, the same for each of its newest actions.",
         ],
         examples: [
-            ['why the conductor acted on ATK-312', 'why ATK-312'],
+            ['why the conductor acted on ENG-312', 'why ENG-312'],
             ['the rule behind event 4200', 'why 4200'],
         ],
         group: 'Console and rules',
@@ -1003,7 +1149,7 @@ const HELP_ROWS = [
 ];
 const FOOTER = [
     'Run conduct help <command> for its options and examples.',
-    'A <worker> is its item (ATK-309) or its name (probe-ATK-309).',
+    'A <worker> is its item (ENG-309) or its name (probe-ENG-309).',
     'Files live in ~/.conductor (CONDUCTOR_HOME overrides it).',
 ];
 // A placeholder, `conduct <command>`, or a flag: what prose styles.