@clipboard-health/groundcrew 4.37.0 → 4.38.0

package/clearance-allow-hosts

@@ -73,6 +73,12 @@ conda.anaconda.org
 registry.npmjs.org
 www.npmjs.com
 
+# PyPI registry + package CDN (pip / uv). pypi.org serves the Simple index;
+# files.pythonhosted.org serves the wheel/sdist artifacts. uv's managed-Python
+# downloads come from github.com (already allowed above).
+files.pythonhosted.org
+pypi.org
+
 # Google APIs
 developers.google.com
 www.googleapis.com

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;AAiCD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAoOjE;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;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,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,CAyOjE;AA2BD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAQrE"}

package/dist/commands/dispatcher.js

@@ -6,7 +6,9 @@
  * Pure verdict logic lives in `eligibility.ts`; this module is responsible
  * for telemetry, writeback via Board, and side-effecting setupWorkspace calls.
  */
+import { sourcesFromConfig } from "../lib/buildSources.js";
 import { dispatchableRepository, formatKnownRepositories } from "../lib/repositoryValidation.js";
+import { sourceSupportsMarkDone } from "../lib/sourceCapabilities.js";
 import { isGroundcrewIssue, naturalIdFromCanonical, } from "../lib/taskSource.js";
 import { errorMessage, failMark, log, logEvent, styleWarning } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
@@ -35,6 +37,7 @@ function logMissingRepositorySkip(issue, agent, knownRepositories) {
 }
 export function createDispatcher(deps) {
     const { config, board } = deps;
+    const rawSources = sourcesFromConfig(config);
     function buildExhaustedSet(usage) {
         const exhausted = new Set();
         for (const exhaustion of classifyUsageExhaustion(config, usage)) {
@@ -71,6 +74,10 @@ export function createDispatcher(deps) {
                     repository: issue.repository,
                     task: taskId,
                     completionTaskId: issue.id,
+                    completionMarkDoneSupported: sourceSupportsMarkDone({
+                        rawSources,
+                        sourceName: issue.source,
+                    }),
                     agent: issue.agent,
                     details: {
                         title: issue.title,

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

@@ -1 +1 @@
-{"version":3,"file":"resumeWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/resumeWorkspace.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAgBnE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AA0ID,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAuFf;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}
+{"version":3,"file":"resumeWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/resumeWorkspace.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAiBnE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAqJD,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA0Ff;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}

package/dist/commands/resumeWorkspace.js

@@ -1,10 +1,11 @@
 import { fetchResolvedIssue } from "../lib/adapters/linear/fetch.js";
 import { getLinearClient } from "../lib/adapters/linear/client.js";
-import { isLinearEnabled } from "../lib/buildSources.js";
+import { isLinearEnabled, sourcesFromConfig } from "../lib/buildSources.js";
 import { loadConfig } from "../lib/config.js";
 import { composeAgentLaunch, openAgentWorkspace, prepareAgentLaunch } from "../lib/agentLaunch.js";
 import { workerEnvironmentForTask } from "../lib/launchCommand.js";
 import { readRunState, recordRunState } from "../lib/runState.js";
+import { taskSupportsCompletionCommand } from "../lib/sourceCapabilities.js";
 import { removeStagedPrompt, stageBuildSecrets, stagePromptText, stageWorkspaceLaunchCommand, } from "../lib/stagedLaunch.js";
 import { taskSourceWritePathsForCompletion } from "../lib/taskSourceFilesystem.js";
 import { naturalIdFromCanonical, toCanonicalId } from "../lib/taskSource.js";
@@ -33,6 +34,7 @@ async function fetchTaskDetails(task) {
 }
 async function contextFromLinear(config, task, worktree) {
     const resolved = await fetchResolvedIssue({ client: getLinearClient(), config, task });
+    const completionTaskId = toCanonicalId("linear", task);
     return {
         task,
         repository: resolved.repository,
@@ -40,7 +42,11 @@ async function contextFromLinear(config, task, worktree) {
         worktree,
         title: resolved.title,
         description: resolved.description,
-        completionTaskId: toCanonicalId("linear", task),
+        completionTaskId,
+        completionMarkDoneSupported: taskSupportsCompletionCommand({
+            rawSources: sourcesFromConfig(config),
+            taskId: completionTaskId,
+        }),
         resumeCount: 0,
     };
 }
@@ -49,6 +55,7 @@ async function contextFromState(config, task, state, worktree) {
     // missing-API-key error logs noisily even though resume only needs it to
     // enrich the prompt title/description (which falls back to the task id).
     const details = isLinearEnabled(config) ? await fetchTaskDetails(task) : undefined;
+    const completionTaskId = state.completionTaskId ?? task;
     return {
         task,
         repository: state.repository,
@@ -56,7 +63,11 @@ async function contextFromState(config, task, state, worktree) {
         worktree,
         title: details?.title ?? task.toUpperCase(),
         description: details?.description ?? "",
-        completionTaskId: state.completionTaskId ?? task,
+        completionTaskId,
+        completionMarkDoneSupported: taskSupportsCompletionCommand({
+            rawSources: sourcesFromConfig(config),
+            taskId: completionTaskId,
+        }),
         ...(state.reason === undefined ? {} : { reason: state.reason }),
         resumeCount: state.resumeCount,
     };
@@ -159,7 +170,10 @@ export async function resumeWorkspace(config, options) {
             secretsFile,
             sandboxName,
             workspaceKind,
-            workerEnvironment: workerEnvironmentForTask(context.completionTaskId),
+            workerEnvironment: workerEnvironmentForTask({
+                taskId: context.completionTaskId,
+                markDoneSupported: context.completionMarkDoneSupported,
+            }),
             taskSourceWritePaths,
         }));
         const launchCmd = stageWorkspaceLaunchCommand(stagedPrompt.directory, launchCommand);

package/dist/commands/setupWorkspace.d.ts

@@ -9,6 +9,8 @@ export interface SetupWorkspaceOptions {
     task: string;
     /** Canonical source id for worker self-completion; falls back to `task`. */
     completionTaskId?: string;
+    /** Whether the task source can apply `crew task done`; defaults to true for direct calls. */
+    completionMarkDoneSupported?: boolean;
     repository: string;
     agent: string;
     details: TaskDetails;

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

@@ -1 +1 @@
-{"version":3,"file":"setupWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/setupWorkspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAwBnE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAuBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,qBAAqB,EAC9B,UAAU,GAAE,wBAA6B,GACxC,OAAO,CAAC,IAAI,CAAC,CAwIf;AAgJD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CA6Cf"}
+{"version":3,"file":"setupWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/setupWorkspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAyBnE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6FAA6F;IAC7F,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAuBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,qBAAqB,EAC9B,UAAU,GAAE,wBAA6B,GACxC,OAAO,CAAC,IAAI,CAAC,CA4If;AAgJD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CAkDf"}

package/dist/commands/setupWorkspace.js

@@ -6,6 +6,7 @@ import { buildSources, sourcesFromConfig } from "../lib/buildSources.js";
 import { workerEnvironmentForTask } from "../lib/launchCommand.js";
 import { resolvePrepareWorktreeCommand } from "../lib/repositoryHooks.js";
 import { recordRunState } from "../lib/runState.js";
+import { sourceSupportsMarkDone } from "../lib/sourceCapabilities.js";
 import { stageBuildSecrets, stagePromptFromTemplate, stageWorkspaceLaunchCommand, } from "../lib/stagedLaunch.js";
 import { taskSourceWritePathsForCompletion } from "../lib/taskSourceFilesystem.js";
 import { naturalIdFromCanonical } from "../lib/taskSource.js";
@@ -83,6 +84,7 @@ export async function setupWorkspace(config, options, runOptions = {}) {
         });
         const secretsFile = prepareWorktreeCommand === undefined ? undefined : stageBuildSecrets(promptDir);
         const completionTaskId = options.completionTaskId ?? task;
+        const completionMarkDoneSupported = options.completionMarkDoneSupported ?? true;
         const taskSourceWritePaths = runner === "safehouse" || runner === "srt"
             ? taskSourceWritePathsForCompletion({
                 config,
@@ -101,7 +103,10 @@ export async function setupWorkspace(config, options, runOptions = {}) {
             prepareWorktreeCommand,
             sandboxName,
             workspaceKind,
-            workerEnvironment: workerEnvironmentForTask(completionTaskId),
+            workerEnvironment: workerEnvironmentForTask({
+                taskId: completionTaskId,
+                markDoneSupported: completionMarkDoneSupported,
+            }),
             taskSourceWritePaths,
         });
         srtSettingsDir = stagedSrtSettingsDir;
@@ -264,9 +269,10 @@ async function rollbackWorktree(arguments_) {
 }
 export async function setupWorkspaceCli(task, options = {}) {
     const config = await loadConfig();
+    const rawSources = sourcesFromConfig(config);
     let sources;
     try {
-        sources = await buildSources(sourcesFromConfig(config), { globalConfig: config });
+        sources = await buildSources(rawSources, { globalConfig: config });
     }
     catch (error) {
         /* v8 ignore next @preserve -- catch re-throw always receives an Error; String(error) is an unreachable fallback */
@@ -292,6 +298,10 @@ export async function setupWorkspaceCli(task, options = {}) {
     await setupWorkspace(config, {
         task: naturalId,
         completionTaskId: resolved.id,
+        completionMarkDoneSupported: sourceSupportsMarkDone({
+            rawSources,
+            sourceName: resolved.source,
+        }),
         repository: resolved.repository,
         agent: resolved.agent,
         details: {

package/dist/lib/config.js

@@ -108,7 +108,7 @@ const DEFAULT_PROMPT_INITIAL = [
     "2. Implement the smallest sensible change that completes the task.",
     "3. Run the repo's documented verification command. If no documented command exists, run the smallest relevant test suite you can find and fix failures you introduced before continuing.",
     "4. Follow the task description for output. If no output instructions exist, open a PR with `Closes {{task}}` in the description. If you cannot open one, leave the branch ready and record the blocker.",
-    "5. If the requested work is complete, no PR is needed, and any dirty worktree state is expected or explicitly allowed, run the command in `GROUNDCREW_COMPLETE` to mark the task done.",
+    "5. If the requested work is complete, no PR is needed, `GROUNDCREW_COMPLETE` is set, and any dirty worktree state is expected or explicitly allowed, run the command in `GROUNDCREW_COMPLETE` to mark the task done.",
 ].join("\n");
 const ALLOWED_PROMPT_PLACEHOLDERS = new Set([
     "{{task}}",

package/dist/lib/launchCommand.d.ts

@@ -37,10 +37,14 @@ export declare function isEnvironmentAssignment(token: string): boolean;
  * profile; srt uses it to pick the agent's credential profile in `srtPolicy`.
  */
 export declare function inferAgentCommandName(agentCmd: string): string;
-declare const WORKER_ENVIRONMENT_NAMES: readonly ["GROUNDCREW_TASK_ID", "GROUNDCREW_COMPLETE"];
-type WorkerEnvironmentName = (typeof WORKER_ENVIRONMENT_NAMES)[number];
-export type WorkerEnvironment = Readonly<Record<WorkerEnvironmentName, string>>;
-export declare function workerEnvironmentForTask(taskId: string): WorkerEnvironment;
+export type WorkerEnvironment = Readonly<{
+    GROUNDCREW_TASK_ID: string;
+    GROUNDCREW_COMPLETE?: string;
+}>;
+export declare function workerEnvironmentForTask(arguments_: {
+    taskId: string;
+    markDoneSupported: boolean;
+}): WorkerEnvironment;
 export interface SafehouseAgentIntegration {
     addDirsReadOnly: readonly string[];
     envPass: readonly string[];

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

@@ -1 +1 @@
-{"version":3,"file":"launchCommand.d.ts","sourceRoot":"","sources":["../../src/lib/launchCommand.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,GAAE,MAAwB,GAAG,MAAM,CAcvF;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,MAAwB,GAAG,MAAM,CAgB3E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,MAAM,CAMvF;AAsMD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8B9D;AAED,QAAA,MAAM,wBAAwB,YAAI,oBAAoB,EAAE,qBAAqB,CAAU,CAAC;AAExF,KAAK,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAK1E;AAsBD,MAAM,WAAW,yBAAyB;IACxC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,UAAU,sBAAsB;IAC9B,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C;;;;OAIG;IACH,MAAM,EAAE,WAAW,CAAC;IACpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACnE;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACjD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACtD;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;IAClE;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACnD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,sBAAsB,GAAG,MAAM,CAkC7E"}
+{"version":3,"file":"launchCommand.d.ts","sourceRoot":"","sources":["../../src/lib/launchCommand.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,GAAE,MAAwB,GAAG,MAAM,CAcvF;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,MAAwB,GAAG,MAAM,CAgB3E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,MAAM,CAMvF;AAsMD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8B9D;AAMD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC,CAAC;AAEH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,OAAO,CAAC;CAC5B,GAAG,iBAAiB,CAMpB;AA8BD,MAAM,WAAW,yBAAyB;IACxC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,UAAU,sBAAsB;IAC9B,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C;;;;OAIG;IACH,MAAM,EAAE,WAAW,CAAC;IACpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACnE;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACjD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACtD;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;IAClE;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACnD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,sBAAsB,GAAG,MAAM,CAkC7E"}

package/dist/lib/launchCommand.js

@@ -248,20 +248,31 @@ export function inferAgentCommandName(agentCmd) {
     return commandName;
 }
 const WORKER_ENVIRONMENT_NAMES = ["GROUNDCREW_TASK_ID", "GROUNDCREW_COMPLETE"];
-export function workerEnvironmentForTask(taskId) {
+export function workerEnvironmentForTask(arguments_) {
+    const { taskId, markDoneSupported } = arguments_;
     return {
         GROUNDCREW_TASK_ID: taskId,
-        GROUNDCREW_COMPLETE: `crew task done ${taskId}`,
+        ...(markDoneSupported ? { GROUNDCREW_COMPLETE: `crew task done ${taskId}` } : {}),
     };
 }
 function workerEnvironmentNames(workerEnvironment) {
-    return workerEnvironment === undefined ? [] : WORKER_ENVIRONMENT_NAMES;
+    if (workerEnvironment === undefined) {
+        return [];
+    }
+    return WORKER_ENVIRONMENT_NAMES.filter((name) => workerEnvironment[name] !== undefined);
 }
 function workerEnvironmentExports(workerEnvironment) {
     if (workerEnvironment === undefined) {
         return [];
     }
-    return WORKER_ENVIRONMENT_NAMES.map((name) => `export ${name}=${shellSingleQuote(workerEnvironment[name])}`);
+    const exports = [];
+    for (const name of WORKER_ENVIRONMENT_NAMES) {
+        const value = workerEnvironment[name];
+        if (value !== undefined) {
+            exports.push(`export ${name}=${shellSingleQuote(value)}`);
+        }
+    }
+    return exports;
 }
 function envPassFlag(names) {
     const uniqueNames = [...new Set(names)];

package/dist/lib/sourceCapabilities.d.ts

@@ -14,5 +14,13 @@ export interface SourceSummary {
     capabilities: SourceCapabilities;
 }
 export declare function summarizeSource(raw: unknown): SourceSummary;
+export declare function sourceSupportsMarkDone(arguments_: {
+    rawSources: readonly unknown[];
+    sourceName: string;
+}): boolean;
+export declare function taskSupportsCompletionCommand(arguments_: {
+    rawSources: readonly unknown[];
+    taskId: string;
+}): boolean;
 export {};
 //# sourceMappingURL=sourceCapabilities.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sourceCapabilities.d.ts","sourceRoot":"","sources":["../../src/lib/sourceCapabilities.ts"],"names":[],"mappings":"AAKA,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;AAoDD,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAiB3D"}
+{"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"}

package/dist/lib/sourceCapabilities.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { shellAdapterConfigSchema } from "./adapters/shell/schema.js";
-import { kindShape } from "./buildSources.js";
 const nameShape = z.looseObject({ name: z.string().optional() });
+const kindShape = z.object({ kind: z.string() });
 const LINEAR_CAPABILITIES = {
     verify: true,
     listTasks: true,
@@ -65,3 +65,28 @@ export function summarizeSource(raw) {
     }
     return { name: sourceName, kind, capabilities };
 }
+export function sourceSupportsMarkDone(arguments_) {
+    const { rawSources, sourceName } = arguments_;
+    for (const rawSource of rawSources) {
+        const source = summarizeSource(rawSource);
+        if (source.name === sourceName) {
+            return source.capabilities.markDone;
+        }
+    }
+    return false;
+}
+export function taskSupportsCompletionCommand(arguments_) {
+    const { rawSources, taskId } = arguments_;
+    const colonIndex = taskId.indexOf(":");
+    if (colonIndex === -1) {
+        const [singleSource] = rawSources;
+        if (rawSources.length === 1 && singleSource !== undefined) {
+            return summarizeSource(singleSource).capabilities.markDone;
+        }
+        return false;
+    }
+    return sourceSupportsMarkDone({
+        rawSources,
+        sourceName: taskId.slice(0, colonIndex),
+    });
+}

package/docs/runners.md

@@ -15,7 +15,7 @@
 
 Only applies when `local.runner` resolves to `safehouse`. Groundcrew starts `clearance` on `http://127.0.0.1:19999` and runs the agent through the bundled `safehouse-clearance` wrapper. Groundcrew automatically points clearance at its shipped starter allowlist, so a fresh install does not need a `CLEARANCE_ALLOW_HOSTS_FILES` export.
 
-Groundcrew ships that starter file at `$(npm root -g)/@clipboard-health/groundcrew/clearance-allow-hosts`, covering model APIs, Linear, Notion, Slack, Datadog, GitHub, npm, and common dev tooling.
+Groundcrew ships that starter file at `$(npm root -g)/@clipboard-health/groundcrew/clearance-allow-hosts`, covering model APIs, Linear, Notion, Slack, Datadog, GitHub, npm, PyPI, and common dev tooling.
 
 To add ad hoc hosts for one run, use `CLEARANCE_ALLOW_HOSTS`:
 

package/docs/task-sources.md

@@ -40,10 +40,11 @@ completed no-PR work. If omitted, groundcrew treats done advancement as
 unsupported and leaves the task for the source's own integration to close out.
 `${id}`, `${canonicalId}`, and `${name}` placeholders are shell-quoted before substitution.
 
-Workers receive `GROUNDCREW_TASK_ID` and `GROUNDCREW_COMPLETE` in their launch
-environment. The default prompt tells them to run `GROUNDCREW_COMPLETE` only
-when the requested work is complete, no PR is needed, and any dirty worktree
-state is expected or explicitly allowed.
+Workers receive `GROUNDCREW_TASK_ID` in their launch environment. They receive
+`GROUNDCREW_COMPLETE` only when the source supports done writeback. The default
+prompt tells them to run `GROUNDCREW_COMPLETE` only when it is set, the
+requested work is complete, no PR is needed, and any dirty worktree state is
+expected or explicitly allowed.
 
 ```json
 [

package/package.json

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