@clipboard-health/groundcrew 4.46.3 → 4.46.4

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,CAYtE;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,13 @@ 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 };
+        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/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.4",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",
@@ -90,7 +90,7 @@
     "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": {