@clipboard-health/groundcrew 4.29.0 → 4.31.0

package/README.md

@@ -145,7 +145,7 @@ There is no `linear` config block. Groundcrew reads `GROUNDCREW_LINEAR_API_KEY`
 
 ## Reference
 
-- [Configuration](./docs/configuration.md): discovery order, repo layout, full config table, prompt customization.
+- [Configuration](./docs/configuration.md): discovery order, repo layout, scripted/sparse-checkout (graft) worktrees, full config table, prompt customization.
 - [Runners](./docs/runners.md): Safehouse, Docker Sandboxes, and the `none` escape hatch.
 - [Credentials](./docs/credentials.md): Linear API keys, 1Password, build secrets, and `preLaunch`.
 - [Prepare worktree hooks](./docs/setup-hooks.md): `.groundcrew/config.json` `hooks.prepareWorktree` for per-repo dependency setup.

package/crew.config.example.ts

@@ -26,6 +26,29 @@ export default {
     // form to point a repo at a different parent directory:
     //   { name: "other-org/other-repo", projectDirOverride: "~/work" }
     knownRepositories: ["your-org/your-repo"],
+    // A knownRepositories entry can also be an object that provisions the
+    // worktree with a custom command instead of `git worktree add` — e.g. a
+    // sparse checkout via `graft`. `repo` is a logical name (task token +
+    // worktree dir basename); the physical clone is the command's concern.
+    // Templates interpolate ${branch} ${dir} ${baseRef} ${repo} ${task}.
+    //
+    //   {
+    //     name: "billing",
+    //     provision: {
+    //       create: "graft new ${branch} billing --from ${baseRef} --dir ${dir}",
+    //       remove: "graft rm ${branch} -f",
+    //     },
+    //     // Optional: run the agent, prepareWorktree hook, and
+    //     // .groundcrew/config.json lookup in this subdirectory of the
+    //     // checkout (relative, no ".."). Use it when the checkout is a
+    //     // monorepo whose project lives in a subdir.
+    //     workdir: "services/billing",
+    //   },
+    //
+    // Set up graft once outside groundcrew:
+    //   graft repo add ~/dev/owner/monorepo
+    //   graft alias add billing services/billing libs/common
+    // `crew doctor` does not parse or validate these shell templates.
   },
   agents: {
     default: "claude",

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;AAenE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAuID,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"}
+{"version":3,"file":"resumeWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/resumeWorkspace.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAanE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAuID,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA2Ef;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}

package/dist/commands/resumeWorkspace.js

@@ -2,14 +2,12 @@ import { fetchResolvedIssue } from "../lib/adapters/linear/fetch.js";
 import { getLinearClient } from "../lib/adapters/linear/client.js";
 import { isLinearEnabled } from "../lib/buildSources.js";
 import { loadConfig } from "../lib/config.js";
-import { openAgentWorkspace, prepareAgentLaunch } from "../lib/agentLaunch.js";
-import { buildLaunchCommand } from "../lib/launchCommand.js";
+import { composeAgentLaunch, openAgentWorkspace, prepareAgentLaunch } from "../lib/agentLaunch.js";
 import { readRunState, recordRunState } from "../lib/runState.js";
-import { buildAndStageSrtLaunch } from "../lib/srtLaunch.js";
 import { removeStagedPrompt, stageBuildSecrets, stagePromptText, stageWorkspaceLaunchCommand, } from "../lib/stagedLaunch.js";
 import { errorMessage, log } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
-import { worktrees } from "../lib/worktrees.js";
+import { resolveLaunchDir, worktrees } from "../lib/worktrees.js";
 function parseArguments(argv) {
     const [task, ...extras] = argv;
     if (task === undefined || task.length === 0 || extras.length > 0 || task.startsWith("-")) {
@@ -124,50 +122,36 @@ export async function resumeWorkspace(config, options) {
         purpose: "resumes",
     });
     await ensureReady();
+    const worktreeDir = context.worktree.dir;
+    const launchDir = resolveLaunchDir(config, context.repository, worktreeDir);
     const stagedPrompt = stagePromptText({
         prefix: "groundcrew-resume",
         task,
         text: renderResumePrompt(context),
     });
     const secretsFile = stageBuildSecrets(stagedPrompt.directory);
-    // Resume must stage srt settings exactly like setup, or `buildLaunchCommand`
-    // throws under the srt runner — and a relocating agent (codex) needs its
-    // config home re-seeded so it authenticates on the resumed launch.
-    let srtPrepareSettingsFile;
-    let srtAgentSettingsFile;
+    // Resume stages srt settings exactly like setup (a relocating agent such as
+    // codex needs its config home re-seeded to authenticate on the resumed launch).
+    // Composition runs inside the try so a pre-launch failure still cleans up the
+    // staged prompt (and any srt settings) dir.
     let srtSettingsDir;
-    let srtAgentConfigDirEnv;
-    if (runner === "srt") {
-        const staged = buildAndStageSrtLaunch({
-            config,
-            repository: context.repository,
+    try {
+        let launchCommand;
+        ({ launchCommand, srtSettingsDir } = composeAgentLaunch({
+            runner,
             task,
-            worktreeDir: context.worktree.dir,
             definition,
-        });
-        srtPrepareSettingsFile = staged.prepareFile;
-        srtAgentSettingsFile = staged.agentFile;
-        srtSettingsDir = staged.directory;
-        srtAgentConfigDirEnv = staged.agentConfigDirEnv;
-    }
-    const launchCommand = buildLaunchCommand({
-        definition,
-        promptFile: stagedPrompt.file,
-        worktreeDir: context.worktree.dir,
-        secretsFile,
-        runner,
-        sandboxName,
-        srtPrepareSettingsFile,
-        srtAgentSettingsFile,
-        srtSettingsDir,
-        srtAgentConfigDirEnv,
-    });
-    const launchCmd = stageWorkspaceLaunchCommand(stagedPrompt.directory, launchCommand);
-    try {
+            promptFile: stagedPrompt.file,
+            worktreeDir,
+            workingDir: launchDir,
+            secretsFile,
+            sandboxName,
+        }));
+        const launchCmd = stageWorkspaceLaunchCommand(stagedPrompt.directory, launchCommand);
         await openAgentWorkspace({
             config,
             name: task,
-            cwd: context.worktree.dir,
+            cwd: launchDir,
             command: launchCmd,
             agent: context.agent,
             color: definition.color,

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;AAmBnE,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,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,CA0If;AA8ID,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CA4Cf"}
+{"version":3,"file":"setupWorkspace.d.ts","sourceRoot":"","sources":["../../src/commands/setupWorkspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAsBnE,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,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,CA0Hf;AA8ID,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CA4Cf"}

package/dist/commands/setupWorkspace.js

@@ -1,17 +1,15 @@
 import { rmSync } from "node:fs";
 import { loadConfig } from "../lib/config.js";
-import { openAgentWorkspace, prepareAgentLaunch } from "../lib/agentLaunch.js";
+import { composeAgentLaunch, openAgentWorkspace, prepareAgentLaunch } from "../lib/agentLaunch.js";
 import { createBoard } from "../lib/board.js";
 import { buildSources, sourcesFromConfig } from "../lib/buildSources.js";
-import { buildLaunchCommand } from "../lib/launchCommand.js";
 import { resolvePrepareWorktreeCommand } from "../lib/repositoryHooks.js";
 import { recordRunState } from "../lib/runState.js";
-import { buildAndStageSrtLaunch } from "../lib/srtLaunch.js";
 import { stageBuildSecrets, stagePromptFromTemplate, stageWorkspaceLaunchCommand, } from "../lib/stagedLaunch.js";
 import { naturalIdFromCanonical } from "../lib/taskSource.js";
 import { debug, errorMessage, log, okMark } from "../lib/util.js";
 import { workspaces } from "../lib/workspaces.js";
-import { isWorktreeAlreadyExistsError, worktrees } from "../lib/worktrees.js";
+import { isWorktreeAlreadyExistsError, resolveLaunchDir, worktrees, } from "../lib/worktrees.js";
 function stagePrompt(input) {
     return stagePromptFromTemplate({
         config: input.config,
@@ -53,7 +51,8 @@ export async function setupWorkspace(config, options, runOptions = {}) {
         }
         throw error;
     }
-    const { branchName, dir: launchDir } = created;
+    const { branchName, dir: worktreeDir } = created;
+    const launchDir = resolveLaunchDir(config, repository, worktreeDir);
     const worktreeName = `${repository}-${task}`;
     // Anything that fails after the worktree is on disk must roll it back
     // (the worktree and the just-created branch). `workspaces.open` cleans
@@ -81,35 +80,18 @@ export async function setupWorkspace(config, options, runOptions = {}) {
             defaultHooks: config.defaults.hooks,
         });
         const secretsFile = prepareWorktreeCommand === undefined ? undefined : stageBuildSecrets(promptDir);
-        let srtPrepareSettingsFile;
-        let srtAgentSettingsFile;
-        let srtAgentConfigDirEnv;
-        if (runner === "srt") {
-            const staged = buildAndStageSrtLaunch({
-                config,
-                repository,
-                task,
-                worktreeDir: launchDir,
-                definition,
-            });
-            srtPrepareSettingsFile = staged.prepareFile;
-            srtAgentSettingsFile = staged.agentFile;
-            srtSettingsDir = staged.directory;
-            srtAgentConfigDirEnv = staged.agentConfigDirEnv;
-        }
-        const launchCommand = buildLaunchCommand({
+        const { launchCommand, srtSettingsDir: stagedSrtSettingsDir } = composeAgentLaunch({
+            runner,
+            task,
             definition,
             promptFile: stagedPrompt.file,
-            worktreeDir: launchDir,
+            worktreeDir,
+            workingDir: launchDir,
             secretsFile,
             prepareWorktreeCommand,
-            runner,
             sandboxName,
-            srtPrepareSettingsFile,
-            srtAgentSettingsFile,
-            srtSettingsDir,
-            srtAgentConfigDirEnv,
         });
+        srtSettingsDir = stagedSrtSettingsDir;
         const launchCmd = stageWorkspaceLaunchCommand(promptDir, launchCommand);
         debug("Opening workspace...");
         await openAgentWorkspace({
@@ -126,7 +108,7 @@ export async function setupWorkspace(config, options, runOptions = {}) {
             task,
             repository,
             agent,
-            worktreeDir: launchDir,
+            worktreeDir,
             branchName,
             workspaceName: task,
             state: "running",
@@ -147,7 +129,7 @@ export async function setupWorkspace(config, options, runOptions = {}) {
             task,
             repository,
             agent,
-            worktreeDir: launchDir,
+            worktreeDir,
             branchName,
             workspaceName: task,
             state: "failed-to-launch",

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { orchestrate, type OrchestratorOptions } from "./commands/orchestrator.t
 export { resumeWorkspace, type ResumeWorkspaceOptions } from "./commands/resumeWorkspace.ts";
 export { setupWorkspace, type SetupWorkspaceOptions } from "./commands/setupWorkspace.ts";
 export { status, type StatusOptions } from "./commands/status.ts";
-export type { Config, HookCommands, AgentDefinition, ResolvedConfig, SourceConfig, } from "./lib/config.ts";
+export type { Config, HookCommands, AgentDefinition, KnownRepository, ResolvedConfig, SourceConfig, } from "./lib/config.ts";
 export { loadConfig } from "./lib/config.ts";
 export { readRunState, recordRunState, removeRunState, runStateDirectory, runStatePath, updateRunState, type RunLifecycleState, type RunState, } from "./lib/runState.ts";
 export { fetchBlockersForTask, fetchInProgressIssueCount, fetchRawLinearIssue, fetchResolvedIssue, isIssueInProgress, isIssueTodo, isTerminalStateType, isTerminalStatusForBlocker, isTerminalStatusForIssue, type RawLinearIssue, } from "./lib/adapters/linear/fetch.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAClE,YAAY,EACV,MAAM,EACN,YAAY,EACZ,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,QAAQ,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,KAAK,cAAc,GACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,KAAK,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,aAAa,EACb,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,KAAK,OAAO,IAAI,gBAAgB,EAChC,KAAK,UAAU,IAAI,mBAAmB,EACtC,KAAK,eAAe,EACpB,KAAK,eAAe,IAAI,wBAAwB,EAChD,KAAK,KAAK,IAAI,cAAc,EAC5B,iBAAiB,IAAI,0BAA0B,EAC/C,KAAK,UAAU,IAAI,mBAAmB,EACtC,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAClE,YAAY,EACV,MAAM,EACN,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,QAAQ,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,KAAK,cAAc,GACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,KAAK,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,aAAa,EACb,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,KAAK,OAAO,IAAI,gBAAgB,EAChC,KAAK,UAAU,IAAI,mBAAmB,EACtC,KAAK,eAAe,EACpB,KAAK,eAAe,IAAI,wBAAwB,EAChD,KAAK,KAAK,IAAI,cAAc,EAC5B,iBAAiB,IAAI,0BAA0B,EAC/C,KAAK,UAAU,IAAI,mBAAmB,EACtC,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC"}

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

@@ -1,7 +1,7 @@
 /**
  * Shell-adapter `TaskSource` factory. Wires `invokeShellCommand` to the
- * four TaskSource operations and applies the ShellIssue Zod schema for
- * runtime validation of script stdout.
+ * TaskSource operations and applies the ShellIssue Zod schema for runtime
+ * validation of script stdout.
  *
  * Fallback behavior for omitted commands:
  *  - `verify` absent → no-op (always succeeds).
@@ -13,6 +13,10 @@
  *  - `markInProgress` absent → silent no-op.
  *  - `markInReview` absent → reports unsupported.
  *  - `markDone` absent → reports unsupported.
+ *  - `createTask` absent → method omitted entirely (source reports it cannot
+ *    create tasks; the optional method is attached only when configured).
+ *  - `validate` absent → method omitted entirely (same capability-detection
+ *    contract as createTask).
  *  - `fetch` is required by the Zod schema.
  */
 import type { AdapterContext } from "../../adapterDefinition.ts";

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

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAGL,KAAK,KAAK,IAAI,cAAc,EAG5B,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,KAAK,kBAAkB,EAEvB,KAAK,UAAU,EAEhB,MAAM,aAAa,CAAC;AAkErB,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAuB3F;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,cAAc,GACvB,UAAU,CAyHZ"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAIL,KAAK,KAAK,IAAI,cAAc,EAG5B,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,KAAK,kBAAkB,EAEvB,KAAK,UAAU,EAGhB,MAAM,aAAa,CAAC;AAyErB,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAuB3F;AA8BD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,cAAc,GACvB,UAAU,CA6LZ"}

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

@@ -1,7 +1,7 @@
 /**
  * Shell-adapter `TaskSource` factory. Wires `invokeShellCommand` to the
- * four TaskSource operations and applies the ShellIssue Zod schema for
- * runtime validation of script stdout.
+ * TaskSource operations and applies the ShellIssue Zod schema for runtime
+ * validation of script stdout.
  *
  * Fallback behavior for omitted commands:
  *  - `verify` absent → no-op (always succeeds).
@@ -13,12 +13,16 @@
  *  - `markInProgress` absent → silent no-op.
  *  - `markInReview` absent → reports unsupported.
  *  - `markDone` absent → reports unsupported.
+ *  - `createTask` absent → method omitted entirely (source reports it cannot
+ *    create tasks; the optional method is attached only when configured).
+ *  - `validate` absent → method omitted entirely (same capability-detection
+ *    contract as createTask).
  *  - `fetch` is required by the Zod schema.
  */
 import { toCanonicalId, } from "../../taskSource.js";
-import { writeError } from "../../util.js";
+import { errorMessage, writeError } from "../../util.js";
 import { invokeShellCommand } from "./invoke.js";
-import { shellFetchOutputSchema, shellIssueSchema, } from "./schema.js";
+import { shellFetchOutputSchema, shellIssueSchema, shellValidateOutputSchema, } from "./schema.js";
 const DEFAULT_TIMEOUTS = {
     verify: 10_000,
     listTasks: 30_000,
@@ -26,15 +30,20 @@ const DEFAULT_TIMEOUTS = {
     markInProgress: 10_000,
     markInReview: 10_000,
     markDone: 10_000,
+    createTask: 30_000,
+    validate: 30_000,
 };
 function mergeTimeouts(overrides) {
+    const o = overrides ?? {};
     return {
-        verify: overrides?.verify ?? DEFAULT_TIMEOUTS.verify,
-        listTasks: overrides?.listTasks ?? overrides?.fetch ?? DEFAULT_TIMEOUTS.listTasks,
-        getTask: overrides?.getTask ?? overrides?.resolveOne ?? DEFAULT_TIMEOUTS.getTask,
-        markInProgress: overrides?.markInProgress ?? DEFAULT_TIMEOUTS.markInProgress,
-        markInReview: overrides?.markInReview ?? DEFAULT_TIMEOUTS.markInReview,
-        markDone: overrides?.markDone ?? DEFAULT_TIMEOUTS.markDone,
+        verify: o.verify ?? DEFAULT_TIMEOUTS.verify,
+        listTasks: o.listTasks ?? o.fetch ?? DEFAULT_TIMEOUTS.listTasks,
+        getTask: o.getTask ?? o.resolveOne ?? DEFAULT_TIMEOUTS.getTask,
+        markInProgress: o.markInProgress ?? DEFAULT_TIMEOUTS.markInProgress,
+        markInReview: o.markInReview ?? DEFAULT_TIMEOUTS.markInReview,
+        markDone: o.markDone ?? DEFAULT_TIMEOUTS.markDone,
+        createTask: o.createTask ?? DEFAULT_TIMEOUTS.createTask,
+        validate: o.validate ?? DEFAULT_TIMEOUTS.validate,
     };
 }
 function warnDuplicate(sourceName, preferred, legacy) {
@@ -85,6 +94,33 @@ export function toCanonicalIssue(shellIssue, sourceName) {
         sourceRef: shellIssue.sourceRef,
     };
 }
+/**
+ * Flatten a CreateTaskInput into the `${...}` substitution map the createTask
+ * script receives. Every key is always present — absent optionals become an
+ * empty string — so no placeholder is ever left literally in the command.
+ * List fields are comma-joined into a single value.
+ */
+function createTaskSubstitutions(input) {
+    return {
+        title: input.title,
+        agent: input.agent,
+        // Exposed under both `repo` (short form) and `repository` (matches the
+        // CreateTaskInput field name) so either placeholder resolves.
+        repo: input.repository ?? "",
+        repository: input.repository ?? "",
+        team: input.team ?? "",
+        id: input.id ?? "",
+        priority: input.priority ?? "",
+        due: input.due ?? "",
+        recurrence: input.recurrence ?? "",
+        promptFile: input.promptFile ?? "",
+        description: input.description ?? "",
+        edit: input.edit ? "true" : "",
+        projects: input.projects.join(","),
+        contexts: input.contexts.join(","),
+        dependencies: input.dependencies.join(","),
+    };
+}
 export function createShellTaskSource(config, _context) {
     const sourceName = config.name;
     const timeouts = mergeTimeouts(config.timeouts);
@@ -149,7 +185,7 @@ export function createShellTaskSource(config, _context) {
             sourceName,
         });
     }
-    return {
+    const source = {
         name: sourceName,
         async verify() {
             const verifyCommand = config.commands.verify;
@@ -198,4 +234,66 @@ export function createShellTaskSource(config, _context) {
             return { outcome: "applied" };
         },
     };
+    // createTask / validate are attached only when their command is configured.
+    // Capability detection keys off `source.createTask === undefined` /
+    // `source.validate === undefined`, so a slot left unset must leave the
+    // method genuinely absent rather than present-but-failing.
+    const createTaskCommand = config.commands.createTask;
+    if (createTaskCommand !== undefined) {
+        source.createTask = async (input) => {
+            const { stdout, exitCode } = await invokeShellCommand({
+                command: createTaskCommand,
+                timeoutMs: timeouts.createTask,
+                cwd: config.cwd,
+                env: config.env,
+                substitutions: createTaskSubstitutions(input),
+                sourceName,
+            });
+            // invokeShellCommand resolves (does not throw) on exit 3 — its "not
+            // found" sentinel for lookups. Creation has no not-found concept, so any
+            // nonzero exit is a failure: surface it rather than parse partial output.
+            if (exitCode === 3) {
+                throw new Error(`shell source "${sourceName}" createTask command exited 3 (not-found); task creation cannot signal not-found`);
+            }
+            const trimmed = stdout.trim();
+            if (trimmed.length === 0) {
+                throw new Error(`shell source "${sourceName}" createTask command produced no output (expected one ShellIssue JSON)`);
+            }
+            const parsed = shellIssueSchema.parse(JSON.parse(trimmed));
+            return toCanonicalIssue(parsed, sourceName);
+        };
+    }
+    const validateCommand = config.commands.validate;
+    if (validateCommand !== undefined) {
+        source.validate = async () => {
+            try {
+                const { stdout, exitCode } = await invokeShellCommand({
+                    command: validateCommand,
+                    timeoutMs: timeouts.validate,
+                    cwd: config.cwd,
+                    env: config.env,
+                    sourceName,
+                });
+                // exit 3 is invoke's lookup "not found" sentinel; for validation it is
+                // not a meaningful success, so surface it as a failure (and validate
+                // never throws — return the failure as an error string).
+                if (exitCode === 3) {
+                    return [
+                        `shell source "${sourceName}" validate command exited 3 (not-found); treating as a validation failure`,
+                    ];
+                }
+                const trimmed = stdout.trim();
+                if (trimmed.length === 0) {
+                    return [];
+                }
+                return shellValidateOutputSchema.parse(JSON.parse(trimmed));
+            }
+            catch (error) {
+                // Contract: validate() never throws — fold a nonzero exit, timeout,
+                // malformed JSON, or wrong-shape payload into a single error string.
+                return [`shell source "${sourceName}" validate command failed: ${errorMessage(error)}`];
+            }
+        };
+    }
+    return source;
 }

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

@@ -80,6 +80,12 @@ export declare const shellFetchOutputSchema: z.ZodArray<z.ZodObject<{
     url: z.ZodOptional<z.ZodURL>;
     sourceRef: z.ZodUnknown;
 }, z.core.$strip>>;
+/**
+ * Shape a `commands.validate` script must emit on stdout: a JSON array of
+ * human-readable error strings. An empty array (or empty stdout, handled by
+ * the factory) means "no problems found".
+ */
+export declare const shellValidateOutputSchema: z.ZodArray<z.ZodString>;
 export declare const shellAdapterConfigSchema: z.ZodObject<{
     kind: z.ZodLiteral<"shell">;
     name: z.ZodString;
@@ -92,6 +98,8 @@ export declare const shellAdapterConfigSchema: z.ZodObject<{
         markInProgress: z.ZodOptional<z.ZodString>;
         markInReview: z.ZodOptional<z.ZodString>;
         markDone: z.ZodOptional<z.ZodString>;
+        createTask: z.ZodOptional<z.ZodString>;
+        validate: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     cwd: z.ZodOptional<z.ZodString>;
     timeouts: z.ZodOptional<z.ZodObject<{
@@ -103,6 +111,8 @@ export declare const shellAdapterConfigSchema: z.ZodObject<{
         markInProgress: z.ZodOptional<z.ZodNumber>;
         markInReview: z.ZodOptional<z.ZodNumber>;
         markDone: z.ZodOptional<z.ZodNumber>;
+        createTask: z.ZodOptional<z.ZodNumber>;
+        validate: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>;

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiB3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA4B,CAAC;AAEhE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;iBAiDnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/shell/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiB3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA4B,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,yBAAsB,CAAC;AAE7D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkEnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

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

@@ -36,6 +36,12 @@ export const shellIssueSchema = z.object({
     sourceRef: z.unknown(),
 });
 export const shellFetchOutputSchema = z.array(shellIssueSchema);
+/**
+ * Shape a `commands.validate` script must emit on stdout: a JSON array of
+ * human-readable error strings. An empty array (or empty stdout, handled by
+ * the factory) means "no problems found".
+ */
+export const shellValidateOutputSchema = z.array(z.string());
 export const shellAdapterConfigSchema = z.object({
     kind: z.literal("shell"),
     name: z
@@ -55,6 +61,19 @@ export const shellAdapterConfigSchema = z.object({
         markInProgress: z.string().optional(),
         markInReview: z.string().optional(),
         markDone: z.string().optional(),
+        /**
+         * Create a task from a `CreateTaskInput`. Receives the input fields as
+         * shell-quoted `${...}` placeholders (see factory) and must print one
+         * ShellIssue JSON on stdout. Omitting it leaves the source unable to
+         * create tasks.
+         */
+        createTask: z.string().optional(),
+        /**
+         * Validate task content. Must print a JSON array of error strings on
+         * stdout (empty array / empty stdout = no problems). Omitting it leaves
+         * the source unable to validate.
+         */
+        validate: z.string().optional(),
     })
         .superRefine((commands, ctx) => {
         if (commands.listTasks === undefined && commands.fetch === undefined) {
@@ -82,6 +101,10 @@ export const shellAdapterConfigSchema = z.object({
         markInProgress: z.number().int().positive().optional(),
         markInReview: z.number().int().positive().optional(),
         markDone: z.number().int().positive().optional(),
+        /** Timeout for the createTask command. */
+        createTask: z.number().int().positive().optional(),
+        /** Timeout for the validate command. */
+        validate: z.number().int().positive().optional(),
     })
         .optional(),
     env: z.record(z.string(), z.string()).optional(),

package/dist/lib/agentLaunch.d.ts

@@ -1,4 +1,25 @@
 import { type LocalRunner, type AgentDefinition, type ResolvedConfig } from "./config.ts";
+/**
+ * Stage any srt settings and build the workspace launch command — the assembly
+ * shared verbatim by `setupWorkspace` (fresh runs) and `resumeWorkspace`
+ * (resumes). `worktreeDir` is the checkout root (srt grants + `{{worktree}}`);
+ * `workingDir` is the agent cwd (the worktree root, or its `workdir` subproject).
+ * Returns `srtSettingsDir` so callers can tear it down on a pre-launch failure.
+ */
+export declare function composeAgentLaunch(input: {
+    runner: LocalRunner;
+    task: string;
+    definition: AgentDefinition;
+    promptFile: string;
+    worktreeDir: string;
+    workingDir: string;
+    secretsFile?: string | undefined;
+    prepareWorktreeCommand?: string | undefined;
+    sandboxName?: string | undefined;
+}): {
+    launchCommand: string;
+    srtSettingsDir: string | undefined;
+};
 interface PreparedAgentLaunch {
     runner: LocalRunner;
     sandboxName: string | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"agentLaunch.d.ts","sourceRoot":"","sources":["../../src/lib/agentLaunch.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAOrB,UAAU,mBAAmB;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA+C/B;AAqBD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB"}
+{"version":3,"file":"agentLaunch.d.ts","sourceRoot":"","sources":["../../src/lib/agentLaunch.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AASrB;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,GAAG;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAwBhE;AAED,UAAU,mBAAmB;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA+C/B;AAqBD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB"}

package/dist/lib/agentLaunch.js

@@ -1,10 +1,43 @@
 import { ensureClearance } from "@clipboard-health/clearance";
 import { hasPreLaunchEnv, } from "./config.js";
 import { detectHostCapabilities } from "./host.js";
+import { buildLaunchCommand } from "./launchCommand.js";
 import { assertLocalRunnerRequirements, resolveLocalRunner } from "./localRunner.js";
 import { sandboxNameFor } from "./sandboxName.js";
+import { buildAndStageSrtLaunch } from "./srtLaunch.js";
 import { debug, sleep } from "./util.js";
 import { workspaces } from "./workspaces.js";
+/**
+ * Stage any srt settings and build the workspace launch command — the assembly
+ * shared verbatim by `setupWorkspace` (fresh runs) and `resumeWorkspace`
+ * (resumes). `worktreeDir` is the checkout root (srt grants + `{{worktree}}`);
+ * `workingDir` is the agent cwd (the worktree root, or its `workdir` subproject).
+ * Returns `srtSettingsDir` so callers can tear it down on a pre-launch failure.
+ */
+export function composeAgentLaunch(input) {
+    const staged = input.runner === "srt"
+        ? buildAndStageSrtLaunch({
+            task: input.task,
+            worktreeDir: input.worktreeDir,
+            definition: input.definition,
+        })
+        : undefined;
+    const launchCommand = buildLaunchCommand({
+        definition: input.definition,
+        promptFile: input.promptFile,
+        worktreeDir: input.worktreeDir,
+        workingDir: input.workingDir,
+        secretsFile: input.secretsFile,
+        prepareWorktreeCommand: input.prepareWorktreeCommand,
+        runner: input.runner,
+        sandboxName: input.sandboxName,
+        srtPrepareSettingsFile: staged?.prepareFile,
+        srtAgentSettingsFile: staged?.agentFile,
+        srtSettingsDir: staged?.directory,
+        srtAgentConfigDirEnv: staged?.agentConfigDirEnv,
+    });
+    return { launchCommand, srtSettingsDir: staged?.directory };
+}
 export async function prepareAgentLaunch(input) {
     const host = await detectHostCapabilities(input.signal);
     const runner = resolveLocalRunner(input.config.local.runner, host);