@astroanywhere/agent 0.4.3 → 0.5.0

package/dist/lib/worktree.d.ts

@@ -11,8 +11,12 @@ export interface WorktreeOptions {
     agentDir?: string;
     /** Target branch from dispatch — takes priority over .astro/config.json and auto-detection */
     baseBranch?: string;
-    /** Project-level accumulation branch (e.g., 'astro/7b19a9'). Task branches from this instead of main. */
-    projectBranch?: string;
+    /** Delivery branch for this task's connected component (e.g., 'astro/7b19a9-e4f1a2').
+     *  In multi-task mode, task branches are created from this branch.
+     *  In singleton mode, the agent works directly on this branch. */
+    deliveryBranch?: string;
+    /** If true, work directly on the delivery branch (singleton component — no task sub-branch). */
+    deliveryBranchIsSingleton?: boolean;
     stdout?: (data: string) => void;
     stderr?: (data: string) => void;
     /** Emit structured operational activity lines */
@@ -23,16 +27,16 @@ export interface WorktreeOptions {
 export interface WorktreeSetup {
     workingDirectory: string;
     branchName: string;
-    /** The base branch the worktree was created from (project branch or default branch) */
+    /** The base branch the worktree was created from (delivery branch or default branch) */
     baseBranch: string;
     /** Git SHA of the start point before this task's work */
     commitBeforeSha?: string;
     /** Absolute path to the git root directory (for local merge operations) */
     gitRoot: string;
-    /** Project accumulation branch name, if applicable (e.g., 'astro/7b19a9') */
-    projectBranch?: string;
-    /** Absolute path to the persistent project worktree (detached HEAD), if created */
-    projectWorktreePath?: string;
+    /** Delivery branch name, if applicable (e.g., 'astro/7b19a9-e4f1a2') */
+    deliveryBranch?: string;
+    /** Absolute path to the persistent delivery worktree (detached HEAD), if created */
+    deliveryWorktreePath?: string;
     cleanup: (options?: {
         keepBranch?: boolean;
     }) => Promise<void>;
@@ -45,42 +49,42 @@ export declare function createWorktree(options: WorktreeOptions): Promise<Worktr
  */
 export declare function removeLingeringWorktrees(gitRoot: string, branchName: string): Promise<void>;
 /**
- * Create a persistent project-level worktree using detached HEAD.
+ * Create a persistent delivery worktree using detached HEAD.
  *
- * The project worktree lives at {baseRoot}/{shortProjectId}/ and mirrors
- * the project branch on disk. It uses `--detach` so the project branch
- * ref remains free for temporary merge worktrees (localMergeIntoProjectBranch
- * checks out the project branch — git prevents the same branch in two worktrees).
+ * The delivery worktree lives at {baseRoot}/{shortProjectId}/ and mirrors
+ * the delivery branch on disk. It uses `--detach` so the delivery branch
+ * ref remains free for temporary merge worktrees (localMergeIntoDeliveryBranch
+ * checks out the delivery branch — git prevents the same branch in two worktrees).
  *
  * Idempotent — safe to call on every task dispatch. If the worktree
  * already exists, returns the existing path.
  */
-export declare function createProjectWorktree(gitRoot: string, projectBranch: string, baseRoot: string, shortProjectId: string, operational?: (message: string, source: 'astro' | 'git' | 'delivery') => void): Promise<string | null>;
+export declare function createDeliveryWorktree(gitRoot: string, deliveryBranch: string, baseRoot: string, shortProjectId: string, operational?: (message: string, source: 'astro' | 'git' | 'delivery') => void): Promise<string | null>;
 /**
- * Sync the persistent project worktree to the latest project branch tip.
+ * Sync the persistent delivery worktree to the latest delivery branch tip.
  *
- * After each successful merge (branch or PR mode), the project branch moves
- * forward. This updates the detached HEAD in the project worktree so the
+ * After each successful merge (branch or PR mode), the delivery branch moves
+ * forward. This updates the detached HEAD in the delivery worktree so the
  * files on disk reflect the latest state.
  *
  * Ref selection:
- * - Branch mode (no remote): localMergeIntoProjectBranch() advances
- *   refs/heads/{projectBranch} directly → use the local ref.
- * - PR mode (has remote): GitHub merge advances origin/{projectBranch},
+ * - Branch mode (no remote): localMergeIntoDeliveryBranch() advances
+ *   refs/heads/{deliveryBranch} directly → use the local ref.
+ * - PR mode (has remote): GitHub merge advances origin/{deliveryBranch},
  *   but refs/heads/ is stale (no local commit) → fetch then use remote ref.
  *
  * Non-fatal — sync failure doesn't affect task completion.
  */
-export declare function syncProjectWorktree(projectWorktreePath: string, projectBranch: string, gitRoot: string): Promise<void>;
+export declare function syncDeliveryWorktree(deliveryWorktreePath: string, deliveryBranch: string, gitRoot: string): Promise<void>;
 /**
- * Remove the persistent project worktree.
+ * Remove the persistent delivery worktree.
  *
  * This is an exported utility for the astro platform to call when a project
  * is deleted. The agent-runner does not manage project lifecycles — it only
  * provides the building blocks. The integration point (calling this on
  * project deletion) lives in the astro server, not here.
  */
-export declare function cleanupProjectWorktree(gitRoot: string, projectWorktreePath: string): Promise<void>;
+export declare function cleanupDeliveryWorktree(gitRoot: string, deliveryWorktreePath: string): Promise<void>;
 /**
  * Ensure CLAUDE.md is available in the worktree.
  *
@@ -93,4 +97,5 @@ export declare function cleanupProjectWorktree(gitRoot: string, projectWorktreeP
  * task execution.
  */
 export declare function ensureClaudeMdInWorktree(gitRoot: string, worktreePath: string): Promise<void>;
+export declare function getGitRoot(workingDirectory: string): Promise<string | null>;
 //# sourceMappingURL=worktree.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/lib/worktree.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yGAAyG;IACzG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,iDAAiD;IACjD,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,UAAU,KAAK,IAAI,CAAC;IAC9E,yFAAyF;IACzF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAyQ/B;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CjG;AA2GD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,UAAU,KAAK,IAAI,GAC5E,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkCxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACvC,mBAAmB,EAAE,MAAM,EAC3B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC,IAAI,CAAC,CAiBf;AA6ND;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAsBf"}
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/lib/worktree.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;sEAEkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,iDAAiD;IACjD,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,UAAU,KAAK,IAAI,CAAC;IAC9E,yFAAyF;IACzF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA6U/B;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CjG;AA2GD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,UAAU,KAAK,IAAI,GAC5E,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkCxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CACxC,oBAAoB,EAAE,MAAM,EAC5B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,oBAAoB,EAAE,MAAM,GAC3B,OAAO,CAAC,IAAI,CAAC,CAiBf;AA6ND;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAsBf;AA8BD,wBAAsB,UAAU,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYjF"}