@clipboard-health/groundcrew 4.46.3 → 4.46.5

package/clearance-allow-hosts

@@ -26,6 +26,7 @@ developers.notion.com
 linear.app
 mcp-proxy.anthropic.com
 mcp.datadoghq.com
+mcp.devin.ai
 mcp.incident.io
 mcp.linear.app
 mcp.notion.com

package/dist/index.d.ts

@@ -14,7 +14,10 @@ export { resolveAgentFor, resolveRepositoryFor, type AgentResolution, type Repos
 export { getUsageByAgent, type UsageByAgent } from "./lib/usage.ts";
 export { type Board, createBoard } from "./lib/board.ts";
 export { buildSources, buildSourcesWith } from "./lib/buildSources.ts";
-export type { AdapterContext, AdapterDefinition } from "./lib/adapterDefinition.ts";
+export type { AdapterContext, AdapterDefinition, AdapterMeta, AdapterOrigin, } from "./lib/adapterDefinition.ts";
 export { adapterRegistry, type AdapterLoader, buildRegistry, buildSourceConfigSchema, listAdapterDirectories, } from "./lib/adapters/registry.ts";
+export { listTaskSources, type TaskSourceCatalogEntry } from "./lib/adapters/catalog.ts";
+export { getTaskSourceManifest } from "./lib/adapters/shell/discovery.ts";
+export type { SourceManifest } from "./lib/adapters/shell/manifest.ts";
 export { AmbiguousTaskError, type Blocker as CanonicalBlocker, type BoardState as CanonicalBoardState, type CanonicalStatus, type GroundcrewIssue as CanonicalGroundcrewIssue, type Issue as CanonicalIssue, isGroundcrewIssue as isCanonicalGroundcrewIssue, type ParentSkip as CanonicalParentSkip, type TaskSource, } from "./lib/taskSource.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAClE,YAAY,EACV,MAAM,EACN,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,QAAQ,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,KAAK,cAAc,GACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,KAAK,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,aAAa,EACb,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,KAAK,OAAO,IAAI,gBAAgB,EAChC,KAAK,UAAU,IAAI,mBAAmB,EACtC,KAAK,eAAe,EACpB,KAAK,eAAe,IAAI,wBAAwB,EAChD,KAAK,KAAK,IAAI,cAAc,EAC5B,iBAAiB,IAAI,0BAA0B,EAC/C,KAAK,UAAU,IAAI,mBAAmB,EACtC,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAClE,YAAY,EACV,MAAM,EACN,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,QAAQ,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,KAAK,cAAc,GACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,KAAK,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,aAAa,EACb,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,YAAY,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,KAAK,OAAO,IAAI,gBAAgB,EAChC,KAAK,UAAU,IAAI,mBAAmB,EACtC,KAAK,eAAe,EACpB,KAAK,eAAe,IAAI,wBAAwB,EAChD,KAAK,KAAK,IAAI,cAAc,EAC5B,iBAAiB,IAAI,0BAA0B,EAC/C,KAAK,UAAU,IAAI,mBAAmB,EACtC,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -14,4 +14,6 @@ export { getUsageByAgent } from "./lib/usage.js";
 export { createBoard } from "./lib/board.js";
 export { buildSources, buildSourcesWith } from "./lib/buildSources.js";
 export { adapterRegistry, buildRegistry, buildSourceConfigSchema, listAdapterDirectories, } from "./lib/adapters/registry.js";
+export { listTaskSources } from "./lib/adapters/catalog.js";
+export { getTaskSourceManifest } from "./lib/adapters/shell/discovery.js";
 export { AmbiguousTaskError, isGroundcrewIssue as isCanonicalGroundcrewIssue, } from "./lib/taskSource.js";

package/dist/lib/adapterDefinition.d.ts

@@ -16,6 +16,30 @@ import type { TaskSource } from "./taskSource.ts";
 export interface AdapterContext {
     readonly globalConfig: ResolvedConfig;
 }
+/**
+ * Where an adapter came from. A superset of a manifest's `ManifestOrigin`
+ * (`package | user`, see `./adapters/shell/discovery.ts`): code adapters shipped
+ * in this package are `builtin`, discovered manifests are `package` (bundled) or
+ * `user` (installed under `~/.config/groundcrew/task-sources`).
+ */
+export type AdapterOrigin = "builtin" | "package" | "user";
+/**
+ * Descriptive metadata that lets the unified catalog (`./adapters/catalog.ts`)
+ * list every enable-by-kind source uniformly, whatever its runtime. Purely the
+ * descriptor layer; execution stays per-adapter. The generic `shell` adapter
+ * sets `template: true` so it is excluded from the catalog (it is a
+ * bring-your-own-scripts escape hatch, not an installable source).
+ */
+export interface AdapterMeta {
+    /** One-line human summary shown when enumerating installable sources. */
+    readonly description: string;
+    /** True when enabling the source needs a secret/token (e.g. an API key). */
+    readonly requiresCredentials?: boolean;
+    /** True for the generic `shell` escape hatch; excluded from the catalog. */
+    readonly template?: boolean;
+    /** Provenance of the adapter. */
+    readonly origin: AdapterOrigin;
+}
 export interface AdapterDefinition<TSchema extends z.ZodType = z.ZodType> {
     /** Discriminator value used in `SourceConfig.kind`. Must equal the directory name. */
     readonly kind: string;
@@ -23,5 +47,11 @@ export interface AdapterDefinition<TSchema extends z.ZodType = z.ZodType> {
     readonly configSchema: TSchema;
     /** Builds a TaskSource from a validated config and the shared adapter context. */
     readonly create: (config: z.infer<TSchema>, context: AdapterContext) => TaskSource;
+    /**
+     * Optional descriptive metadata for the unified source catalog. Every
+     * built-in and manifest adapter sets it; an adapter without `meta` is simply
+     * absent from `listTaskSources()`.
+     */
+    readonly meta?: AdapterMeta;
 }
 //# sourceMappingURL=adapterDefinition.d.ts.map

package/dist/lib/adapterDefinition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapterDefinition.d.ts","sourceRoot":"","sources":["../../src/lib/adapterDefinition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;CACvC;AAED,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IACtE,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,KAAK,UAAU,CAAC;CACpF"}
+{"version":3,"file":"adapterDefinition.d.ts","sourceRoot":"","sources":["../../src/lib/adapterDefinition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IACtE,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,KAAK,UAAU,CAAC;IACnF;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;CAC7B"}

package/dist/lib/adapters/catalog.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Unified task-source catalog: one descriptor list over every enable-by-kind
+ * source, built-in code adapters (`linear`, `todo-txt`) and discovered manifest
+ * sources (`jira`, ...) alike. Only the descriptive layer is unified; execution
+ * stays per-adapter (a code adapter is not reimplemented as a shell manifest).
+ *
+ * Lives above `registry.ts` and `discovery.ts` and imports the registry
+ * one-directionally, so putting `listTaskSources` here (rather than in
+ * `discovery.ts`, which `registry.ts` already imports) keeps the module graph a
+ * DAG. crew-config calls this to enumerate installable sources instead of
+ * hardcoding presets.
+ */
+import type { AdapterDefinition, AdapterOrigin } from "../adapterDefinition.ts";
+/**
+ * One row of the source catalog. `requiresCredentials` is always concrete (an
+ * adapter's optional `meta.requiresCredentials` defaults to `false`) so callers
+ * never branch on `undefined`.
+ */
+export interface TaskSourceCatalogEntry {
+    readonly name: string;
+    readonly description: string;
+    readonly origin: AdapterOrigin;
+    readonly requiresCredentials: boolean;
+}
+/**
+ * Pure projection of a merged registry into catalog rows. Adapters without
+ * `meta`, and the generic `shell` template (`meta.template`), are excluded; the
+ * template is a bring-your-own-scripts escape hatch, not an installable source.
+ */
+export declare function catalogFromRegistry(registry: Record<string, AdapterDefinition>): TaskSourceCatalogEntry[];
+/**
+ * The production catalog: awaits the merged adapter registry (code adapters plus
+ * discovered manifest sources) and projects it into catalog rows.
+ */
+export declare function listTaskSources(): Promise<TaskSourceCatalogEntry[]>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/lib/adapters/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/lib/adapters/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAIhF;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACvC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC1C,sBAAsB,EAAE,CAe1B;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAGzE"}

package/dist/lib/adapters/catalog.js

@@ -0,0 +1,42 @@
+/**
+ * Unified task-source catalog: one descriptor list over every enable-by-kind
+ * source, built-in code adapters (`linear`, `todo-txt`) and discovered manifest
+ * sources (`jira`, ...) alike. Only the descriptive layer is unified; execution
+ * stays per-adapter (a code adapter is not reimplemented as a shell manifest).
+ *
+ * Lives above `registry.ts` and `discovery.ts` and imports the registry
+ * one-directionally, so putting `listTaskSources` here (rather than in
+ * `discovery.ts`, which `registry.ts` already imports) keeps the module graph a
+ * DAG. crew-config calls this to enumerate installable sources instead of
+ * hardcoding presets.
+ */
+import { adapterRegistry } from "./registry.js";
+/**
+ * Pure projection of a merged registry into catalog rows. Adapters without
+ * `meta`, and the generic `shell` template (`meta.template`), are excluded; the
+ * template is a bring-your-own-scripts escape hatch, not an installable source.
+ */
+export function catalogFromRegistry(registry) {
+    const entries = [];
+    for (const adapter of Object.values(registry)) {
+        const { meta } = adapter;
+        if (meta === undefined || meta.template === true) {
+            continue;
+        }
+        entries.push({
+            name: adapter.kind,
+            description: meta.description,
+            origin: meta.origin,
+            requiresCredentials: meta.requiresCredentials ?? false,
+        });
+    }
+    return entries;
+}
+/**
+ * The production catalog: awaits the merged adapter registry (code adapters plus
+ * discovered manifest sources) and projects it into catalog rows.
+ */
+export async function listTaskSources() {
+    const registry = await adapterRegistry;
+    return catalogFromRegistry(registry);
+}

package/dist/lib/adapters/linear/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,QAAA,MAAM,sBAAsB,YAAI,2BAA2B,EAAE,gBAAgB,CAAU,CAAC;AAExF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,wBAAgB,mBAAmB,IAAI,oBAAoB,GAAG,SAAS,CAQtE;AAED,wBAAgB,eAAe,IAAI,YAAY,CAQ9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,YAAY,GAAG,MAAM,YAAY,CAMhF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,QAAA,MAAM,sBAAsB,YAAI,2BAA2B,EAAE,gBAAgB,CAAU,CAAC;AAExF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,wBAAgB,mBAAmB,IAAI,oBAAoB,GAAG,SAAS,CAatE;AAED,wBAAgB,eAAe,IAAI,YAAY,CAQ9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,YAAY,GAAG,MAAM,YAAY,CAMhF"}

package/dist/lib/adapters/linear/client.js

@@ -4,9 +4,14 @@ const LINEAR_API_KEY_SOURCES = ["GROUNDCREW_LINEAR_API_KEY", "LINEAR_API_KEY"];
 export function resolveLinearApiKey() {
     for (const source of LINEAR_API_KEY_SOURCES) {
         const value = readEnvironmentVariable(source);
-        if (value !== undefined && value.length > 0) {
-            return { value, source };
+        /* v8 ignore next */
+        if (value === undefined) {
+            continue;
         }
+        if (value.length === 0) {
+            continue;
+        }
+        return { value, source };
     }
     return undefined;
 }

package/dist/lib/adapters/linear/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExD,QAAA,MAAM,UAAU,EAAE,iBAAiB,CAAC,OAAO,yBAAyB,CAInE,CAAC;eAEa,UAAU;AAEzB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExD,QAAA,MAAM,UAAU,EAAE,iBAAiB,CAAC,OAAO,yBAAyB,CAUnE,CAAC;eAEa,UAAU;AAEzB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/lib/adapters/linear/index.js

@@ -4,5 +4,10 @@ const definition = {
     kind: "linear",
     configSchema: linearAdapterConfigSchema,
     create: createLinearTaskSource,
+    meta: {
+        description: "Pick up Linear issues assigned to your API key's viewer that carry an agent-* label.",
+        requiresCredentials: true,
+        origin: "builtin",
+    },
 };
 export default definition;

package/dist/lib/adapters/registry.js

@@ -69,11 +69,11 @@ export function buildSourceConfigSchema(registry) {
  */
 export function mergeManifestAdapters(codeRegistry, discovered) {
     const merged = { ...codeRegistry };
-    for (const { manifest, manifestDir } of discovered) {
+    for (const { manifest, manifestDir, origin } of discovered) {
         if (codeRegistry[manifest.name]) {
             throw new Error(`Task source "${manifest.name}" collides with the built-in "${manifest.name}" adapter. Rename the source manifest.`);
         }
-        merged[manifest.name] = manifestAdapter(manifest, manifestDir);
+        merged[manifest.name] = manifestAdapter(manifest, manifestDir, origin);
     }
     return merged;
 }

package/dist/lib/adapters/shell/discovery.d.ts

@@ -23,5 +23,17 @@ export interface DiscoveryResult {
 }
 export declare function discoverFromRoots(roots: readonly ManifestRoot[]): DiscoveryResult;
 export declare function discoverTaskSourceManifests(): DiscoveredManifest[];
+/**
+ * Look up a single discovered manifest by name (the enable-by-kind `kind`).
+ * Manifest-only: a built-in code adapter (`linear`, `todo-txt`) has no manifest,
+ * so this returns `undefined` for those kinds. Part of the public discovery API
+ * so crew-config can read a source's install-time hints (prerequisites,
+ * secrets) without re-scanning the roots itself.
+ *
+ * This reads the discovery roots fresh on each call. Prefer
+ * `discoverTaskSourceManifests()` when looking up multiple names in one flow so
+ * callers only pay the filesystem scan once.
+ */
+export declare function getTaskSourceManifest(name: string): SourceManifest | undefined;
 export {};
 //# sourceMappingURL=discovery.d.ts.map

package/dist/lib/adapters/shell/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAE1E,KAAK,cAAc,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA2BD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,eAAe,CAoCjF;AAED,wBAAgB,2BAA2B,IAAI,kBAAkB,EAAE,CASlE"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAE1E,KAAK,cAAc,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA2BD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,eAAe,CAoCjF;AAED,wBAAgB,2BAA2B,IAAI,kBAAkB,EAAE,CASlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAG9E"}

package/dist/lib/adapters/shell/discovery.js

@@ -77,3 +77,18 @@ export function discoverTaskSourceManifests() {
     }
     return manifests;
 }
+/**
+ * Look up a single discovered manifest by name (the enable-by-kind `kind`).
+ * Manifest-only: a built-in code adapter (`linear`, `todo-txt`) has no manifest,
+ * so this returns `undefined` for those kinds. Part of the public discovery API
+ * so crew-config can read a source's install-time hints (prerequisites,
+ * secrets) without re-scanning the roots itself.
+ *
+ * This reads the discovery roots fresh on each call. Prefer
+ * `discoverTaskSourceManifests()` when looking up multiple names in one flow so
+ * callers only pay the filesystem scan once.
+ */
+export function getTaskSourceManifest(name) {
+    return discoverTaskSourceManifests().find((discovered) => discovered.manifest.name === name)
+        ?.manifest;
+}

package/dist/lib/adapters/shell/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,QAAA,MAAM,UAAU,EAAE,iBAAiB,CAAC,OAAO,wBAAwB,CAIlE,CAAC;eAEa,UAAU"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,QAAA,MAAM,UAAU,EAAE,iBAAiB,CAAC,OAAO,wBAAwB,CAUlE,CAAC;eAEa,UAAU"}

package/dist/lib/adapters/shell/index.js

@@ -4,5 +4,11 @@ const definition = {
     kind: "shell",
     configSchema: shellAdapterConfigSchema,
     create: createShellTaskSource,
+    meta: {
+        description: "Bring-your-own task source wired through shell command templates.",
+        // The generic escape hatch, not an installable source: excluded from the catalog.
+        template: true,
+        origin: "builtin",
+    },
 };
 export default definition;

package/dist/lib/adapters/shell/manifest.d.ts

@@ -34,7 +34,11 @@ export declare const sourceManifestSchema: z.ZodObject<{
     files: z.ZodDefault<z.ZodArray<z.ZodString>>;
     prerequisites: z.ZodOptional<z.ZodArray<z.ZodObject<{
         bin: z.ZodString;
-        install: z.ZodOptional<z.ZodString>;
+        install: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            darwin: z.ZodOptional<z.ZodString>;
+            linux: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>;
         setup: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>>;
     secrets: z.ZodOptional<z.ZodArray<z.ZodObject<{

package/dist/lib/adapters/shell/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;kBASjC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAa/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2CxB;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;kBASjC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAa/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/lib/adapters/shell/manifest.js

@@ -12,9 +12,25 @@
  * bridges the two once the scripts are materialized.
  */
 import { z } from "zod";
+/**
+ * A prerequisite's install hint. A plain string applies to every platform; an
+ * object keys hints by Node's `process.platform` value (`darwin`, `linux`) so a
+ * consumer can index by platform directly, with `default` as the fallback for
+ * platforms without an explicit entry. Only crew-config reads this field, so the
+ * per-OS shape stays JSON-serializable and an older crew-config that expects a
+ * string simply shows no hint for the object form (a graceful degradation).
+ */
+const installSchema = z.union([
+    z.string(),
+    z.strictObject({
+        darwin: z.string().optional(),
+        linux: z.string().optional(),
+        default: z.string().optional(),
+    }),
+]);
 const prerequisiteSchema = z.strictObject({
     bin: z.string().min(1),
-    install: z.string().optional(),
+    install: installSchema.optional(),
     setup: z.string().optional(),
 });
 const secretSchema = z.strictObject({

package/dist/lib/adapters/shell/manifestAdapter.d.ts

@@ -7,7 +7,7 @@
  * adapter. `create` materializes the scripts (idempotent) before building the
  * TaskSource, so enabling a source is also what installs it.
  */
-import type { AdapterDefinition } from "../../adapterDefinition.ts";
+import type { AdapterDefinition, AdapterMeta, AdapterOrigin } from "../../adapterDefinition.ts";
 import { type SourceManifest } from "./manifest.ts";
 import type { ShellAdapterConfig } from "./schema.ts";
 export interface ManifestOverrides {
@@ -16,5 +16,11 @@ export interface ManifestOverrides {
     timeouts?: ShellAdapterConfig["timeouts"] | undefined;
 }
 export declare function shellConfigFromManifest(manifest: SourceManifest, overrides?: ManifestOverrides): ShellAdapterConfig;
-export declare function manifestAdapter(manifest: SourceManifest, manifestDir: string): AdapterDefinition;
+/**
+ * Descriptive metadata for the unified catalog, derived from the manifest. A
+ * source `requiresCredentials` when it declares any `secrets`; `origin` is where
+ * discovery found it (bundled `package` vs. user-installed `user`).
+ */
+export declare function manifestMeta(manifest: SourceManifest, origin: AdapterOrigin): AdapterMeta;
+export declare function manifestAdapter(manifest: SourceManifest, manifestDir: string, origin: AdapterOrigin): AdapterDefinition;
 //# sourceMappingURL=manifestAdapter.d.ts.map

package/dist/lib/adapters/shell/manifestAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifestAdapter.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/manifestAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAKpF,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;CACvD;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,cAAc,EACxB,SAAS,GAAE,iBAAsB,GAChC,kBAAkB,CAUpB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,iBAAiB,CA8BhG"}
+{"version":3,"file":"manifestAdapter.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/manifestAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAEV,iBAAiB,EACjB,WAAW,EACX,aAAa,EACd,MAAM,4BAA4B,CAAC;AAKpC,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;CACvD;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,cAAc,EACxB,SAAS,GAAE,iBAAsB,GAChC,kBAAkB,CAUpB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,GAAG,WAAW,CAMzF;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,aAAa,GACpB,iBAAiB,CA+BnB"}

package/dist/lib/adapters/shell/manifestAdapter.js

@@ -22,7 +22,19 @@ export function shellConfigFromManifest(manifest, overrides = {}) {
         ...(timeouts ? { timeouts } : {}),
     };
 }
-export function manifestAdapter(manifest, manifestDir) {
+/**
+ * Descriptive metadata for the unified catalog, derived from the manifest. A
+ * source `requiresCredentials` when it declares any `secrets`; `origin` is where
+ * discovery found it (bundled `package` vs. user-installed `user`).
+ */
+export function manifestMeta(manifest, origin) {
+    return {
+        description: manifest.description,
+        requiresCredentials: (manifest.secrets?.length ?? 0) > 0,
+        origin,
+    };
+}
+export function manifestAdapter(manifest, manifestDir, origin) {
     const configSchema = z.strictObject({
         kind: z.literal(manifest.name),
         name: z
@@ -47,5 +59,6 @@ export function manifestAdapter(manifest, manifestDir) {
                 timeouts: overrides.timeouts,
             }), context);
         },
+        meta: manifestMeta(manifest, origin),
     };
 }

package/dist/lib/adapters/todo-txt/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,QAAA,MAAM,UAAU,EAAE,iBAAiB,CAAC,OAAO,0BAA0B,CAIpE,CAAC;eAEa,UAAU"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,QAAA,MAAM,UAAU,EAAE,iBAAiB,CAAC,OAAO,0BAA0B,CAQpE,CAAC;eAEa,UAAU"}

package/dist/lib/adapters/todo-txt/index.js

@@ -4,5 +4,9 @@ const definition = {
     kind: "todo-txt",
     configSchema: todoTxtAdapterConfigSchema,
     create: createTodoTxtTaskSource,
+    meta: {
+        description: "Track tasks from a local todo.txt file; no credentials required.",
+        origin: "builtin",
+    },
 };
 export default definition;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/groundcrew",
-  "version": "4.46.3",
+  "version": "4.46.5",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",
@@ -84,13 +84,13 @@
     "@tsconfig/node24": "24.0.4",
     "@tsconfig/strictest": "2.0.8",
     "@types/node": "25.9.4",
-    "@typescript/native-preview": "7.0.0-dev.20260703.1",
+    "@typescript/native-preview": "7.0.0-dev.20260705.1",
     "@vitest/coverage-v8": "4.1.9",
     "cspell": "10.0.1",
     "dependency-cruiser": "18.0.0",
     "husky": "9.1.7",
     "jscpd": "5.0.11",
-    "knip": "6.21.0",
+    "knip": "6.24.0",
     "lint-staged": "17.0.8",
     "markdownlint-cli2": "0.22.1",
     "nx": "22.7.6",
@@ -98,7 +98,7 @@
     "oxlint": "1.72.0",
     "oxlint-tsgolint": "0.23.0",
     "syncpack": "15.3.2",
-    "vite": "8.1.0",
+    "vite": "8.1.3",
     "vitest": "4.1.9"
   },
   "engines": {

package/task-sources/jira/README.md

@@ -14,8 +14,20 @@ calls with a subcommand per operation:
 
 ## Prerequisites
 
-- [`jira` CLI](https://github.com/ankitpokhrel/jira-cli) — `brew install ankitpokhrel/jira-cli/jira-cli`, then `jira init`.
-- [`jq`](https://jqlang.github.io/jq/) — `brew install jq`.
+- [`jira` CLI](https://github.com/ankitpokhrel/jira-cli), then `jira init`:
+  - macOS: `brew install ankitpokhrel/jira-cli/jira-cli`
+  - Linux (Ubuntu): `sudo snap install jira-cli && sudo snap alias jira-cli jira`
+- [`jq`](https://jqlang.github.io/jq/):
+  - macOS: `brew install jq`
+  - Linux: `sudo apt-get install jq`
+
+The Ubuntu snap ships the binary as `jira-cli`, but the `snap alias` step drops a
+`jira` symlink on PATH, so `jira` is the single canonical command name on every
+platform. That is deliberate: the manifest keeps `bin: "jira"` and
+`setup: "jira init"`, and `jira.sh` keeps invoking the `jira` command verbatim,
+so there is no per-OS binary name to plumb through. If you install the snap without aliasing,
+the `jira` prerequisite probe fails and the setup screen surfaces this install
+hint, which now includes the alias step.
 
 > **Note:** `list` and `get` detect "no results" and "not found" by matching the
 > `jira` CLI's stderr wording (it exposes no machine-readable signal for either).
@@ -74,9 +86,10 @@ the token on per invocation.
    | `groundcrew`           | `groundcrew`                       | Opts the issue in. The default JQL fetches only issues carrying this label, so work is dispatched explicitly rather than every open issue being swept up. The label name is just a JQL convention — change the `labels = …` clause in `JIRA_GROUNDCREW_JQL` to use a different one.                            |
    | `repo:<name>`          | `repo:wild-horses`                 | Sets `repository: "wild-horses"`. Use a bare repository name when your config's `knownRepositories` lists it by name — no owner needed.                                                                                                                                                                        |
    | `repo:<Owner>__<name>` | `repo:ClipboardHealth__groundcrew` | Sets `repository: "ClipboardHealth/groundcrew"`. JIRA labels cannot contain `/`, so the slash is encoded as exactly **two** underscores (`__`). Every `__` decodes to `/`, so only two-component `Owner/name` repos are supported — a repository whose owner or name itself contains `__` cannot be expressed. |
-   | `agent:<name>`         | `agent:claude`                     | **Optional** — omit it to use `JIRA_DEFAULT_AGENT` (`claude` in the sample config). Only add this label to override the default for a specific issue.                                                                                                                                                          |
+   | `agent:<name>`         | `agent:claude`                     | Sets `agent: "claude"`. Omit it only when `JIRA_DEFAULT_AGENT` is configured separately; the shipped source leaves that default empty so unlabeled issues are listed but not auto-dispatched.                                                                                                                  |
 
-   So a typical dispatchable issue carries just `groundcrew` + a `repo:` label.
+   So a typical dispatchable issue carries `groundcrew` + a `repo:` label + an
+   `agent:` label.
    An issue without a `repo:` label is listed but not dispatchable (and with no
    `agent:` label and no `JIRA_DEFAULT_AGENT`, its agent is `null`).
 
@@ -96,9 +109,9 @@ the token on per invocation.
      },
      "env": {
        "JIRA_GROUNDCREW_JQL": "labels = groundcrew AND (statusCategory != Done OR (statusCategory = Done AND updated >= -7d))",
-       "JIRA_REVIEW_PATTERN": "review",
-       "JIRA_TODO_PATTERN": "",
-       "JIRA_DEFAULT_AGENT": "claude",
+       "JIRA_REVIEW_PATTERN": "In Review",
+       "JIRA_TODO_PATTERN": "New",
+       "JIRA_DEFAULT_AGENT": "",
        "JIRA_STATE_IN_PROGRESS": "In Progress",
        "JIRA_STATE_IN_REVIEW": "In Review",
        "JIRA_STATE_DONE": "Done"
@@ -118,9 +131,9 @@ The script reads these from the source's `env` block:
 | Variable              | Default                                                                                          | Purpose                                                                                                                                                                                                                                 |
 | --------------------- | ------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `JIRA_GROUNDCREW_JQL` | `labels = groundcrew AND (statusCategory != Done OR (statusCategory = Done AND updated >= -7d))` | Which issues `list` returns, capped at the first 20 (`--paginate 0:20` in `jira.sh`). Defaults to open issues plus those done in the last 7 days (so groundcrew can clean up their worktrees). Omit `ORDER BY` (jira-cli adds its own). |
-| `JIRA_REVIEW_PATTERN` | `review`                                                                                         | Case-insensitive regex; matching In-Progress status names map to `in-review`.                                                                                                                                                           |
-| `JIRA_TODO_PATTERN`   | _(empty -> off)_                                                                                 | Case-insensitive regex; matching In-Progress status names map to `todo` so groundcrew dispatches them as new work. Set it to e.g. `acknowledged` for an "Acknowledged" triage status. Checked before `JIRA_REVIEW_PATTERN`.             |
-| `JIRA_DEFAULT_AGENT`  | _(empty -> `null`)_                                                                              | Agent used when an issue has no `agent:` label.                                                                                                                                                                                         |
+| `JIRA_REVIEW_PATTERN` | `In Review`                                                                                      | Case-insensitive regex; matching In-Progress status names map to `in-review`.                                                                                                                                                           |
+| `JIRA_TODO_PATTERN`   | `New`                                                                                            | Case-insensitive regex; matching In-Progress status names map to `todo` so groundcrew dispatches them as new work. The shipped source seeds `New`; clear the row to turn this off. Checked before `JIRA_REVIEW_PATTERN`.                |
+| `JIRA_DEFAULT_AGENT`  | _(empty -> `null`)_                                                                              | Agent used when an issue has no `agent:` label. Set it to an agent name only when every matching Jira issue should be eligible for that agent by default.                                                                               |
 | `JIRA_TOKEN_FILE`     | `~/.config/groundcrew/jira.token`                                                                | Token file path.                                                                                                                                                                                                                        |
 | `JIRA_STATE_*`        | `In Progress` / `In Review` / `Done`                                                             | Native JIRA state names used by `move`. Match your project's workflow.                                                                                                                                                                  |
 

package/task-sources/jira/source.json

@@ -7,12 +7,18 @@
   "prerequisites": [
     {
       "bin": "jira",
-      "install": "brew install ankitpokhrel/jira-cli/jira-cli",
+      "install": {
+        "darwin": "brew install ankitpokhrel/jira-cli/jira-cli",
+        "linux": "sudo snap install jira-cli && sudo snap alias jira-cli jira"
+      },
       "setup": "jira init"
     },
     {
       "bin": "jq",
-      "install": "brew install jq"
+      "install": {
+        "darwin": "brew install jq",
+        "linux": "sudo apt-get install jq"
+      }
     }
   ],
   "secrets": [
@@ -24,6 +30,10 @@
     }
   ],
   "env": {
+    "JIRA_GROUNDCREW_JQL": "labels = groundcrew AND (statusCategory != Done OR (statusCategory = Done AND updated >= -7d))",
+    "JIRA_REVIEW_PATTERN": "In Review",
+    "JIRA_TODO_PATTERN": "New",
+    "JIRA_DEFAULT_AGENT": "",
     "JIRA_STATE_IN_PROGRESS": "In Progress",
     "JIRA_STATE_IN_REVIEW": "In Review",
     "JIRA_STATE_DONE": "Done"