@clipboard-health/groundcrew 4.46.2 → 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.d.ts

@@ -11,6 +11,7 @@
  */
 import { z } from "zod";
 import type { AdapterDefinition } from "../adapterDefinition.ts";
+import { type DiscoveredManifest } from "./shell/discovery.ts";
 export type AdapterLoader = (directoryName: string) => Promise<AdapterDefinition>;
 /**
  * Pure logic: given a list of subdirectory names and an async loader, build a
@@ -30,9 +31,18 @@ export declare function buildRegistry(directoryNames: readonly string[], loader:
  *   semantically equivalent here because each kind has a unique literal.
  */
 export declare function buildSourceConfigSchema(registry: Record<string, AdapterDefinition>): z.ZodType;
+/**
+ * Fold discovered manifest sources into a code-adapter registry. Each becomes
+ * an adapter keyed by its manifest name. A manifest may not shadow a built-in
+ * code-adapter kind (`linear`, `shell`, `todo-txt`) - those are reserved, so a
+ * collision is a hard error. Manifest-vs-manifest precedence (user over
+ * package) is already resolved by discovery, so `discovered` has no duplicates.
+ */
+export declare function mergeManifestAdapters(codeRegistry: Record<string, AdapterDefinition>, discovered: readonly DiscoveredManifest[]): Record<string, AdapterDefinition>;
 export declare function listAdapterDirectories(baseDir: string): string[];
 /**
- * Production registry. Initialised at module load by scanning `src/lib/adapters/`.
+ * Production registry. Scans `src/lib/adapters/` for code adapters, then folds
+ * in the manifest sources discovered under the package + user task-sources roots.
  */
 export declare const adapterRegistry: Promise<Record<string, AdapterDefinition>>;
 //# sourceMappingURL=registry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/lib/adapters/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,MAAM,aAAa,GAAG,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAElF;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAgB5C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,OAAO,CAa9F;AAaD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQhE;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAGtE,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/lib/adapters/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAA+B,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG5F,MAAM,MAAM,aAAa,GAAG,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAElF;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAgB5C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,OAAO,CAa9F;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAC/C,UAAU,EAAE,SAAS,kBAAkB,EAAE,GACxC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAWnC;AAaD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQhE;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAGqB,CAAC"}

package/dist/lib/adapters/registry.js

@@ -13,6 +13,8 @@ import { __rewriteRelativeImportExtension } from "tslib";
 import { readdirSync } from "node:fs";
 import path from "node:path";
 import { z } from "zod";
+import { discoverTaskSourceManifests } from "./shell/discovery.js";
+import { manifestAdapter } from "./shell/manifestAdapter.js";
 /**
  * Pure logic: given a list of subdirectory names and an async loader, build a
  * `kind → AdapterDefinition` registry. Enforces directory-name === kind and
@@ -58,6 +60,23 @@ export function buildSourceConfigSchema(registry) {
     // — semantically equivalent here because each kind has a unique literal.
     return z.union([first, second, ...rest]);
 }
+/**
+ * Fold discovered manifest sources into a code-adapter registry. Each becomes
+ * an adapter keyed by its manifest name. A manifest may not shadow a built-in
+ * code-adapter kind (`linear`, `shell`, `todo-txt`) - those are reserved, so a
+ * collision is a hard error. Manifest-vs-manifest precedence (user over
+ * package) is already resolved by discovery, so `discovered` has no duplicates.
+ */
+export function mergeManifestAdapters(codeRegistry, discovered) {
+    const merged = { ...codeRegistry };
+    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, origin);
+    }
+    return merged;
+}
 const here = import.meta.dirname;
 async function defaultImportLoader(directoryName) {
     // Resolve relative to this module's directory. tsx maps `.js` → `.ts` in dev;
@@ -77,6 +96,7 @@ export function listAdapterDirectories(baseDir) {
     return names;
 }
 /**
- * Production registry. Initialised at module load by scanning `src/lib/adapters/`.
+ * Production registry. Scans `src/lib/adapters/` for code adapters, then folds
+ * in the manifest sources discovered under the package + user task-sources roots.
  */
-export const adapterRegistry = buildRegistry(listAdapterDirectories(here), defaultImportLoader);
+export const adapterRegistry = buildRegistry(listAdapterDirectories(here), defaultImportLoader).then((codeRegistry) => mergeManifestAdapters(codeRegistry, discoverTaskSourceManifests()));

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

@@ -0,0 +1,39 @@
+/**
+ * Discover task-source manifests from two roots: the sources bundled inside
+ * this package (`<pkg>/task-sources`) and the user-installed sources under
+ * `~/.config/groundcrew/task-sources`. Each `<dir>/source.json` is validated
+ * and indexed by manifest name; a later root overrides an earlier one on a
+ * name collision (user over package), recording a warning. The registry
+ * (`../registry.ts`) turns each result into an enable-by-kind adapter.
+ */
+import { type SourceManifest } from "./manifest.ts";
+type ManifestOrigin = "package" | "user";
+export interface DiscoveredManifest {
+    manifest: SourceManifest;
+    manifestDir: string;
+    origin: ManifestOrigin;
+}
+export interface ManifestRoot {
+    dir: string;
+    origin: ManifestOrigin;
+}
+export interface DiscoveryResult {
+    manifests: DiscoveredManifest[];
+    warnings: string[];
+}
+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

@@ -0,0 +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;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAG9E"}

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

@@ -0,0 +1,94 @@
+/**
+ * Discover task-source manifests from two roots: the sources bundled inside
+ * this package (`<pkg>/task-sources`) and the user-installed sources under
+ * `~/.config/groundcrew/task-sources`. Each `<dir>/source.json` is validated
+ * and indexed by manifest name; a later root overrides an earlier one on a
+ * name collision (user over package), recording a warning. The registry
+ * (`../registry.ts`) turns each result into an enable-by-kind adapter.
+ */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { writeError } from "../../util.js";
+import { xdgConfigPath } from "../../xdg.js";
+import { describeFileError, isFileErrorCode } from "../todo-txt/fileErrors.js";
+import { sourceManifestSchema } from "./manifest.js";
+/** Sources bundled with this package, next to the built output in dev and prod. */
+const PACKAGE_TASK_SOURCES_ROOT = path.resolve(import.meta.dirname, "../../../../task-sources");
+/** Sources any external installer drops into the groundcrew config dir. */
+function userTaskSourcesRoot() {
+    return xdgConfigPath("groundcrew", "task-sources");
+}
+/**
+ * Read a root's directory entries, treating an absent or non-directory root as
+ * empty. A task-sources root is optional (a user may never install one, and it
+ * can be torn down mid-run), so "not a readable directory" yields no sources
+ * rather than crashing discovery. Any other fault (e.g. EACCES) is re-raised.
+ */
+function readRootEntries(dir) {
+    try {
+        return readdirSync(dir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (isFileErrorCode(error, "ENOENT") || isFileErrorCode(error, "ENOTDIR")) {
+            return [];
+        }
+        throw error;
+    }
+}
+export function discoverFromRoots(roots) {
+    const byName = new Map();
+    const warnings = [];
+    for (const root of roots) {
+        for (const entry of readRootEntries(root.dir)) {
+            if (!entry.isDirectory()) {
+                continue;
+            }
+            const manifestDir = path.join(root.dir, entry.name);
+            const manifestPath = path.join(manifestDir, "source.json");
+            if (!existsSync(manifestPath)) {
+                continue;
+            }
+            let manifest;
+            try {
+                manifest = sourceManifestSchema.parse(JSON.parse(readFileSync(manifestPath, "utf8")));
+            }
+            catch (error) {
+                // One malformed source.json must not take down the whole registry: skip
+                // this source and warn, so every other adapter still loads.
+                warnings.push(`Ignoring invalid task source manifest at ${manifestPath}: ${describeFileError(error)}.`);
+                continue;
+            }
+            const previous = byName.get(manifest.name);
+            if (previous) {
+                warnings.push(`Task source "${manifest.name}" from ${manifestDir} overrides the ${previous.origin} source at ${previous.manifestDir}.`);
+            }
+            byName.set(manifest.name, { manifest, manifestDir, origin: root.origin });
+        }
+    }
+    return { manifests: [...byName.values()], warnings };
+}
+export function discoverTaskSourceManifests() {
+    const { manifests, warnings } = discoverFromRoots([
+        { dir: PACKAGE_TASK_SOURCES_ROOT, origin: "package" },
+        { dir: userTaskSourcesRoot(), origin: "user" },
+    ]);
+    for (const warning of warnings) {
+        writeError(warning);
+    }
+    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/install.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Idempotent materialization of a task source's script files. Copies each
+ * `files[]` entry from the manifest's directory into `installDir` when the destination is
+ * missing or its bytes differ, then marks it executable. A manifest with no
+ * `files` installs nothing (the source is backed by a binary already on PATH).
+ * Never writes secrets - prerequisites and secrets stay the user's job.
+ */
+import type { SourceManifest } from "./manifest.ts";
+export interface InstallShellSourceOptions {
+    manifest: SourceManifest;
+    manifestDir: string;
+}
+export interface InstalledShellSource {
+    installDir: string;
+    scriptPaths: string[];
+}
+export declare function installShellSource(options: InstallShellSourceOptions): InstalledShellSource;
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/install.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,oBAAoB,CA8B3F"}

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

@@ -0,0 +1,36 @@
+/**
+ * Idempotent materialization of a task source's script files. Copies each
+ * `files[]` entry from the manifest's directory into `installDir` when the destination is
+ * missing or its bytes differ, then marks it executable. A manifest with no
+ * `files` installs nothing (the source is backed by a binary already on PATH).
+ * Never writes secrets - prerequisites and secrets stay the user's job.
+ */
+import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { expandHome } from "../../paths.js";
+export function installShellSource(options) {
+    const { manifest, manifestDir } = options;
+    const installDir = expandHome(manifest.installDir);
+    const scriptPaths = [];
+    if (manifest.files.length > 0) {
+        mkdirSync(installDir, { recursive: true });
+    }
+    for (const file of manifest.files) {
+        const source = path.join(manifestDir, file);
+        const dest = path.join(installDir, file);
+        // Reject a files[] entry that escapes installDir (e.g. "../../.zshrc").
+        // Manifests are only semi-trusted, and each dest is made executable, so a
+        // traversal would let a source write over arbitrary files.
+        const relativeDest = path.relative(installDir, dest);
+        if (relativeDest === ".." || relativeDest.startsWith(`..${path.sep}`)) {
+            throw new Error(`Task source "${manifest.name}" lists file "${file}" that escapes its install directory "${installDir}".`);
+        }
+        mkdirSync(path.dirname(dest), { recursive: true });
+        if (!existsSync(dest) || readFileSync(dest).compare(readFileSync(source)) !== 0) {
+            copyFileSync(source, dest);
+        }
+        chmodSync(dest, 0o755);
+        scriptPaths.push(dest);
+    }
+    return { installDir, scriptPaths };
+}

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

@@ -0,0 +1,69 @@
+/**
+ * `SourceManifest` describes a packaged task source's `source.json` (for
+ * example `task-sources/jira/source.json`). It is the install-time contract
+ * between whoever ships a source (groundcrew itself, or an external installer
+ * that drops a bundle into `~/.config/groundcrew/task-sources`) and groundcrew,
+ * which discovers manifests and exposes each as an enable-by-kind adapter.
+ *
+ * Deliberately separate from `ShellAdapterConfig` (the runtime config block in
+ * `./schema.ts`): the manifest carries install-only fields (`installDir`,
+ * `files`, `prerequisites`, `secrets`) and command templates whose script paths
+ * are not yet installed. `shellConfigFromManifest` (see `./manifestAdapter.ts`)
+ * bridges the two once the scripts are materialized.
+ */
+import { z } from "zod";
+/**
+ * Per-command timeouts in milliseconds. Shared with the override schema in
+ * `./manifestAdapter.ts` so a `{ kind }` entry can override manifest timeouts.
+ */
+export declare const manifestTimeoutsSchema: z.ZodObject<{
+    verify: z.ZodOptional<z.ZodNumber>;
+    listTasks: z.ZodOptional<z.ZodNumber>;
+    getTask: z.ZodOptional<z.ZodNumber>;
+    markInProgress: z.ZodOptional<z.ZodNumber>;
+    markInReview: z.ZodOptional<z.ZodNumber>;
+    markDone: z.ZodOptional<z.ZodNumber>;
+    createTask: z.ZodOptional<z.ZodNumber>;
+    validate: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const sourceManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    kind: z.ZodLiteral<"shell">;
+    description: z.ZodString;
+    installDir: z.ZodString;
+    files: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    prerequisites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        bin: z.ZodString;
+        install: z.ZodOptional<z.ZodString>;
+        setup: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    secrets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        env: z.ZodString;
+        file: z.ZodString;
+        mode: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    commands: z.ZodObject<{
+        verify: z.ZodOptional<z.ZodString>;
+        listTasks: z.ZodString;
+        getTask: z.ZodOptional<z.ZodString>;
+        markInProgress: z.ZodOptional<z.ZodString>;
+        markInReview: z.ZodOptional<z.ZodString>;
+        markDone: z.ZodOptional<z.ZodString>;
+        createTask: z.ZodOptional<z.ZodString>;
+        validate: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    timeouts: z.ZodOptional<z.ZodObject<{
+        verify: z.ZodOptional<z.ZodNumber>;
+        listTasks: z.ZodOptional<z.ZodNumber>;
+        getTask: z.ZodOptional<z.ZodNumber>;
+        markInProgress: z.ZodOptional<z.ZodNumber>;
+        markInReview: z.ZodOptional<z.ZodNumber>;
+        markDone: z.ZodOptional<z.ZodNumber>;
+        createTask: z.ZodOptional<z.ZodNumber>;
+        validate: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SourceManifest = z.infer<typeof sourceManifestSchema>;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,63 @@
+/**
+ * `SourceManifest` describes a packaged task source's `source.json` (for
+ * example `task-sources/jira/source.json`). It is the install-time contract
+ * between whoever ships a source (groundcrew itself, or an external installer
+ * that drops a bundle into `~/.config/groundcrew/task-sources`) and groundcrew,
+ * which discovers manifests and exposes each as an enable-by-kind adapter.
+ *
+ * Deliberately separate from `ShellAdapterConfig` (the runtime config block in
+ * `./schema.ts`): the manifest carries install-only fields (`installDir`,
+ * `files`, `prerequisites`, `secrets`) and command templates whose script paths
+ * are not yet installed. `shellConfigFromManifest` (see `./manifestAdapter.ts`)
+ * bridges the two once the scripts are materialized.
+ */
+import { z } from "zod";
+const prerequisiteSchema = z.strictObject({
+    bin: z.string().min(1),
+    install: z.string().optional(),
+    setup: z.string().optional(),
+});
+const secretSchema = z.strictObject({
+    env: z.string().min(1),
+    file: z.string().min(1),
+    mode: z.string().optional(),
+    url: z.string().optional(),
+});
+const commandsSchema = z.strictObject({
+    verify: z.string().optional(),
+    listTasks: z.string(),
+    getTask: z.string().optional(),
+    markInProgress: z.string().optional(),
+    markInReview: z.string().optional(),
+    markDone: z.string().optional(),
+    createTask: z.string().optional(),
+    validate: z.string().optional(),
+});
+/**
+ * Per-command timeouts in milliseconds. Shared with the override schema in
+ * `./manifestAdapter.ts` so a `{ kind }` entry can override manifest timeouts.
+ */
+export const manifestTimeoutsSchema = z.strictObject({
+    verify: z.number().int().positive().optional(),
+    listTasks: z.number().int().positive().optional(),
+    getTask: z.number().int().positive().optional(),
+    markInProgress: z.number().int().positive().optional(),
+    markInReview: z.number().int().positive().optional(),
+    markDone: z.number().int().positive().optional(),
+    createTask: z.number().int().positive().optional(),
+    validate: z.number().int().positive().optional(),
+});
+export const sourceManifestSchema = z.strictObject({
+    name: z
+        .string()
+        .regex(/^[a-z][a-z0-9-]*$/, "name must be kebab-case (lowercase letters, digits, hyphens)"),
+    kind: z.literal("shell"),
+    description: z.string(),
+    installDir: z.string().min(1),
+    files: z.array(z.string().min(1)).default([]),
+    prerequisites: z.array(prerequisiteSchema).optional(),
+    secrets: z.array(secretSchema).optional(),
+    env: z.record(z.string(), z.string()).optional(),
+    commands: commandsSchema,
+    timeouts: manifestTimeoutsSchema.optional(),
+});

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

@@ -0,0 +1,26 @@
+/**
+ * Bridges a discovered `SourceManifest` to the shell adapter runtime so a
+ * packaged/installed source is enabled with `{ kind: "<name>" }` alone. The
+ * synthetic adapter's `kind` is the manifest name; its config schema accepts
+ * light overrides (`name`, `env`, `timeouts`, `enabled`) that merge over the
+ * manifest defaults. Full command control stays with the generic `kind:"shell"`
+ * adapter. `create` materializes the scripts (idempotent) before building the
+ * TaskSource, so enabling a source is also what installs it.
+ */
+import type { AdapterDefinition, AdapterMeta, AdapterOrigin } from "../../adapterDefinition.ts";
+import { type SourceManifest } from "./manifest.ts";
+import type { ShellAdapterConfig } from "./schema.ts";
+export interface ManifestOverrides {
+    name?: string | undefined;
+    env?: Record<string, string> | undefined;
+    timeouts?: ShellAdapterConfig["timeouts"] | undefined;
+}
+export declare function shellConfigFromManifest(manifest: SourceManifest, overrides?: ManifestOverrides): ShellAdapterConfig;
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,64 @@
+/**
+ * Bridges a discovered `SourceManifest` to the shell adapter runtime so a
+ * packaged/installed source is enabled with `{ kind: "<name>" }` alone. The
+ * synthetic adapter's `kind` is the manifest name; its config schema accepts
+ * light overrides (`name`, `env`, `timeouts`, `enabled`) that merge over the
+ * manifest defaults. Full command control stays with the generic `kind:"shell"`
+ * adapter. `create` materializes the scripts (idempotent) before building the
+ * TaskSource, so enabling a source is also what installs it.
+ */
+import { z } from "zod";
+import { createShellTaskSource } from "./factory.js";
+import { installShellSource } from "./install.js";
+import { manifestTimeoutsSchema } from "./manifest.js";
+export function shellConfigFromManifest(manifest, overrides = {}) {
+    const env = { ...manifest.env, ...overrides.env };
+    const timeouts = overrides.timeouts ?? manifest.timeouts;
+    return {
+        kind: "shell",
+        name: overrides.name ?? manifest.name,
+        commands: manifest.commands,
+        ...(Object.keys(env).length > 0 ? { env } : {}),
+        ...(timeouts ? { timeouts } : {}),
+    };
+}
+/**
+ * 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
+            .string()
+            .regex(/^[a-z][a-z0-9-]*$/, "name must be kebab-case (lowercase letters, digits, hyphens)")
+            .optional(),
+        env: z.record(z.string(), z.string()).optional(),
+        timeouts: manifestTimeoutsSchema.optional(),
+        enabled: z.boolean().optional(),
+    });
+    return {
+        kind: manifest.name,
+        configSchema,
+        // `config` arrives already validated from buildSourcesWith; re-parse to
+        // recover the typed overrides without an unsafe cast. Cheap and idempotent.
+        create: (config, context) => {
+            const overrides = configSchema.parse(config);
+            installShellSource({ manifest, manifestDir });
+            return createShellTaskSource(shellConfigFromManifest(manifest, {
+                name: overrides.name,
+                env: overrides.env,
+                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/dist/lib/config.d.ts

@@ -2,13 +2,26 @@ import type { LinearAdapterConfig } from "./adapters/linear/schema.ts";
 import type { ShellAdapterConfig } from "./adapters/shell/schema.ts";
 import type { TodoTxtAdapterConfig } from "./adapters/todo-txt/schema.ts";
 export { BUILD_SECRET_NAMES } from "./buildSecrets.ts";
+/**
+ * Authoring shape for a manifest-backed (discovered) task source: enable by
+ * kind, with light overrides. The concrete per-source schema is built at
+ * runtime by `manifestAdapter` and validated at `buildSources` time, so the
+ * static type here is intentionally permissive.
+ */
+export interface ManifestSourceConfig {
+    kind: string;
+    name?: string;
+    env?: Record<string, string>;
+    timeouts?: ShellAdapterConfig["timeouts"];
+    enabled?: boolean;
+}
 /**
  * Discriminated union of all built-in adapter config shapes. Used at
  * config-load time as the static type for `Config.sources[]` and
  * `ResolvedConfig.sources[]`. The runtime Zod validation lives in each
  * adapter's `schema.ts` and runs at `buildSources` time, not here.
  */
-export type SourceConfig = LinearAdapterConfig | ShellAdapterConfig | TodoTxtAdapterConfig;
+export type SourceConfig = LinearAdapterConfig | ShellAdapterConfig | TodoTxtAdapterConfig | ManifestSourceConfig;
 export interface HookCommands {
     prepareWorktree?: string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"sourceCapabilities.d.ts","sourceRoot":"","sources":["../../src/lib/sourceCapabilities.ts"],"names":[],"mappings":"AAIA,UAAU,kBAAkB;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,kBAAkB,CAAC;CAClC;AAqDD,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAiB3D;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE;IACjD,UAAU,EAAE,SAAS,OAAO,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CASV;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE;IACxD,UAAU,EAAE,SAAS,OAAO,EAAE,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAcV"}
+{"version":3,"file":"sourceCapabilities.d.ts","sourceRoot":"","sources":["../../src/lib/sourceCapabilities.ts"],"names":[],"mappings":"AAMA,UAAU,kBAAkB;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,kBAAkB,CAAC;CAClC;AAgGD,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAiB3D;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE;IACjD,UAAU,EAAE,SAAS,OAAO,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CASV;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE;IACxD,UAAU,EAAE,SAAS,OAAO,EAAE,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAcV"}

package/dist/lib/sourceCapabilities.js

@@ -1,5 +1,7 @@
 import { z } from "zod";
+import { discoverTaskSourceManifests } from "./adapters/shell/discovery.js";
 import { shellAdapterConfigSchema } from "./adapters/shell/schema.js";
+let cachedManifestCapabilitiesByKind;
 const nameShape = z.looseObject({ name: z.string().optional() });
 const kindShape = z.object({ kind: z.string() });
 const LINEAR_CAPABILITIES = {
@@ -36,6 +38,34 @@ function shellCapabilities(raw) {
         validate: commands.validate !== undefined,
     };
 }
+function manifestCapabilities(arguments_) {
+    const { manifest } = arguments_;
+    const { commands } = manifest;
+    return {
+        verify: commands.verify !== undefined,
+        listTasks: true,
+        getTask: commands.getTask !== undefined,
+        createTask: commands.createTask !== undefined,
+        markInProgress: commands.markInProgress !== undefined,
+        markInReview: commands.markInReview !== undefined,
+        markDone: commands.markDone !== undefined,
+        validate: commands.validate !== undefined,
+    };
+}
+function getManifestCapabilitiesByKind() {
+    if (cachedManifestCapabilitiesByKind === undefined) {
+        const capabilitiesByKind = new Map();
+        for (const { manifest } of discoverTaskSourceManifests()) {
+            capabilitiesByKind.set(manifest.name, manifestCapabilities({ manifest }));
+        }
+        cachedManifestCapabilitiesByKind = capabilitiesByKind;
+    }
+    return cachedManifestCapabilitiesByKind;
+}
+function manifestCapabilitiesForKind(arguments_) {
+    const { kind } = arguments_;
+    return getManifestCapabilitiesByKind().get(kind);
+}
 const TODO_TXT_CAPABILITIES = {
     verify: true,
     listTasks: true,
@@ -61,7 +91,7 @@ export function summarizeSource(raw) {
         capabilities = TODO_TXT_CAPABILITIES;
     }
     else {
-        capabilities = UNKNOWN_KIND_CAPABILITIES;
+        capabilities = manifestCapabilitiesForKind({ kind }) ?? UNKNOWN_KIND_CAPABILITIES;
     }
     return { name: sourceName, kind, capabilities };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/groundcrew",
-  "version": "4.46.2",
+  "version": "4.46.4",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",
@@ -71,34 +71,34 @@
   },
   "dependencies": {
     "@anthropic-ai/sandbox-runtime": "0.0.63",
-    "@clipboard-health/clearance": "1.3.2",
+    "@clipboard-health/clearance": "1.4.4",
     "@linear/sdk": "88.0.0",
     "cosmiconfig": "9.0.2",
     "tslib": "2.8.1",
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@clipboard-health/ai-rules": "2.29.1",
-    "@clipboard-health/oxlint-config": "1.12.0",
-    "@nx/js": "22.7.5",
+    "@clipboard-health/ai-rules": "2.34.0",
+    "@clipboard-health/oxlint-config": "1.12.6",
+    "@nx/js": "22.7.6",
     "@tsconfig/node24": "24.0.4",
     "@tsconfig/strictest": "2.0.8",
     "@types/node": "25.9.4",
-    "@typescript/native-preview": "7.0.0-dev.20260701.1",
+    "@typescript/native-preview": "7.0.0-dev.20260703.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.18.0",
+    "knip": "6.24.0",
     "lint-staged": "17.0.8",
     "markdownlint-cli2": "0.22.1",
-    "nx": "22.7.5",
-    "oxfmt": "0.56.0",
-    "oxlint": "1.71.0",
+    "nx": "22.7.6",
+    "oxfmt": "0.57.0",
+    "oxlint": "1.72.0",
     "oxlint-tsgolint": "0.23.0",
     "syncpack": "15.3.2",
-    "vite": "8.0.16",
+    "vite": "8.1.3",
     "vitest": "4.1.9"
   },
   "engines": {