@shepai/cli 1.136.1 → 1.137.0-pr440.3cc2b78

package/apis/json-schema/Feature.yaml

@@ -69,6 +69,9 @@ properties:
   parentId:
     $ref: UUID.yaml
     description: Parent feature ID for dependency tracking (optional)
+  previousLifecycle:
+    $ref: SdlcLifecycle.yaml
+    description: Lifecycle state prior to archiving, used to restore on unarchive (only set when lifecycle is Archived)
   attachments:
     type: array
     items:

package/apis/json-schema/FeatureFlags.yaml

@@ -22,6 +22,10 @@ properties:
     type: boolean
     default: false
     description: Enable adopt branch feature to import existing branches as tracked features
+  gitRebaseSync:
+    type: boolean
+    default: false
+    description: Enable git rebase-on-main and sync-main operations in the web UI
   reactFileManager:
     type: boolean
     default: false
@@ -32,5 +36,6 @@ required:
   - debug
   - githubImport
   - adoptBranch
+  - gitRebaseSync
   - reactFileManager
 description: Feature flag toggles for runtime feature control

package/apis/json-schema/SdlcLifecycle.yaml

@@ -13,4 +13,5 @@ enum:
   - Blocked
   - Pending
   - Deleting
+  - Archived
 description: Software Development Lifecycle stages for feature progression

package/dist/packages/core/src/application/ports/output/repositories/feature-repository.interface.d.ts

@@ -17,6 +17,8 @@ export interface FeatureListFilters {
     lifecycle?: SdlcLifecycle;
     /** When true, include soft-deleted features in results. Default: false. */
     includeDeleted?: boolean;
+    /** When true, include archived features in results. Default: false. */
+    includeArchived?: boolean;
 }
 /**
  * Repository interface for Feature entity persistence.

package/dist/packages/core/src/application/ports/output/repositories/feature-repository.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-repository.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/feature-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE9C;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAExD;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE1E;;;;;;;;;OASG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE9E;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEvD;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;;;OAOG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAErD;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC"}
+{"version":3,"file":"feature-repository.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/feature-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uEAAuE;IACvE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE9C;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAExD;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE1E;;;;;;;;;OASG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE9E;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEvD;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;;;OAOG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAErD;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC"}

package/dist/packages/core/src/application/ports/output/services/git-pr-service.interface.d.ts

@@ -9,15 +9,17 @@ import type { PrStatus } from '../../../../domain/generated/output.js';
  * Error codes for git PR operations.
  */
 export declare enum GitPrErrorCode {
-    MERGE_CONFLICT = "MERGE_CONFLICT",
     AUTH_FAILURE = "AUTH_FAILURE",
-    GH_NOT_FOUND = "GH_NOT_FOUND",
-    NETWORK_ERROR = "NETWORK_ERROR",
-    CI_TIMEOUT = "CI_TIMEOUT",
     BRANCH_NOT_FOUND = "BRANCH_NOT_FOUND",
+    CI_TIMEOUT = "CI_TIMEOUT",
+    GH_NOT_FOUND = "GH_NOT_FOUND",
     GIT_ERROR = "GIT_ERROR",
+    MERGE_CONFLICT = "MERGE_CONFLICT",
     MERGE_FAILED = "MERGE_FAILED",
-    PR_NOT_FOUND = "PR_NOT_FOUND"
+    NETWORK_ERROR = "NETWORK_ERROR",
+    PR_NOT_FOUND = "PR_NOT_FOUND",
+    REBASE_CONFLICT = "REBASE_CONFLICT",
+    SYNC_FAILED = "SYNC_FAILED"
 }
 /**
  * Typed error for git PR operations.
@@ -321,5 +323,89 @@ export interface IGitPrService {
      * @throws GitPrError with GH_NOT_FOUND or GIT_ERROR code on failure
      */
     getFailureLogs(cwd: string, runId: string, branch: string, logMaxChars?: number): Promise<string>;
+    /**
+     * Sync the remote-tracking ref for the base branch.
+     * If currently on the base branch, uses `git pull --ff-only`.
+     * If on a different branch (including worktrees), uses `git fetch origin <baseBranch>`
+     * which updates `origin/<baseBranch>` without touching the local branch ref.
+     * This avoids the "refusing to fetch into branch checked out at..." error
+     * when the local base branch is checked out in another worktree.
+     *
+     * @param cwd - Working directory path
+     * @param baseBranch - The base branch to sync (e.g. "main")
+     * @throws GitPrError with SYNC_FAILED code if the branch has diverged and cannot fast-forward
+     * @throws GitPrError with GIT_ERROR code on other git failures
+     */
+    syncMain(cwd: string, baseBranch: string): Promise<void>;
+    /**
+     * Rebase the feature branch onto `origin/<baseBranch>`.
+     * Uses the remote-tracking ref (not the local branch) to avoid issues
+     * when the local base branch is checked out in another worktree.
+     * Checks for dirty worktree before starting. Detects conflict state
+     * from git exit code and stderr — throws REBASE_CONFLICT if conflicts
+     * are encountered (caller is responsible for resolution or abort).
+     *
+     * @param cwd - Working directory path
+     * @param featureBranch - The feature branch to rebase
+     * @param baseBranch - The base branch name (rebase target will be origin/<baseBranch>)
+     * @throws GitPrError with GIT_ERROR code if the worktree is dirty
+     * @throws GitPrError with REBASE_CONFLICT code if conflicts are detected
+     * @throws GitPrError with BRANCH_NOT_FOUND code if a branch does not exist
+     */
+    rebaseOnMain(cwd: string, featureBranch: string, baseBranch: string): Promise<void>;
+    /**
+     * Get the list of files with unresolved conflicts (unmerged paths).
+     * Uses `git diff --name-only --diff-filter=U` to identify conflicted files.
+     *
+     * @param cwd - Working directory path
+     * @returns Array of file paths with unresolved conflicts
+     * @throws GitPrError with GIT_ERROR code on failure
+     */
+    getConflictedFiles(cwd: string): Promise<string[]>;
+    /**
+     * Stage specific files in the working directory.
+     * Uses `git add` for the specified file paths.
+     *
+     * @param cwd - Working directory path
+     * @param files - Array of file paths to stage
+     * @throws GitPrError with GIT_ERROR code on failure
+     */
+    stageFiles(cwd: string, files: string[]): Promise<void>;
+    /**
+     * Continue an in-progress rebase after conflicts have been resolved.
+     * Runs `git rebase --continue`. May throw REBASE_CONFLICT if the next
+     * commit in the rebase also has conflicts.
+     *
+     * @param cwd - Working directory path
+     * @throws GitPrError with REBASE_CONFLICT code if new conflicts are detected
+     * @throws GitPrError with GIT_ERROR code on other git failures
+     */
+    rebaseContinue(cwd: string): Promise<void>;
+    /**
+     * Abort an in-progress rebase, restoring the branch to its pre-rebase state.
+     * Runs `git rebase --abort`.
+     *
+     * @param cwd - Working directory path
+     * @throws GitPrError with GIT_ERROR code on failure
+     */
+    rebaseAbort(cwd: string): Promise<void>;
+    /**
+     * Get the sync status (ahead/behind counts) between a feature branch
+     * and a base branch's remote-tracking ref.
+     *
+     * Uses:
+     * - `git rev-list --count origin/<baseBranch>..<featureBranch>` → ahead
+     * - `git rev-list --count <featureBranch>..origin/<baseBranch>` → behind
+     *
+     * @param cwd - Working directory path
+     * @param featureBranch - The feature branch to check
+     * @param baseBranch - The base branch name (uses origin/<baseBranch>)
+     * @returns Object with ahead and behind commit counts
+     * @throws GitPrError with GIT_ERROR code on failure
+     */
+    getBranchSyncStatus(cwd: string, featureBranch: string, baseBranch: string): Promise<{
+        ahead: number;
+        behind: number;
+    }>;
 }
 //# sourceMappingURL=git-pr-service.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/git-pr-service.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-pr-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/git-pr-service.interface.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"git-pr-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/git-pr-service.interface.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/src/application/ports/output/services/git-pr-service.interface.js

@@ -9,15 +9,17 @@
  */
 export var GitPrErrorCode;
 (function (GitPrErrorCode) {
-    GitPrErrorCode["MERGE_CONFLICT"] = "MERGE_CONFLICT";
     GitPrErrorCode["AUTH_FAILURE"] = "AUTH_FAILURE";
-    GitPrErrorCode["GH_NOT_FOUND"] = "GH_NOT_FOUND";
-    GitPrErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
-    GitPrErrorCode["CI_TIMEOUT"] = "CI_TIMEOUT";
     GitPrErrorCode["BRANCH_NOT_FOUND"] = "BRANCH_NOT_FOUND";
+    GitPrErrorCode["CI_TIMEOUT"] = "CI_TIMEOUT";
+    GitPrErrorCode["GH_NOT_FOUND"] = "GH_NOT_FOUND";
     GitPrErrorCode["GIT_ERROR"] = "GIT_ERROR";
+    GitPrErrorCode["MERGE_CONFLICT"] = "MERGE_CONFLICT";
     GitPrErrorCode["MERGE_FAILED"] = "MERGE_FAILED";
+    GitPrErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
     GitPrErrorCode["PR_NOT_FOUND"] = "PR_NOT_FOUND";
+    GitPrErrorCode["REBASE_CONFLICT"] = "REBASE_CONFLICT";
+    GitPrErrorCode["SYNC_FAILED"] = "SYNC_FAILED";
 })(GitPrErrorCode || (GitPrErrorCode = {}));
 /**
  * Typed error for git PR operations.

package/dist/packages/core/src/application/use-cases/features/archive-feature.use-case.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Archive Feature Use Case
+ *
+ * Transitions a feature's lifecycle to Archived, storing the current lifecycle
+ * in previousLifecycle for restoration on unarchive.
+ *
+ * Business Rules:
+ * - Any feature can be archived except those already Archived or Deleting
+ * - Features with active (non-archived, non-deleted) children cannot be archived
+ * - The current lifecycle is preserved in previousLifecycle for unarchive restoration
+ * - No git operations or agent cancellations are triggered (archive is non-destructive)
+ */
+import type { Feature } from '../../../domain/generated/output.js';
+import type { IFeatureRepository } from '../../ports/output/repositories/feature-repository.interface.js';
+export declare class ArchiveFeatureUseCase {
+    private readonly featureRepo;
+    constructor(featureRepo: IFeatureRepository);
+    execute(featureId: string): Promise<Feature>;
+}
+//# sourceMappingURL=archive-feature.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/features/archive-feature.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/archive-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAQ1G,qBACa,qBAAqB;IACU,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,kBAAkB;IAEpF,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CA0CnD"}

package/dist/packages/core/src/application/use-cases/features/archive-feature.use-case.js

@@ -0,0 +1,73 @@
+/**
+ * Archive Feature Use Case
+ *
+ * Transitions a feature's lifecycle to Archived, storing the current lifecycle
+ * in previousLifecycle for restoration on unarchive.
+ *
+ * Business Rules:
+ * - Any feature can be archived except those already Archived or Deleting
+ * - Features with active (non-archived, non-deleted) children cannot be archived
+ * - The current lifecycle is preserved in previousLifecycle for unarchive restoration
+ * - No git operations or agent cancellations are triggered (archive is non-destructive)
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+import { SdlcLifecycle } from '../../../domain/generated/output.js';
+/** Lifecycle states that cannot be archived. */
+const NON_ARCHIVABLE_STATES = new Set([
+    SdlcLifecycle.Archived,
+    SdlcLifecycle.Deleting,
+]);
+let ArchiveFeatureUseCase = class ArchiveFeatureUseCase {
+    featureRepo;
+    constructor(featureRepo) {
+        this.featureRepo = featureRepo;
+    }
+    async execute(featureId) {
+        // 1. Find feature (exact or prefix match)
+        const feature = (await this.featureRepo.findById(featureId)) ??
+            (await this.featureRepo.findByIdPrefix(featureId));
+        if (!feature) {
+            throw new Error(`Feature not found: "${featureId}"`);
+        }
+        // 2. Validate lifecycle is archivable
+        if (NON_ARCHIVABLE_STATES.has(feature.lifecycle)) {
+            throw new Error(`Cannot archive feature "${feature.name}": lifecycle is ${feature.lifecycle}. ` +
+                `Features that are already archived or being deleted cannot be archived.`);
+        }
+        // 3. Check for active (non-archived, non-deleted) children
+        const children = await this.featureRepo.findByParentId(feature.id);
+        const activeChildren = children.filter((c) => c.lifecycle !== SdlcLifecycle.Archived && !c.deletedAt);
+        if (activeChildren.length > 0) {
+            const names = activeChildren.map((c) => c.name).join(', ');
+            throw new Error(`Cannot archive feature "${feature.name}": it has active child features (${names}). ` +
+                `Archive or delete child features first.`);
+        }
+        // 4. Store current lifecycle and transition to Archived
+        const updatedFeature = {
+            ...feature,
+            previousLifecycle: feature.lifecycle,
+            lifecycle: SdlcLifecycle.Archived,
+            updatedAt: new Date(),
+        };
+        await this.featureRepo.update(updatedFeature);
+        return updatedFeature;
+    }
+};
+ArchiveFeatureUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IFeatureRepository')),
+    __metadata("design:paramtypes", [Object])
+], ArchiveFeatureUseCase);
+export { ArchiveFeatureUseCase };

package/dist/packages/core/src/application/use-cases/features/get-branch-sync-status.use-case.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Get Branch Sync Status Use Case
+ *
+ * Returns how many commits a feature branch is ahead/behind the base branch.
+ *
+ * Flow: resolve feature → determine cwd (worktree or repo root) →
+ * sync remote tracking ref → get branch sync status.
+ */
+import type { IFeatureRepository } from '../../ports/output/repositories/feature-repository.interface.js';
+import type { IGitPrService } from '../../ports/output/services/git-pr-service.interface.js';
+import type { IWorktreeService } from '../../ports/output/services/worktree-service.interface.js';
+export interface BranchSyncStatusResult {
+    ahead: number;
+    behind: number;
+    baseBranch: string;
+}
+export declare class GetBranchSyncStatusUseCase {
+    private readonly featureRepo;
+    private readonly gitPrService;
+    private readonly worktreeService;
+    constructor(featureRepo: IFeatureRepository, gitPrService: IGitPrService, worktreeService: IWorktreeService);
+    execute(featureId: string): Promise<BranchSyncStatusResult>;
+    private resolveCwd;
+}
+//# sourceMappingURL=get-branch-sync-status.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/features/get-branch-sync-status.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-branch-sync-status.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/get-branch-sync-status.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yDAAyD,CAAC;AAC7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAElG,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBACa,0BAA0B;IAGnC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAJf,WAAW,EAAE,kBAAkB,EAE/B,YAAY,EAAE,aAAa,EAE3B,eAAe,EAAE,gBAAgB;IAG9C,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;YA0BnD,UAAU;CAOzB"}

package/dist/packages/core/src/application/use-cases/features/get-branch-sync-status.use-case.js

@@ -0,0 +1,62 @@
+/**
+ * Get Branch Sync Status Use Case
+ *
+ * Returns how many commits a feature branch is ahead/behind the base branch.
+ *
+ * Flow: resolve feature → determine cwd (worktree or repo root) →
+ * sync remote tracking ref → get branch sync status.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+let GetBranchSyncStatusUseCase = class GetBranchSyncStatusUseCase {
+    featureRepo;
+    gitPrService;
+    worktreeService;
+    constructor(featureRepo, gitPrService, worktreeService) {
+        this.featureRepo = featureRepo;
+        this.gitPrService = gitPrService;
+        this.worktreeService = worktreeService;
+    }
+    async execute(featureId) {
+        const feature = (await this.featureRepo.findById(featureId)) ??
+            (await this.featureRepo.findByIdPrefix(featureId));
+        if (!feature) {
+            throw new Error(`Feature not found: "${featureId}"`);
+        }
+        if (!feature.branch) {
+            throw new Error(`Feature "${featureId}" has no branch`);
+        }
+        const cwd = await this.resolveCwd(feature.repositoryPath, feature.branch);
+        const baseBranch = await this.gitPrService.getDefaultBranch(feature.repositoryPath);
+        // Sync the remote tracking ref so ahead/behind counts are current
+        await this.gitPrService.syncMain(cwd, baseBranch);
+        const { ahead, behind } = await this.gitPrService.getBranchSyncStatus(cwd, feature.branch, baseBranch);
+        return { ahead, behind, baseBranch };
+    }
+    async resolveCwd(repositoryPath, branch) {
+        const hasWorktree = await this.worktreeService.exists(repositoryPath, branch);
+        if (hasWorktree) {
+            return this.worktreeService.getWorktreePath(repositoryPath, branch);
+        }
+        return repositoryPath;
+    }
+};
+GetBranchSyncStatusUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IFeatureRepository')),
+    __param(1, inject('IGitPrService')),
+    __param(2, inject('IWorktreeService')),
+    __metadata("design:paramtypes", [Object, Object, Object])
+], GetBranchSyncStatusUseCase);
+export { GetBranchSyncStatusUseCase };

package/dist/packages/core/src/application/use-cases/features/rebase-feature-on-main.use-case.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Rebase Feature on Main Use Case
+ *
+ * Rebases a feature branch onto the latest main branch with auto-sync
+ * and agent-powered conflict resolution.
+ *
+ * Flow: resolve feature → create standalone agent run → record phase timing →
+ * determine cwd (worktree or repo root) → sync main → rebase →
+ * on conflict, delegate to ConflictResolutionService → complete timing.
+ */
+import type { IFeatureRepository } from '../../ports/output/repositories/feature-repository.interface.js';
+import type { IGitPrService } from '../../ports/output/services/git-pr-service.interface.js';
+import type { IWorktreeService } from '../../ports/output/services/worktree-service.interface.js';
+import type { IAgentRunRepository } from '../../ports/output/agents/agent-run-repository.interface.js';
+import type { IPhaseTimingRepository } from '../../ports/output/agents/phase-timing-repository.interface.js';
+import type { ConflictResolutionService } from '../../../infrastructure/services/agents/conflict-resolution/conflict-resolution.service.js';
+export declare class RebaseFeatureOnMainUseCase {
+    private readonly featureRepo;
+    private readonly gitPrService;
+    private readonly worktreeService;
+    private readonly conflictResolutionService;
+    private readonly agentRunRepo;
+    private readonly phaseTimingRepo;
+    constructor(featureRepo: IFeatureRepository, gitPrService: IGitPrService, worktreeService: IWorktreeService, conflictResolutionService: ConflictResolutionService, agentRunRepo: IAgentRunRepository, phaseTimingRepo: IPhaseTimingRepository);
+    execute(featureId: string): Promise<void>;
+    private completeTiming;
+    /**
+     * Resolve the correct working directory for the feature.
+     * Uses the worktree path if a worktree exists for this branch,
+     * otherwise falls back to the repository root.
+     */
+    private resolveCwd;
+}
+//# sourceMappingURL=rebase-feature-on-main.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/features/rebase-feature-on-main.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebase-feature-on-main.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/rebase-feature-on-main.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yDAAyD,CAAC;AAK7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gEAAgE,CAAC;AAE7G,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4FAA4F,CAAC;AAE5I,qBACa,0BAA0B;IAGnC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,yBAAyB;IAE1C,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAVf,WAAW,EAAE,kBAAkB,EAE/B,YAAY,EAAE,aAAa,EAE3B,eAAe,EAAE,gBAAgB,EAEjC,yBAAyB,EAAE,yBAAyB,EAEpD,YAAY,EAAE,mBAAmB,EAEjC,eAAe,EAAE,sBAAsB;IAGpD,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAuEjC,cAAc;IAwB5B;;;;OAIG;YACW,UAAU;CAOzB"}

package/dist/packages/core/src/application/use-cases/features/rebase-feature-on-main.use-case.js

@@ -0,0 +1,139 @@
+/**
+ * Rebase Feature on Main Use Case
+ *
+ * Rebases a feature branch onto the latest main branch with auto-sync
+ * and agent-powered conflict resolution.
+ *
+ * Flow: resolve feature → create standalone agent run → record phase timing →
+ * determine cwd (worktree or repo root) → sync main → rebase →
+ * on conflict, delegate to ConflictResolutionService → complete timing.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+import { randomUUID } from 'node:crypto';
+import { GitPrError, GitPrErrorCode, } from '../../ports/output/services/git-pr-service.interface.js';
+import { AgentRunStatus, AgentType } from '../../../domain/generated/output.js';
+let RebaseFeatureOnMainUseCase = class RebaseFeatureOnMainUseCase {
+    featureRepo;
+    gitPrService;
+    worktreeService;
+    conflictResolutionService;
+    agentRunRepo;
+    phaseTimingRepo;
+    constructor(featureRepo, gitPrService, worktreeService, conflictResolutionService, agentRunRepo, phaseTimingRepo) {
+        this.featureRepo = featureRepo;
+        this.gitPrService = gitPrService;
+        this.worktreeService = worktreeService;
+        this.conflictResolutionService = conflictResolutionService;
+        this.agentRunRepo = agentRunRepo;
+        this.phaseTimingRepo = phaseTimingRepo;
+    }
+    async execute(featureId) {
+        // Resolve feature by exact ID or prefix
+        const feature = (await this.featureRepo.findById(featureId)) ??
+            (await this.featureRepo.findByIdPrefix(featureId));
+        if (!feature) {
+            throw new Error(`Feature not found: "${featureId}"`);
+        }
+        // Create standalone agent run + phase timing for activity timeline
+        const now = new Date().toISOString();
+        const agentRunId = randomUUID();
+        const phaseTimingId = randomUUID();
+        await this.agentRunRepo.create({
+            id: agentRunId,
+            agentType: AgentType.ClaudeCode,
+            agentName: 'rebase',
+            status: AgentRunStatus.running,
+            prompt: `Rebase ${feature.branch} on main`,
+            threadId: agentRunId,
+            startedAt: now,
+            featureId: feature.id,
+            repositoryPath: feature.repositoryPath,
+            createdAt: now,
+            updatedAt: now,
+        });
+        await this.phaseTimingRepo.save({
+            id: phaseTimingId,
+            agentRunId,
+            phase: 'rebase',
+            startedAt: now,
+            createdAt: now,
+            updatedAt: now,
+        });
+        const startMs = Date.now();
+        try {
+            // Determine working directory — worktree path if it exists, else repo root
+            const cwd = await this.resolveCwd(feature.repositoryPath, feature.branch);
+            const defaultBranch = await this.gitPrService.getDefaultBranch(feature.repositoryPath);
+            // Auto-sync main before rebasing (per spec decision)
+            await this.gitPrService.syncMain(cwd, defaultBranch);
+            // Attempt rebase
+            try {
+                await this.gitPrService.rebaseOnMain(cwd, feature.branch, defaultBranch);
+            }
+            catch (error) {
+                if (error instanceof GitPrError && error.code === GitPrErrorCode.REBASE_CONFLICT) {
+                    // Delegate to agent-powered conflict resolution
+                    await this.conflictResolutionService.resolve(cwd, feature.branch, defaultBranch);
+                    // Conflict resolution succeeded — complete timing as success
+                    await this.completeTiming(agentRunId, phaseTimingId, startMs, 'success');
+                    return;
+                }
+                throw error;
+            }
+            // Rebase succeeded without conflicts
+            await this.completeTiming(agentRunId, phaseTimingId, startMs, 'success');
+        }
+        catch (error) {
+            // Record failure in timing
+            const message = error instanceof Error ? error.message : String(error);
+            await this.completeTiming(agentRunId, phaseTimingId, startMs, 'error', message);
+            throw error;
+        }
+    }
+    async completeTiming(agentRunId, phaseTimingId, startMs, exitCode, errorMessage) {
+        const completedAt = new Date().toISOString();
+        const durationMs = Date.now() - startMs;
+        await this.phaseTimingRepo.update(phaseTimingId, {
+            completedAt,
+            durationMs: BigInt(durationMs),
+            exitCode,
+            ...(errorMessage && { errorMessage }),
+        });
+        await this.agentRunRepo.updateStatus(agentRunId, exitCode === 'success' ? AgentRunStatus.completed : AgentRunStatus.failed, { completedAt, ...(errorMessage && { error: errorMessage }) });
+    }
+    /**
+     * Resolve the correct working directory for the feature.
+     * Uses the worktree path if a worktree exists for this branch,
+     * otherwise falls back to the repository root.
+     */
+    async resolveCwd(repositoryPath, branch) {
+        const hasWorktree = await this.worktreeService.exists(repositoryPath, branch);
+        if (hasWorktree) {
+            return this.worktreeService.getWorktreePath(repositoryPath, branch);
+        }
+        return repositoryPath;
+    }
+};
+RebaseFeatureOnMainUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IFeatureRepository')),
+    __param(1, inject('IGitPrService')),
+    __param(2, inject('IWorktreeService')),
+    __param(3, inject('ConflictResolutionService')),
+    __param(4, inject('IAgentRunRepository')),
+    __param(5, inject('IPhaseTimingRepository')),
+    __metadata("design:paramtypes", [Object, Object, Object, Function, Object, Object])
+], RebaseFeatureOnMainUseCase);
+export { RebaseFeatureOnMainUseCase };

package/dist/packages/core/src/application/use-cases/features/unarchive-feature.use-case.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Unarchive Feature Use Case
+ *
+ * Restores a feature from Archived to its previousLifecycle value,
+ * then clears previousLifecycle.
+ *
+ * Business Rules:
+ * - Only features in the Archived state can be unarchived
+ * - previousLifecycle must be non-null for restoration
+ * - The lifecycle is restored to the pre-archive state
+ * - previousLifecycle is cleared after restoration
+ */
+import type { Feature } from '../../../domain/generated/output.js';
+import type { IFeatureRepository } from '../../ports/output/repositories/feature-repository.interface.js';
+export declare class UnarchiveFeatureUseCase {
+    private readonly featureRepo;
+    constructor(featureRepo: IFeatureRepository);
+    execute(featureId: string): Promise<Feature>;
+}
+//# sourceMappingURL=unarchive-feature.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/features/unarchive-feature.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unarchive-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/unarchive-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAE1G,qBACa,uBAAuB;IACQ,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,kBAAkB;IAEpF,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAqCnD"}