@clipboard-health/groundcrew 4.23.0 → 4.24.1

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

@@ -1 +1 @@
-{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/commands/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EACL,KAAK,UAAU,EAGf,KAAK,KAAK,EAEX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWzD,UAAU,cAAc;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,CAAC,UAAU,EAAE;QACpB,KAAK,EAAE,UAAU,CAAC;QAClB,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;QAC1C,+FAA+F;QAC/F,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;QACvD,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB;;;;WAIG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrB;AAaD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAyNjE;AA2BD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAQrE"}
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/commands/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EACL,KAAK,UAAU,EAGf,KAAK,KAAK,EAEX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWzD,UAAU,cAAc;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,CAAC,UAAU,EAAE;QACpB,KAAK,EAAE,UAAU,CAAC;QAClB,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;QAC1C,+FAA+F;QAC/F,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;QACvD,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB;;;;WAIG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrB;AAiCD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAmOjE;AA2BD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAQrE"}

package/dist/commands/dispatcher.js

@@ -6,9 +6,9 @@
  * Pure verdict logic lives in `eligibility.ts`; this module is responsible
  * for telemetry, writeback via Board, and side-effecting setupWorkspace calls.
  */
-import { dispatchableRepository } from "../lib/repositoryValidation.js";
+import { dispatchableRepository, formatKnownRepositories } from "../lib/repositoryValidation.js";
 import { isGroundcrewIssue, naturalIdFromCanonical, } from "../lib/taskSource.js";
-import { errorMessage, failMark, log, logEvent } from "../lib/util.js";
+import { errorMessage, failMark, log, logEvent, styleWarning } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
 import { classifyBlockers, classifyEligibility, classifyUsageExhaustion, } from "./eligibility.js";
 import { setupWorkspace } from "./setupWorkspace.js";
@@ -22,6 +22,17 @@ function logSkip(verdict) {
         model: verdict.model,
     });
 }
+function logMissingRepositorySkip(issue, model, knownRepositories) {
+    const task = naturalIdFromCanonical(issue.id);
+    log(styleWarning(`WARNING: ${issue.id} has agent "${model}" but no repository; skipping dispatch. Add --repo <repo> when creating the task, add repo:<repo> to the task line, or set defaultRepository on source "${issue.source}". Known repositories: ${formatKnownRepositories(knownRepositories)}`));
+    logEvent("dispatch", {
+        outcome: "skipped",
+        reason: "missing_repository",
+        task,
+        source: issue.source,
+        model,
+    });
+}
 export function createDispatcher(deps) {
     const { config, board } = deps;
     function buildExhaustedSet(usage) {
@@ -109,20 +120,31 @@ export function createDispatcher(deps) {
             .toSorted((a, b) => a.id.localeCompare(b.id));
         const activeCount = active.length;
         const slots = config.orchestrator.maximumInProgress - activeCount;
-        // Narrow Todo to tasks that opted in via an `agent-*` label.
-        // Unlabeled tasks are not groundcrew's concern even when in Todo.
+        const rawTodo = state.issues.filter((issue) => issue.status === "todo");
+        for (const issue of rawTodo) {
+            const { model, repository } = issue;
+            if (model !== undefined && repository === undefined) {
+                logMissingRepositorySkip(issue, model, config.workspace.knownRepositories);
+            }
+        }
+        // Narrow queued work to tasks that opted in with an agent and resolved a
+        // repository. Unlabeled tasks are not groundcrew's concern.
         // Sort by priority so higher-priority tasks fill slots first.
-        const todo = state.issues
-            .filter((issue) => issue.status === "todo" && isGroundcrewIssue(issue))
+        const todo = rawTodo
+            .filter((issue) => isGroundcrewIssue(issue))
             .toSorted((a, b) => prioritySortKey(a.priority) - prioritySortKey(b.priority));
         if (slots <= 0) {
             log(`At capacity (${activeCount}/${config.orchestrator.maximumInProgress})${formatActiveSlotList(active)}, no new work to start${idleSuffix}`);
             return;
         }
-        if (todo.length === 0) {
+        if (rawTodo.length === 0) {
             log(`No Todo tasks to pick up${idleSuffix}`);
             return;
         }
+        if (todo.length === 0) {
+            log(`No eligible Todo tasks after agent/repository filtering${idleSuffix}`);
+            return;
+        }
         // Run the blocker pre-pass first so an all-blocked board short-circuits
         // before the codexbar HTTP call and the cmux/tmux shell-out fire.
         const { unblocked, skips: blockerSkips } = classifyBlockers(todo);

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/repositoryValidation.d.ts

@@ -9,5 +9,6 @@
  * the tick across N sources.
  */
 import type { Issue } from "./taskSource.ts";
+export declare function formatKnownRepositories(knownRepositories: readonly string[]): string;
 export declare function dispatchableRepository(issue: Issue, knownRepositories: readonly string[], log: (message: string) => void): string | undefined;
 //# sourceMappingURL=repositoryValidation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"repositoryValidation.d.ts","sourceRoot":"","sources":["../../src/lib/repositoryValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC7B,MAAM,GAAG,SAAS,CAWpB"}
+{"version":3,"file":"repositoryValidation.d.ts","sourceRoot":"","sources":["../../src/lib/repositoryValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,wBAAgB,uBAAuB,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEpF;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC7B,MAAM,GAAG,SAAS,CAWpB"}

package/dist/lib/repositoryValidation.js

@@ -8,12 +8,15 @@
  * the MVP-2 plan): one badly-labelled task should not throw and abort
  * the tick across N sources.
  */
+export function formatKnownRepositories(knownRepositories) {
+    return knownRepositories.join(", ") || "(none)";
+}
 export function dispatchableRepository(issue, knownRepositories, log) {
     if (issue.repository === undefined) {
         return undefined;
     }
     if (!knownRepositories.includes(issue.repository)) {
-        log(`issue ${issue.id} references unknown repository ${issue.repository}; configured workspace.knownRepositories: ${knownRepositories.join(", ") || "(none)"}`);
+        log(`issue ${issue.id} references unknown repository ${issue.repository}; configured workspace.knownRepositories: ${formatKnownRepositories(knownRepositories)}`);
         return undefined;
     }
     return issue.repository;

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

@@ -1 +1 @@
-{"version":3,"file":"runState.d.ts","sourceRoot":"","sources":["../../src/lib/runState.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,kBAAkB,CAAC;AAE3F,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAAC,CAAC,GAAG;QACrD,KAAK,EAAE,iBAAiB,CAAC;KAC1B,CAAC;CACH;AAaD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,MAAM,CAEjF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1F;AAmFD,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAYvF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,QAAQ,CA0BnE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,QAAQ,GAAG,SAAS,CAc/E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEzE"}
+{"version":3,"file":"runState.d.ts","sourceRoot":"","sources":["../../src/lib/runState.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,kBAAkB,CAAC;AAE3F,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAAC,CAAC,GAAG;QACrD,KAAK,EAAE,iBAAiB,CAAC;KAC1B,CAAC;CACH;AAQD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,MAAM,CAEjF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1F;AAmFD,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAYvF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,QAAQ,CA0BnE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,QAAQ,GAAG,SAAS,CAc/E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEzE"}

package/dist/lib/runState.js

@@ -1,13 +1,9 @@
 import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
-const TASK_RE = /^[a-z][\da-z]*-\d+$/;
+import { normalizePlainTaskId } from "./taskId.js";
 const RUN_STATE_DIRECTORY_NAME = "runs";
 function taskKey(task) {
-    const normalized = task.toLowerCase();
-    if (!TASK_RE.test(normalized)) {
-        throw new Error(`Invalid task "${task}": must be a plain task id`);
-    }
-    return normalized;
+    return normalizePlainTaskId(task);
 }
 export function runStateDirectory(config) {
     return path.resolve(path.dirname(config.logging.file), RUN_STATE_DIRECTORY_NAME);

package/dist/lib/taskId.d.ts

@@ -0,0 +1,4 @@
+export declare function isPlainTaskId(task: string): boolean;
+export declare function assertPlainTaskId(task: string): void;
+export declare function normalizePlainTaskId(task: string): string;
+//# sourceMappingURL=taskId.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"taskId.d.ts","sourceRoot":"","sources":["../../src/lib/taskId.ts"],"names":[],"mappings":"AAMA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIpD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMzD"}

package/dist/lib/taskId.js

@@ -0,0 +1,19 @@
+const PLAIN_TASK_ID_RE = /^[a-z][\da-z]*(?:-[\da-z]+)*-\d+$/;
+function invalidPlainTaskIdError(task) {
+    return new Error(`Invalid task "${task}": must be a plain task id`);
+}
+export function isPlainTaskId(task) {
+    return PLAIN_TASK_ID_RE.test(task);
+}
+export function assertPlainTaskId(task) {
+    if (!isPlainTaskId(task)) {
+        throw invalidPlainTaskIdError(task);
+    }
+}
+export function normalizePlainTaskId(task) {
+    const normalized = task.toLowerCase();
+    if (!isPlainTaskId(normalized)) {
+        throw invalidPlainTaskIdError(task);
+    }
+    return normalized;
+}

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/dist/lib/worktrees.d.ts

@@ -18,7 +18,7 @@ export declare class WorktreeAlreadyExistsError extends Error {
 export declare function isWorktreeAlreadyExistsError(error: unknown): error is WorktreeAlreadyExistsError;
 export interface WorktreeEntry {
     repository: string;
-    /** Linear task id, lowercased — e.g. "team-220". */
+    /** Source task id, lowercased — e.g. "team-220" or "gc-20260608-001". */
     task: string;
     /** Slash-free `<prefix>-<task>`. */
     branchName: string;

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

@@ -1 +1 @@
-{"version":3,"file":"worktrees.d.ts","sourceRoot":"","sources":["../../src/lib/worktrees.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,EAAE,KAAK,cAAc,EAAsC,MAAM,aAAa,CAAC;AAGtF,OAAO,EAAE,KAAK,cAAc,EAAc,MAAM,iBAAiB,CAAC;AAIlE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,SAAgB,GAAG,EAAE,MAAM,CAAC;IAE5B,YAAmB,GAAG,EAAE,MAAM,EAI7B;CACF;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,0BAA0B,CAEhG;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAkBD,iBAAS,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvE;AAgQD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAiHxB,iBAAS,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,EAAE,CAErD;AAED,iBAAS,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAEzE;AAED,iBAAe,MAAM,CACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED,iBAAe,MAAM,CACnB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAClD,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,wDAAwD;IACxD,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,cAAc,EAAE,cAAc,CAAC;CAChC;AAuBD,iBAAe,QAAQ,CACrB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAClD,OAAO,CAAC,cAAc,CAAC,CAiDzB;AAED,iBAAe,gBAAgB,CAAC,KAAK,EAAE;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE7B;AAED,eAAO,MAAM,SAAS;;;;;;;;CAQrB,CAAC"}
+{"version":3,"file":"worktrees.d.ts","sourceRoot":"","sources":["../../src/lib/worktrees.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,EAAE,KAAK,cAAc,EAAsC,MAAM,aAAa,CAAC;AAItF,OAAO,EAAE,KAAK,cAAc,EAAc,MAAM,iBAAiB,CAAC;AAIlE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,SAAgB,GAAG,EAAE,MAAM,CAAC;IAE5B,YAAmB,GAAG,EAAE,MAAM,EAI7B;CACF;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,0BAA0B,CAEhG;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAeD,iBAAS,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvE;AA4QD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAiHxB,iBAAS,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,EAAE,CAErD;AAED,iBAAS,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAEzE;AAED,iBAAe,MAAM,CACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED,iBAAe,MAAM,CACnB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAClD,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,wDAAwD;IACxD,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,cAAc,EAAE,cAAc,CAAC;CAChC;AAuBD,iBAAe,QAAQ,CACrB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAClD,OAAO,CAAC,cAAc,CAAC,CAiDzB;AAED,iBAAe,gBAAgB,CAAC,KAAK,EAAE;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE7B;AAED,eAAO,MAAM,SAAS;;;;;;;;CAQrB,CAAC"}

package/dist/lib/worktrees.js

@@ -14,6 +14,7 @@ import path from "node:path";
 import { runCommandAsync } from "./commandRunner.js";
 import { repositoryBaseDir, worktreeBaseDir } from "./config.js";
 import { resolveDefaultBranch } from "./defaultBranch.js";
+import { assertPlainTaskId, isPlainTaskId } from "./taskId.js";
 import { debug, errorMessage, isVerbose } from "./util.js";
 import { workspaces } from "./workspaces.js";
 const WORKTREE_LIST_PREFIX = "worktree ";
@@ -28,8 +29,6 @@ export class WorktreeAlreadyExistsError extends Error {
 export function isWorktreeAlreadyExistsError(error) {
     return error instanceof WorktreeAlreadyExistsError;
 }
-const TASK_RE = /^[a-z][\da-z]*-\d+$/;
-const TASK_DIR_RE = /^(?<repoBasename>.+)-(?<task>[a-z][\da-z]*-\d+)$/;
 function branchPrefix(config) {
     const fromConfig = config.git.branchPrefix;
     if (fromConfig !== undefined) {
@@ -58,9 +57,7 @@ function basePaths(config, repository, task) {
     // Tasks must match the same shape the worktree discovery regexes use,
     // so create()/list()/findByTask() agree on what's a valid worktree.
     // This also rejects traversal tokens before they reach path.resolve().
-    if (!TASK_RE.test(task)) {
-        throw new Error(`Invalid task "${task}": must be a plain task id`);
-    }
+    assertPlainTaskId(task);
     const repoDir = repoDirFor(config, repository);
     const hostWorktreeName = `${repository}-${task}`;
     const hostWorktreeDir = path.resolve(worktreeBaseDir(config), hostWorktreeName);
@@ -75,6 +72,22 @@ function basePaths(config, repository, task) {
 function signalProperty(signal) {
     return signal === undefined ? {} : { signal };
 }
+function parseWorktreeDirectoryName(directoryName, repositoryEntriesByLongestName) {
+    // Match the longest repository basename first so overlapping names like
+    // "repo-a" and "repo-a-admin" parse to the intended repository.
+    for (const [repositoryBaseName, repository] of repositoryEntriesByLongestName) {
+        const worktreePrefix = `${repositoryBaseName}-`;
+        if (!directoryName.startsWith(worktreePrefix)) {
+            continue;
+        }
+        const task = directoryName.slice(worktreePrefix.length);
+        if (!isPlainTaskId(task)) {
+            continue;
+        }
+        return { repository, task };
+    }
+    return undefined;
+}
 /**
  * Runs a long-running git command (fetch, worktree add/remove/prune) with no
  * timeout. Under --verbose the git porcelain streams live to the terminal;
@@ -147,6 +160,7 @@ function listWorktrees(config) {
         repoByBasename.set(basename, repository);
     }
     for (const [parentDir, repoByBasename] of reposByParent) {
+        const repositoryEntriesByLongestName = [...repoByBasename.entries()].toSorted(([nameA], [nameB]) => nameB.length - nameA.length);
         let children;
         try {
             children = readdirSync(parentDir, { withFileTypes: true });
@@ -158,23 +172,14 @@ function listWorktrees(config) {
             if (!entry.isDirectory()) {
                 continue;
             }
-            const match = TASK_DIR_RE.exec(entry.name);
-            if (!match) {
-                continue;
-            }
-            const [, repoBasename, task] = match;
-            /* v8 ignore next 3 @preserve -- TASK_DIR_RE always captures both groups when it matches */
-            if (repoBasename === undefined || task === undefined) {
-                continue;
-            }
-            const repository = repoByBasename.get(repoBasename);
-            if (repository === undefined) {
+            const parsed = parseWorktreeDirectoryName(entry.name, repositoryEntriesByLongestName);
+            if (parsed === undefined) {
                 continue;
             }
             entries.push({
-                repository,
-                task,
-                branchName: branchNameForTask(config, task),
+                repository: parsed.repository,
+                task: parsed.task,
+                branchName: branchNameForTask(config, parsed.task),
                 dir: path.resolve(parentDir, entry.name),
                 kind: "host",
             });

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.1",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",