@clipboard-health/groundcrew 4.46.1 → 4.46.3

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 } 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);
+    }
+    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,27 @@
+/**
+ * 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[];
+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"}

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

@@ -0,0 +1,79 @@
+/**
+ * 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;
+}

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,20 @@
+/**
+ * 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 } 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;
+export declare function manifestAdapter(manifest: SourceManifest, manifestDir: string): 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,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"}

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

@@ -0,0 +1,51 @@
+/**
+ * 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 } : {}),
+    };
+}
+export function manifestAdapter(manifest, manifestDir) {
+    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);
+        },
+    };
+}

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":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAO1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,oBAAoB,CAAC;AAE3F,MAAM,WAAW,YAAY;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,QAAQ,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvE,eAAO,MAAM,uBAAuB,EAAE,SAAS,oBAAoB,EAKzD,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,MAAM,CAAC;AAEtD,eAAO,MAAM,qBAAqB,EAAE,SAAS,kBAAkB,EAMrD,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,MAAM,CAAC;AAE1D,eAAO,MAAM,uBAAuB,EAAE,SAAS,oBAAoB,EAGzD,CAAC;AAEX;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACjD,CAAC;IACF;;;;OAIG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,KAAK,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,CAAC;AAC/D,KAAK,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,GAAG;IAC1E,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AACF,KAAK,mBAAmB,GAAG,0BAA0B,CAAC;AAEtD;;;;;;;;;GASG;AACH;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2HAA2H;IAC3H,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,MAAM;IACrB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB;;;;WAIG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;QACnB;;;WAGG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,KAAK,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;KACpD,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,YAAY,CAAC;KACtB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;IACF,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB;;;;;WAKG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;KACnD,CAAC;IACF,OAAO,CAAC,EAAE;QACR,mEAAmE;QACnE,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB;;;;WAIG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF;;;;OAIG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC;;;;OAIG;IACH,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B;;;;;WAKG;QACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;QACrC;;;WAGG;QACH,SAAS,CAAC,EAAE;YACV;;;;;;;;;;eAUG;YACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;SACnB,CAAC;QACF;;;;;WAKG;QACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,OAAO,CAAC,EAAE;QACR;;;;;WAKG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,GAAG,EAAE;QACH,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,4DAA4D;QAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,0EAA0E;QAC1E,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,6EAA6E;QAC7E,YAAY,EAAE,eAAe,EAAE,CAAC;QAChC,8EAA8E;QAC9E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACzC,CAAC;IACF,QAAQ,EAAE;QACR,KAAK,EAAE,YAAY,CAAC;KACrB,CAAC;IACF,YAAY,EAAE;QACZ,iBAAiB,EAAE,MAAM,CAAC;QAC1B,wBAAwB,EAAE,MAAM,CAAC;QACjC,sBAAsB,EAAE,MAAM,CAAC;KAChC,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;KAC9C,CAAC;IACF,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF;;;OAGG;IACH,aAAa,EAAE,oBAAoB,CAAC;IACpC;;;;OAIG;IACH,KAAK,EAAE;QACL,MAAM,EAAE,kBAAkB,CAAC;QAC3B;;;WAGG;QACH,aAAa,EAAE,oBAAoB,CAAC;QACpC;;;WAGG;QACH,SAAS,EAAE;YACT,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;SAC3B,CAAC;QACF,sFAAsF;QACtF,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IACF,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAE9D;AAED,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACjC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;CAChC;AAmQD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,GAAG,OAAO,CAE1F;AAyJD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,EACtC,IAAI,EAAE,MAAM,GACX,OAAO,CAKT;AA+lBD,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CA+B5E;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAGpE"}
+{"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.1",
+  "version": "4.46.3",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",
@@ -70,35 +70,35 @@
     "verify": "node scripts/verifyAll.mts"
   },
   "dependencies": {
-    "@anthropic-ai/sandbox-runtime": "0.0.62",
-    "@clipboard-health/clearance": "1.3.2",
+    "@anthropic-ai/sandbox-runtime": "0.0.63",
+    "@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.21.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.0",
     "vitest": "4.1.9"
   },
   "engines": {