@clipboard-health/groundcrew 4.27.0 → 4.28.0

package/README.md

@@ -1,8 +1,5 @@
 <p align="center">
-  <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="./static/groundcrew-wordmark-dark.svg">
-    <img alt="groundcrew" src="./static/groundcrew-wordmark-light.svg" height="96">
-  </picture>
+  <img alt="groundcrew" src="./static/groundcrew-wordmark.svg" height="96">
 </p>
 
 <p align="center">
@@ -10,10 +7,10 @@
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@clipboard-health/groundcrew"><img alt="npm" src="https://img.shields.io/npm/v/@clipboard-health/groundcrew?style=flat-square&label=npm&color=FF6D00&labelColor=18181b"></a>
-  <a href="https://www.npmjs.com/package/@clipboard-health/groundcrew"><img alt="downloads" src="https://img.shields.io/npm/dw/@clipboard-health/groundcrew?style=flat-square&label=downloads&color=18181b&labelColor=18181b"></a>
-  <a href="https://github.com/ClipboardHealth/groundcrew/actions/workflows/ci.yml"><img alt="ci" src="https://img.shields.io/github/actions/workflow/status/ClipboardHealth/groundcrew/ci.yml?style=flat-square&label=ci&color=77d94e&labelColor=18181b"></a>
-  <a href="./LICENSE"><img alt="license" src="https://img.shields.io/npm/l/@clipboard-health/groundcrew?style=flat-square&label=license&color=18181b&labelColor=18181b"></a>
+  <a href="https://www.npmjs.com/package/@clipboard-health/groundcrew"><img alt="npm" src="https://img.shields.io/npm/v/@clipboard-health/groundcrew?style=flat-square&label=npm&color=F7C600&labelColor=111111"></a>
+  <a href="https://www.npmjs.com/package/@clipboard-health/groundcrew"><img alt="downloads" src="https://img.shields.io/npm/dw/@clipboard-health/groundcrew?style=flat-square&label=downloads&color=111111&labelColor=111111"></a>
+  <a href="https://github.com/ClipboardHealth/groundcrew/actions/workflows/ci.yml"><img alt="ci" src="https://img.shields.io/github/actions/workflow/status/ClipboardHealth/groundcrew/ci.yml?style=flat-square&label=ci&color=77d94e&labelColor=111111"></a>
+  <a href="./LICENSE"><img alt="license" src="https://img.shields.io/npm/l/@clipboard-health/groundcrew?style=flat-square&label=license&color=111111&labelColor=111111"></a>
 </p>
 
 <p align="center">
@@ -49,7 +46,7 @@ npm install -g @clipboard-health/groundcrew@latest
 
 # 2. Scaffold a global config. Agents are sandboxed by default
 #    (Safehouse/Docker Sandboxes); add --runner none to run unsandboxed on the host.
-crew init --global --project-dir ~/dev --repo OWNER/REPO --model claude
+crew init --global --project-dir ~/dev --repo OWNER/REPO --agent claude
 
 # 3. Run the clone commands printed by `crew init`.
 
@@ -64,7 +61,7 @@ crew doctor
 crew run --watch
 ```
 
-`crew init --global` writes config to `${XDG_CONFIG_HOME:-$HOME/.config}/groundcrew/`. Pass `--repo` more than once for multiple repos. `--model claude` or `--model codex` chooses the single built-in model preset to enable in the generated config.
+`crew init --global` writes config to `${XDG_CONFIG_HOME:-$HOME/.config}/groundcrew/`. Pass `--repo` more than once for multiple repos. `--agent claude` or `--agent codex` chooses the single built-in agent preset to enable in the generated config.
 
 ## Task Pickup
 
@@ -72,8 +69,8 @@ crew run --watch
 
 Linear works out of the box: assign tasks to yourself and add an `agent-*` label.
 
-- `agent-claude`, `agent-codex`, or `agent-<name>` routes to that model.
-- `agent-any` routes to the enabled model with the most session headroom, after skipping models over their session limit or weekly paced budget.
+- `agent-claude`, `agent-codex`, or `agent-<name>` routes to that agent.
+- `agent-any` routes to the enabled agent with the most session headroom, after skipping agents over their session limit or weekly paced budget.
 - Tasks without an `agent-*` label are ignored by `crew run`; dispatch one manually with `crew start <TASK>`.
 
 Groundcrew scans `workspace.knownRepositories` to infer which repo a task belongs to.
@@ -91,17 +88,19 @@ Write tasks as complete agent instructions: the goal, the context and constraint
 ```bash
 crew init [--global | --local] [--force] [--dry-run]     # create a crew.config.ts
           [--project-dir <dir>] [--repo <repo>]...
-          [--runner <auto|safehouse|sdx|none>] [--model <claude|codex>]
+          [--runner <auto|safehouse|sdx|none>] [--agent <claude|codex>]
 crew doctor                                              # check setup
+crew source list|verify [<source>]                       # inspect configured task sources
 crew task list [--source <name>]                         # list tasks across sources
 crew task get <TASK> [--source <name>] [--prompt]        # inspect one task or its prompt
 crew task create "Title" --source <name> [--agent <name>] # create a source task
+crew task validate [<source>]                            # validate task content
 crew status [<TASK>]                                   # inspect current state or one task
 crew run [--watch]                                       # one-shot or --watch forever
 crew start <TASK>                                      # provision + launch one task now
 crew stop <TASK> [--reason <text>]                     # stop workspace, keep worktree
 crew resume <TASK>                                     # reopen a paused task
-crew cleanup <TASK>                                    # tear down every worktree for a task
+crew cleanup [--force] <TASK>                          # tear down every worktree for a task
 crew upgrade [<version>]                                 # reinstall crew globally through npm
 ```
 
@@ -109,7 +108,7 @@ See [command details](./docs/commands.md) for status output, doctor behavior, an
 
 ## Configuration
 
-Workspace settings and at least one enabled model are required; everything else has a default.
+Workspace settings and at least one enabled agent are required; everything else has a default.
 
 ```ts
 import type { Config } from "@clipboard-health/groundcrew";
@@ -122,7 +121,7 @@ export default {
     // Strings live under projectDir; use { name, projectDirOverride } to override per repo.
     knownRepositories: ["OWNER/REPO"],
   },
-  models: {
+  agents: {
     default: "claude",
     definitions: {
       claude: {},
@@ -173,6 +172,13 @@ Regenerate the README demo with VHS:
 ./static/render-demo.sh
 ```
 
+Regenerate the Slack bot avatar (also used as the emoji upload; Slack scales it down) after editing the mark:
+
+```bash
+sed 's/width="120" height="120"/width="512" height="512"/' static/groundcrew-mark.svg > /tmp/mark512.svg
+sips -s format png /tmp/mark512.svg --out static/groundcrew-avatar.png
+```
+
 ## License
 
 [MIT](./LICENSE)

package/crew.config.example.ts

@@ -27,9 +27,9 @@ export default {
     //   { name: "other-org/other-repo", projectDirOverride: "~/work" }
     knownRepositories: ["your-org/your-repo"],
   },
-  models: {
+  agents: {
     default: "claude",
-    // `definitions` is the enabled model set. Built-in keys can use `{}` to
+    // `definitions` is the enabled agent set. Built-in keys can use `{}` to
     // opt into the shipped command/color/usage preset. Add `codex: {}` if you
     // want both shipped agents, or add a custom entry and tag tasks with
     // `agent-<name>`.
@@ -99,7 +99,7 @@ export default {
   //   // it into the agent. Chain with `&&` so a failed mint aborts launch.
   //   preLaunch: "SESSION_TOKEN=$(your-mint-command) && export SESSION_TOKEN",
   //   preLaunchEnv: ["SESSION_TOKEN"],
-  //   // Required for this model when `local.runner` resolves to `sdx`.
+  //   // Required for this agent when `local.runner` resolves to `sdx`.
   //   sandbox: { agent: "claude" },
   // },
   //
@@ -110,7 +110,7 @@ export default {
   // local: { runner: "auto" },
   //
   // // Groundcrew does not create or authenticate sdx sandboxes. For an sdx
-  // // model, create the matching sandbox yourself before first launch:
+  // // agent, create the matching sandbox yourself before first launch:
   // //   sbx create --name groundcrew-claude claude ~/dev/groundcrew
   // //   sbx exec -it groundcrew-claude claude auth login
   // //   sbx exec -it groundcrew-claude gh auth login

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/groundcrew",
-  "version": "4.27.0",
+  "version": "4.28.0",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",
@@ -82,7 +82,7 @@
     "@tsconfig/node24": "24.0.4",
     "@tsconfig/strictest": "2.0.8",
     "@types/node": "25.9.2",
-    "@typescript/native-preview": "7.0.0-dev.20260604.1",
+    "@typescript/native-preview": "7.0.0-dev.20260606.1",
     "@vitest/coverage-v8": "4.1.8",
     "cspell": "10.0.1",
     "dependency-cruiser": "17.4.3",

package/static/groundcrew-mark.svg

@@ -2,28 +2,25 @@
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 120 120" width="120" height="120" role="img" aria-label="groundcrew">
   <title>groundcrew</title>
   <!--
-    Crossed marshaling wands. Handles at bottom (18,108) and (102,108),
-    cross at (60,50), tips at (88,11) and (32,11).
-    SMIL animation: wands alternate dimming, 2.4s cycle.
-    Right wand offset by -1.2s so both open fully opaque.
+    Taxiway sign tile: yellow field, inset inscription border, fork arrow.
+    One task stream splitting onto parallel worktrees.
+    Field #F7C600, ink #111111. Fork stem (22,60) to (48,60), branches to
+    (92.2,29) and (92.2,91) with chevron heads. Stroke 11, round caps/joins.
+    At 16px (favicon), drop the inscription border and bump the fork stroke
+    to 16.
+
+    Regenerate groundcrew-avatar.png (Slack bot avatar; also fine as the
+    emoji upload; Slack scales it down) with the sips commands in the
+    README's Development section. The exact command can't live here: it
+    needs a double-hyphen flag, which is illegal inside an XML comment.
   -->
-  <line x1="18" y1="108" x2="88" y2="11" stroke="#FF6D00" stroke-width="20" stroke-linecap="round">
-    <animate attributeName="opacity"
-      values="1;0.38;1;1"
-      keyTimes="0;0.25;0.5;1"
-      calcMode="spline"
-      keySplines="0.42 0 0.58 1;0.42 0 0.58 1;0 0 1 1"
-      dur="2.4s"
-      repeatCount="indefinite"/>
-  </line>
-  <line x1="102" y1="108" x2="32" y2="11" stroke="#FF6D00" stroke-width="20" stroke-linecap="round">
-    <animate attributeName="opacity"
-      values="1;0.38;1;1"
-      keyTimes="0;0.25;0.5;1"
-      calcMode="spline"
-      keySplines="0.42 0 0.58 1;0.42 0 0.58 1;0 0 1 1"
-      dur="2.4s"
-      begin="-1.2s"
-      repeatCount="indefinite"/>
-  </line>
+  <!-- rounded rectangles as explicit paths: the macOS renderers (sips and
+       qlmanage) that cut the PNG avatar mishandle rx on rect -->
+  <path d="M24 0 H96 A24 24 0 0 1 120 24 V96 A24 24 0 0 1 96 120 H24 A24 24 0 0 1 0 96 V24 A24 24 0 0 1 24 0 Z" fill="#F7C600"/>
+  <path d="M21 9 H99 A12 12 0 0 1 111 21 V99 A12 12 0 0 1 99 111 H21 A12 12 0 0 1 9 99 V21 A12 12 0 0 1 21 9 Z" fill="none" stroke="#111111" stroke-width="6"/>
+  <path
+    d="M22 60 H48
+       M48 60 L92.2 29 M75.3 27.5 L92.2 29 L87.8 45.4
+       M48 60 L92.2 91 M75.3 92.5 L92.2 91 L87.8 74.6"
+    fill="none" stroke="#111111" stroke-width="11" stroke-linecap="round" stroke-linejoin="round"/>
 </svg>

package/static/groundcrew-wordmark.svg

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 730 128" width="730" height="128" role="img" aria-label="groundcrew">
+  <title>groundcrew</title>
+  <style>
+    .wordmark {
+      font-family: Overpass, "Helvetica Neue", Helvetica, Arial, sans-serif;
+      font-size: 68px;
+      font-weight: 800;
+    }
+  </style>
+  <!--
+    Airport taxiway sign lockup, self-contained on light and dark pages.
+    Location panel (yellow-on-black, flush inscription border) names the
+    tool; direction panel (black-on-yellow) carries the fork arrow - one
+    task stream splitting onto parallel worktrees.
+    Field #F7C600, ink #111111. textLength normalizes the wordmark width
+    across font fallbacks.
+  -->
+  <rect width="730" height="128" rx="14" fill="#F7C600"/>
+  <path d="M570 0 H14 A14 14 0 0 0 0 14 V114 A14 14 0 0 0 14 128 H570 Z" fill="#111111"/>
+  <path d="M568 2 H14 A12 12 0 0 0 2 14 V114 A12 12 0 0 0 14 126 H568 Z" fill="none" stroke="#F7C600" stroke-width="4"/>
+  <text class="wordmark" x="285" y="89" text-anchor="middle" textLength="490" lengthAdjust="spacingAndGlyphs" fill="#F7C600">GROUNDCREW</text>
+  <g transform="translate(593,4)">
+    <path
+      d="M22 60 H48
+         M48 60 L92.2 29 M75.3 27.5 L92.2 29 L87.8 45.4
+         M48 60 L92.2 91 M75.3 92.5 L92.2 91 L87.8 74.6"
+      fill="none" stroke="#111111" stroke-width="11" stroke-linecap="round" stroke-linejoin="round"/>
+  </g>
+</svg>

package/static/groundcrew-wordmark-dark.svg

@@ -1,38 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 680 120" width="680" height="120" role="img" aria-label="groundcrew">
-  <title>groundcrew</title>
-  <style>
-    .wordmark {
-      font-family: ui-monospace, "SFMono-Regular", Menlo, Consolas, "Liberation Mono", "DejaVu Sans Mono", monospace;
-      font-size: 92px;
-      font-weight: 700;
-      letter-spacing: -0.04em;
-    }
-  </style>
-  <!--
-    Logomark: crossed marshaling wands.
-    Handles at (18,108) and (102,108), cross at (60,50), tips at (88,11) and (32,11).
-    SMIL animation: wands alternate dimming, 2.4s cycle.
-    Right wand offset by -1.2s so both open fully opaque.
-  -->
-  <line x1="18" y1="108" x2="88" y2="11" stroke="#FF6D00" stroke-width="20" stroke-linecap="round">
-    <animate attributeName="opacity"
-      values="1;0.38;1;1"
-      keyTimes="0;0.25;0.5;1"
-      calcMode="spline"
-      keySplines="0.42 0 0.58 1;0.42 0 0.58 1;0 0 1 1"
-      dur="2.4s"
-      repeatCount="indefinite"/>
-  </line>
-  <line x1="102" y1="108" x2="32" y2="11" stroke="#FF6D00" stroke-width="20" stroke-linecap="round">
-    <animate attributeName="opacity"
-      values="1;0.38;1;1"
-      keyTimes="0;0.25;0.5;1"
-      calcMode="spline"
-      keySplines="0.42 0 0.58 1;0.42 0 0.58 1;0 0 1 1"
-      dur="2.4s"
-      begin="-1.2s"
-      repeatCount="indefinite"/>
-  </line>
-  <text class="wordmark" x="136" y="92" textLength="540" lengthAdjust="spacingAndGlyphs" fill="#e4e4e7">groundcrew</text>
-</svg>

package/static/groundcrew-wordmark-light.svg

@@ -1,38 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 680 120" width="680" height="120" role="img" aria-label="groundcrew">
-  <title>groundcrew</title>
-  <style>
-    .wordmark {
-      font-family: ui-monospace, "SFMono-Regular", Menlo, Consolas, "Liberation Mono", "DejaVu Sans Mono", monospace;
-      font-size: 92px;
-      font-weight: 700;
-      letter-spacing: -0.04em;
-    }
-  </style>
-  <!--
-    Logomark: crossed marshaling wands.
-    Handles at (18,108) and (102,108), cross at (60,50), tips at (88,11) and (32,11).
-    SMIL animation: wands alternate dimming, 2.4s cycle.
-    Right wand offset by -1.2s so both open fully opaque.
-  -->
-  <line x1="18" y1="108" x2="88" y2="11" stroke="#FF6D00" stroke-width="20" stroke-linecap="round">
-    <animate attributeName="opacity"
-      values="1;0.38;1;1"
-      keyTimes="0;0.25;0.5;1"
-      calcMode="spline"
-      keySplines="0.42 0 0.58 1;0.42 0 0.58 1;0 0 1 1"
-      dur="2.4s"
-      repeatCount="indefinite"/>
-  </line>
-  <line x1="102" y1="108" x2="32" y2="11" stroke="#FF6D00" stroke-width="20" stroke-linecap="round">
-    <animate attributeName="opacity"
-      values="1;0.38;1;1"
-      keyTimes="0;0.25;0.5;1"
-      calcMode="spline"
-      keySplines="0.42 0 0.58 1;0.42 0 0.58 1;0 0 1 1"
-      dur="2.4s"
-      begin="-1.2s"
-      repeatCount="indefinite"/>
-  </line>
-  <text class="wordmark" x="136" y="92" textLength="540" lengthAdjust="spacingAndGlyphs" fill="#18181b">groundcrew</text>
-</svg>