@clipboard-health/groundcrew 4.44.2 → 4.45.0

package/crew.config.example.ts

@@ -104,7 +104,7 @@ export default {
   // // Linear adapter. The most common use is `kind: "shell"`, which wires
   // // any external system via command templates that emit/consume JSON.
   // // See the shell adapter's ShellIssue schema for the JSON contract
-  // // `fetch` / `resolveOne` must emit.
+  // // `listTasks` / `getTask` must emit.
   // sources: [
   //   // Optional: explicitly declare Linear only when you need custom status
   //   // names. Omitted fields keep their defaults.
@@ -121,16 +121,19 @@ export default {
   //   {
   //     kind: "shell",
   //     name: "jira",
+  //     // Install via task-sources/jira (see task-sources/jira/README.md):
+  //     //   cp task-sources/jira/jira.sh ~/.config/groundcrew/jira.sh
   //     // Open local task-store directories for read/write inside the
   //     // safehouse/srt sandbox when this source owns the launched task.
   //     sandboxWritePaths: ["~/plans"],
   //     commands: {
-  //       verify: "jira me",
-  //       fetch: "~/.config/groundcrew/jira-fetch.sh",
-  //       resolveOne: "~/.config/groundcrew/jira-resolve.sh ${id}",
-  //       markInProgress: "jira issue move ${id} 'In Progress'",
+  //       verify: "~/.config/groundcrew/jira.sh verify",
+  //       listTasks: "~/.config/groundcrew/jira.sh list",
+  //       getTask: "~/.config/groundcrew/jira.sh get ${id}",
+  //       markInProgress: "~/.config/groundcrew/jira.sh move ${id} \"$JIRA_STATE_IN_PROGRESS\"",
+  //       // Full wiring (markInReview/markDone, env, timeouts): see task-sources/jira/README.md
   //     },
-  //     timeouts: { fetch: 60_000 },
+  //     timeouts: { listTasks: 60_000 },
   //   },
   // ],
   //

package/docs/task-sources.md

@@ -25,6 +25,8 @@ export default {
 };
 ```
 
+A complete, runnable JIRA source backed by the [`jira` CLI](https://github.com/ankitpokhrel/jira-cli) ships in [`task-sources/jira/`](../task-sources/jira/README.md): a single `jira.sh` dispatcher (`verify`/`list`/`get`/`move`) that maps JIRA's REST output into the contract below, plus the config block to wire it up.
+
 `commands.listTasks` must print a JSON array of issues. `commands.getTask`, when
 set, must print one issue, print nothing for "not found", or exit `3` for "not
 found". The legacy aliases `commands.fetch` and `commands.resolveOne` still work
@@ -72,7 +74,7 @@ source's declared paths. The `sdx` runner does not mount these host paths.
 ]
 ```
 
-Allowed `status` values are `todo`, `in-progress`, `in-review`, `done`, and `other`. Omit `repository` or `agent` when a task should not be groundcrew-eligible. `hasMoreBlockers` is optional and defaults to `false`; `sourceRef` is opaque data that groundcrew passes back to your writeback command.
+Allowed `status` values are `todo`, `in-progress`, `in-review`, `done`, and `other`. In shell-script JSON output, emit both `repository` and `agent`; use `null` when a task should not be groundcrew-eligible. `hasMoreBlockers` is optional and defaults to `false`; `sourceRef` is opaque data that groundcrew passes back to your writeback command.
 
 ## Todo.txt
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/groundcrew",
-  "version": "4.44.2",
+  "version": "4.45.0",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",
@@ -89,7 +89,7 @@
     "dependency-cruiser": "17.4.3",
     "husky": "9.1.7",
     "jscpd": "5.0.9",
-    "knip": "6.15.0",
+    "knip": "6.16.1",
     "lint-staged": "17.0.7",
     "markdownlint-cli2": "0.22.1",
     "nx": "22.7.5",