@clipboard-health/groundcrew 4.23.0 → 4.24.0

package/dist/commands/task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"AAmmBA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAe3D"}
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"AAwmBA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAe3D"}

package/dist/commands/task.js

@@ -54,6 +54,9 @@ const CREATE_VALUE_HANDLERS = {
     "--repo": (state, value) => {
         state.repository = value;
     },
+    "--team": (state, value) => {
+        state.team = value;
+    },
     "--id": (state, value) => {
         state.id = value;
     },
@@ -240,6 +243,7 @@ function parseCreateOptions(argv) {
         dependencies: state.dependencies,
         edit: state.edit,
         ...(state.repository === undefined ? {} : { repository: state.repository }),
+        ...(state.team === undefined ? {} : { team: state.team }),
         ...(state.id === undefined ? {} : { id: state.id }),
         ...(state.priority === undefined ? {} : { priority: state.priority }),
         ...(state.due === undefined ? {} : { due: state.due }),

package/dist/lib/adapters/linear/create.d.ts

@@ -0,0 +1,15 @@
+import type { LinearClient } from "@linear/sdk";
+import type { ResolvedConfig } from "../../config.ts";
+import type { CreateTaskInput } from "../../taskSource.ts";
+import { type Issue as LinearIssue } from "./fetch.ts";
+import type { LinearAdapterConfig } from "./schema.ts";
+interface CreateLinearIssueArguments {
+    client: LinearClient;
+    config: ResolvedConfig;
+    input: CreateTaskInput;
+    sourceConfig: LinearAdapterConfig;
+    sourceName: string;
+}
+export declare function createLinearIssue(arguments_: CreateLinearIssueArguments): Promise<LinearIssue>;
+export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/create.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAsB,KAAK,KAAK,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAKvD,UAAU,0BAA0B;IAClC,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,eAAe,CAAC;IACvB,YAAY,EAAE,mBAAmB,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB;AA4BD,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,0BAA0B,GACrC,OAAO,CAAC,WAAW,CAAC,CA2DtB"}

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

@@ -0,0 +1,273 @@
+import { readFileSync } from "node:fs";
+import { fetchResolvedIssue } from "./fetch.js";
+import { AGENT_LABEL_PREFIX, resolveRepositoryFor } from "./parsing.js";
+import { findLinearWorkflowStateByName } from "./statusNames.js";
+const TODO_STATE_NAMES = ["Todo", "To Do"];
+export async function createLinearIssue(arguments_) {
+    const { client, config, input, sourceConfig, sourceName } = arguments_;
+    assertSupportedCreateInput(input);
+    const title = normalizeTitle(input.title);
+    const repository = resolveCreateRepository({ config, input });
+    const teamSelector = resolveTeamSelector({ input, sourceConfig });
+    const agentLabelName = resolveAgentLabelName(input.agent);
+    const priority = linearPriority(input.priority);
+    const description = buildLinearDescription({ input, repository, title });
+    const context = await fetchCreateContext({ client, teamSelector, agentLabelName });
+    const team = requireExactlyOne(context.teams.nodes, `Linear team "${teamSelector}"`);
+    const todoState = requireTodoState(team.states.nodes, team.key);
+    const agentLabel = requireExactlyOne(team.labels.nodes, `Linear label "${agentLabelName}"`);
+    if (context.viewer === null) {
+        throw new Error("Linear API did not return a viewer for this API key.");
+    }
+    const createdIdentifier = await createIssue({
+        client,
+        assigneeId: context.viewer.id,
+        description,
+        dueDate: input.due,
+        labelId: agentLabel.id,
+        priority,
+        stateId: todoState.id,
+        teamId: team.id,
+        title,
+    });
+    for (const dependency of input.dependencies) {
+        // oxlint-disable-next-line no-await-in-loop -- relation creation targets the issue created above and should fail fast in input order
+        await createBlockedByRelation({
+            client,
+            dependency,
+            relatedIssueId: createdIdentifier,
+            sourceName,
+        });
+    }
+    const resolved = await fetchResolvedIssue({ client, config, task: createdIdentifier });
+    return {
+        id: createdIdentifier.toLowerCase(),
+        uuid: resolved.uuid,
+        title: resolved.title,
+        description: resolved.description,
+        status: resolved.status,
+        statusId: resolved.statusId,
+        stateType: resolved.stateType,
+        assignee: resolved.assignee,
+        updatedAt: resolved.updatedAt,
+        repository: resolved.repository,
+        model: resolved.model,
+        teamId: resolved.teamId,
+        blockers: resolved.blockers,
+        hasMoreBlockers: resolved.hasMoreBlockers,
+        url: resolved.url,
+        priority: resolved.priority,
+    };
+}
+function assertSupportedCreateInput(input) {
+    if (input.id !== undefined) {
+        throw new Error("linear: --id is not supported; Linear assigns issue identifiers");
+    }
+    if (input.recurrence !== undefined) {
+        throw new Error("linear: --rec is not supported");
+    }
+    if (input.edit) {
+        throw new Error("linear: --edit is not supported");
+    }
+}
+function normalizeTitle(title) {
+    const normalized = title.trim();
+    if (normalized.length === 0) {
+        throw new Error("linear: title is required");
+    }
+    if (/[\r\n]/.test(normalized)) {
+        throw new Error("linear: title must be a single line");
+    }
+    return normalized;
+}
+function resolveCreateRepository(arguments_) {
+    const { config, input } = arguments_;
+    if (input.repository === undefined) {
+        throw new Error("linear: --repo is required so Groundcrew can route the task");
+    }
+    const resolution = resolveRepositoryFor({
+        description: `Repository: ${input.repository}`,
+        config,
+    });
+    if (resolution.kind === "missing") {
+        throw new Error(`linear: repository "${input.repository}" is not in workspace.knownRepositories`);
+    }
+    return resolution.repository;
+}
+function resolveTeamSelector(arguments_) {
+    const { input, sourceConfig } = arguments_;
+    const selector = input.team ?? sourceConfig.team;
+    if (selector === undefined) {
+        throw new Error('linear: team is required. Pass --team <key-or-id> or configure sources: [{ kind: "linear", team: "<key-or-id>" }].');
+    }
+    const normalized = selector.trim();
+    if (normalized.length === 0) {
+        throw new Error("linear: team must be a non-empty string");
+    }
+    return normalized;
+}
+function resolveAgentLabelName(agent) {
+    const normalized = agent.trim();
+    if (normalized.length === 0) {
+        throw new Error("linear: --agent must be a non-empty string");
+    }
+    return `${AGENT_LABEL_PREFIX}${normalized}`;
+}
+function linearPriority(priority) {
+    if (priority === undefined) {
+        return undefined;
+    }
+    const parsed = Number.parseInt(priority, 10);
+    if (!Number.isInteger(parsed) || String(parsed) !== priority || parsed < 0 || parsed > 4) {
+        throw new Error("linear: --priority must be an integer from 0 to 4");
+    }
+    return parsed;
+}
+function buildLinearDescription(arguments_) {
+    const { input, repository, title } = arguments_;
+    return [
+        "## Groundcrew",
+        "",
+        `Repository: ${repository}`,
+        "Implementation workflow: use the `core:go`/`go` skill when available. If that skill is unavailable, follow this repo's AGENTS.md/CLAUDE.md implementation workflow and run the documented verification.",
+        "",
+        "## Task",
+        "",
+        promptBody(input, title),
+        "",
+        "## Acceptance Criteria",
+        "",
+        `- [ ] ${title}`,
+        "",
+        "## Notes",
+        "",
+        notesFor(input),
+    ].join("\n");
+}
+function promptBody(input, fallbackTitle) {
+    if (input.promptFile !== undefined && input.description !== undefined) {
+        throw new Error("linear: --prompt-file and --description are mutually exclusive");
+    }
+    if (input.promptFile !== undefined) {
+        return readFileSync(input.promptFile, "utf8").trim();
+    }
+    return input.description?.trim() ?? fallbackTitle;
+}
+function notesFor(input) {
+    const notes = [];
+    if (input.projects.length > 0) {
+        notes.push(`Projects: ${input.projects.join(", ")}`);
+    }
+    if (input.contexts.length > 0) {
+        notes.push(`Contexts: ${input.contexts.join(", ")}`);
+    }
+    if (input.dependencies.length > 0) {
+        notes.push(`Blocked by: ${input.dependencies.join(", ")}`);
+    }
+    if (input.due !== undefined) {
+        notes.push(`Due: ${input.due}`);
+    }
+    return notes.length === 0 ? "None" : notes.join("\n");
+}
+async function fetchCreateContext(arguments_) {
+    const { client, teamSelector, agentLabelName } = arguments_;
+    const response = await client.client.rawRequest(`query CreateLinearTaskContext($teamSelector: String!, $teamSelectorId: ID!, $agentLabelName: String!) {
+      viewer { id name }
+      teams(
+        filter: {
+          or: [
+            { id: { eq: $teamSelectorId } }
+            { key: { eqIgnoreCase: $teamSelector } }
+          ]
+        }
+        first: 2
+        includeArchived: false
+      ) {
+        nodes {
+          id
+          key
+          name
+          labels(filter: { name: { eq: $agentLabelName } }, first: 2, includeArchived: false) {
+            nodes { id name }
+          }
+          states(first: 50, includeArchived: false) {
+            nodes { id name type position }
+          }
+        }
+      }
+    }`, { teamSelector, teamSelectorId: teamSelector, agentLabelName });
+    // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- shape is fixed by the GraphQL query above
+    return response.data;
+}
+function requireExactlyOne(items, label) {
+    const [item] = items;
+    if (items.length !== 1 || item === undefined) {
+        throw new Error(`linear: expected exactly one ${label}, found ${items.length}`);
+    }
+    return item;
+}
+function requireTodoState(states, teamKey) {
+    const unstartedStates = states.filter((state) => state.type === "unstarted");
+    const todoState = findLinearWorkflowStateByName(unstartedStates, TODO_STATE_NAMES) ??
+        unstartedStates.toSorted((a, b) => a.position - b.position).at(0);
+    if (todoState === undefined) {
+        throw new Error(`linear: could not find a Todo workflow state for team ${teamKey}`);
+    }
+    return todoState;
+}
+async function createIssue(arguments_) {
+    const { client, assigneeId, description, dueDate, labelId, priority, stateId, teamId, title } = arguments_;
+    const response = await client.client.rawRequest(`mutation CreateLinearTask($input: IssueCreateInput!) {
+      issueCreate(input: $input) {
+        success
+        issue { identifier }
+      }
+    }`, {
+        input: {
+            assigneeId,
+            description,
+            labelIds: [labelId],
+            stateId,
+            teamId,
+            title,
+            ...(dueDate === undefined ? {} : { dueDate }),
+            ...(priority === undefined ? {} : { priority }),
+        },
+    });
+    // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- shape is fixed by the GraphQL mutation above
+    const data = response.data;
+    if (!data.issueCreate.success || data.issueCreate.issue === null) {
+        throw new Error("linear: issueCreate did not return a created issue");
+    }
+    return data.issueCreate.issue.identifier;
+}
+async function createBlockedByRelation(arguments_) {
+    const { client, dependency, relatedIssueId, sourceName } = arguments_;
+    const issueId = normalizeLinearDependencyId(dependency, sourceName);
+    const response = await client.client.rawRequest(`mutation CreateLinearTaskBlockedBy($input: IssueRelationCreateInput!) {
+      issueRelationCreate(input: $input) {
+        success
+      }
+    }`, {
+        input: {
+            issueId,
+            relatedIssueId,
+            type: "blocks",
+        },
+    });
+    // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- shape is fixed by the GraphQL mutation above
+    const data = response.data;
+    if (!data.issueRelationCreate.success) {
+        throw new Error(`linear: could not create blocked-by relation for ${dependency}`);
+    }
+}
+function normalizeLinearDependencyId(dependency, sourceName) {
+    const sourcePrefix = `${sourceName}:`;
+    if (dependency.toLowerCase().startsWith(sourcePrefix.toLowerCase())) {
+        return dependency.slice(sourcePrefix.length);
+    }
+    if (dependency.includes(":")) {
+        throw new Error(`linear: dependency "${dependency}" is not a Linear task id for source "${sourceName}"`);
+    }
+    return dependency;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAIL,KAAK,KAAK,IAAI,cAAc,EAG5B,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAIL,KAAK,KAAK,IAAI,WAAW,EAE1B,MAAM,YAAY,CAAC;AACpB,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,YAAY,EAAE,MAAM,CAAC;CACtB;AA2DD,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,iBAA+C,GAC3D,cAAc,CA4BhB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,cAAc,GACtB,UAAU,CAwHZ"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAIL,KAAK,KAAK,IAAI,cAAc,EAG5B,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAIL,KAAK,KAAK,IAAI,WAAW,EAE1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,YAAY,EAAE,MAAM,CAAC;CACtB;AA2DD,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,iBAA+C,GAC3D,cAAc,CA4BhB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,cAAc,GACtB,UAAU,CAqIZ"}

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

@@ -14,6 +14,7 @@
 import { toCanonicalId, } from "../../taskSource.js";
 import { getLinearClient, lazyLinearClient } from "./client.js";
 import { createBoardSource, fetchResolvedIssue, } from "./fetch.js";
+import { createLinearIssue } from "./create.js";
 import { canonicalStatusFromLinearState, DEFAULT_LINEAR_STATUS_NAMES, resolveLinearStatusNames, } from "./statusNames.js";
 import { createLinearIssueStatusUpdater } from "./writeback.js";
 function canonicalBlockerStatus(blocker, statusNames) {
@@ -170,6 +171,15 @@ export function createLinearTaskSource(config, context) {
         async getTask(naturalId) {
             return await getTask(naturalId);
         },
+        async createTask(input) {
+            return toCanonicalIssue(await createLinearIssue({
+                client: getClient(),
+                config: globalConfig,
+                input,
+                sourceConfig: config,
+                sourceName,
+            }), sourceName, statusNames);
+        },
         async fetch() {
             return await listTasks();
         },

package/dist/lib/adapters/linear/schema.d.ts

@@ -9,6 +9,7 @@ export declare const linearAdapterConfigSchema: z.ZodObject<{
     kind: z.ZodLiteral<"linear">;
     enabled: z.ZodOptional<z.ZodBoolean>;
     name: z.ZodOptional<z.ZodString>;
+    team: z.ZodOptional<z.ZodString>;
     statuses: z.ZodOptional<z.ZodObject<{
         inProgress: z.ZodOptional<z.ZodArray<z.ZodString>>;
         inReview: z.ZodOptional<z.ZodArray<z.ZodString>>;

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,yBAAyB;;;;;;;;iBAkBpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/linear/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,yBAAyB;;;;;;;;;iBAoBpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

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

@@ -18,6 +18,8 @@ export const linearAdapterConfigSchema = z.object({
         .string()
         .regex(/^[a-z][a-z0-9-]*$/, "name must be kebab-case (lowercase letters, digits, hyphens)")
         .optional(),
+    /** Team key or id used by `crew task create --source linear` when --team is omitted. */
+    team: z.string().trim().min(1).optional(),
     statuses: z
         .object({
         inProgress: statusNamesSchema.optional(),

package/dist/lib/taskSource.d.ts

@@ -131,6 +131,8 @@ export interface CreateTaskInput {
     agent: string;
     /** Optional repository override in the same format Groundcrew resolves from task descriptions. */
     repository?: string;
+    /** Optional source-native team selector, such as a Linear team key or id. */
+    team?: string;
     /** Optional source-native task id. When omitted, sources may generate one. */
     id?: string;
     /** Optional source-native priority token, such as a todo.txt `A`/`B`/`C` priority. */

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

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

package/docs/commands.md

@@ -30,6 +30,17 @@ crew task create "Fix cancellation retry race" \
   --edit
 ```
 
+Linear creation creates a Todo issue assigned to the current Linear API viewer, with exactly one `agent-*` label and a `Repository: <repo>` line in the description. Configure `sources: [{ kind: "linear", team: "ENG" }]` or pass `--team ENG`; the CLI option wins when both are present.
+
+```bash
+crew task create "Fix cancellation retry race" \
+  --source linear \
+  --agent codex \
+  --team ENG \
+  --repo ClipboardHealth/api \
+  --description "Investigate retry handling."
+```
+
 ## Status
 
 `crew status <TASK>` prints a read-only snapshot for one task: cached title and URL when present, recorded run state, live workspace presence, matching worktrees, git dirtiness, PR links for matching branches, recent log lines when present, and the task status from the configured task source.

package/docs/configuration.md

@@ -180,7 +180,7 @@ and hook contract.
 
 | Key                                      | Default              | What it does                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
 | ---------------------------------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `sources`                                | `[]`                 | Additional pluggable task sources, dispatched alongside the built-in Linear adapter. Built-in kinds: `shell`, `linear`. Declare `{ kind: "linear", statuses: { ... } }` only to override Linear status names used for `in-progress` / `in-review` disambiguation. Disable the implicit Linear source with `{ kind: "linear", enabled: false }` (no API key required) — useful for shell-only setups.                                                                                                                        |
+| `sources`                                | `[]`                 | Additional pluggable task sources, dispatched alongside the built-in Linear adapter. Built-in kinds: `shell`, `linear`. Declare `{ kind: "linear", team: "ENG", statuses: { ... } }` to configure Linear task creation's default team and/or override Linear status names used for `in-progress` / `in-review` disambiguation. Disable the implicit Linear source with `{ kind: "linear", enabled: false }` (no API key required) — useful for shell-only setups.                                                           |
 | `git.remote`                             | `"origin"`           | Remote used for `fetch` and as the worktree base ref.                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | `git.defaultBranch`                      | `"main"`             | Branch fetched from `git.remote` and used as the worktree base.                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
 | `git.branchPrefix`                       | OS username          | Prefix groundcrew puts before the task id when naming a worktree branch (`<branchPrefix>-<task>`). Must be a slash-free slug of letters, digits, `.`, `_`, or `-`. Defaults to the OS account username. Changing it only affects newly created worktrees; existing local branches keep their original names until cleaned up. Prefer a per-user config for personal prefixes — a committed `git.branchPrefix` gives every contributor the same branch prefix.                                                               |

package/docs/task-sources.md

@@ -94,6 +94,33 @@ crew task create "Fix cancellation retry race" \
 (A) Fix cancellation retry race +marketplace @backend id:GC-20260608-001 repo:ClipboardHealth/api agent:codex status:todo
 ```
 
+## Linear
+
+The built-in Linear source supports listing, getting, writeback, and task creation through `crew task create`.
+
+Linear task creation needs a team because Linear issues are team-scoped. Configure it once on the source, or pass `--team <key-or-id>` for one command:
+
+```ts
+export default {
+  sources: [
+    {
+      kind: "linear",
+      team: "ENG",
+    },
+  ],
+};
+```
+
+```bash
+crew task create "Fix cancellation retry race" \
+  --source linear \
+  --agent codex \
+  --repo ClipboardHealth/api \
+  --description "Investigate retry handling."
+```
+
+Created Linear issues are assigned to the API key's viewer, moved into a Todo workflow state, labeled with exactly one `agent-*` label, and given a description that includes `Repository: <repo>` near the top. Repeated `--dep <ISSUE>` values create Linear blocked-by relations when the dependency is a Linear issue id.
+
 ## The `description` is the agent's prompt
 
 Groundcrew wraps each issue's `description` in its generic unattended-execution prompt and hands it to the agent as the task. It does not pick a different prompt per source or task type. Specialized behavior belongs in the `description` your adapter emits, not in groundcrew.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/groundcrew",
-  "version": "4.23.0",
+  "version": "4.24.0",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",