@shepai/cli 1.52.1 → 1.53.0

package/apis/json-schema/CiFixRecord.yaml

@@ -0,0 +1,24 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: CiFixRecord.yaml
+type: object
+properties:
+  attempt:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: 1-based attempt number
+  startedAt:
+    type: string
+    description: ISO timestamp when this attempt started
+  failureSummary:
+    type: string
+    description: First 500 chars of failure logs for this attempt
+  outcome:
+    type: string
+    description: "Outcome of this attempt: fixed, failed, or timeout"
+required:
+  - attempt
+  - startedAt
+  - failureSummary
+  - outcome
+description: Record of one CI fix attempt in the watch/fix loop

package/apis/json-schema/Feature.yaml

@@ -62,6 +62,9 @@ properties:
   pr:
     $ref: PullRequest.yaml
     description: Pull request data (null until PR created)
+  parentId:
+    $ref: UUID.yaml
+    description: Parent feature ID for dependency tracking (optional)
 required:
   - name
   - userQuery

package/apis/json-schema/PullRequest.yaml

@@ -19,6 +19,16 @@ properties:
   ciStatus:
     $ref: CiStatus.yaml
     description: CI pipeline status
+  ciFixAttempts:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: Number of CI fix attempts made
+  ciFixHistory:
+    type: array
+    items:
+      $ref: CiFixRecord.yaml
+    description: History of CI fix attempts
 required:
   - url
   - number

package/apis/json-schema/SdlcLifecycle.yaml

@@ -10,4 +10,5 @@ enum:
   - Implementation
   - Review
   - Maintain
+  - Blocked
 description: Software Development Lifecycle stages for feature progression

package/apis/json-schema/WorkflowConfig.yaml

@@ -9,6 +9,21 @@ properties:
   approvalGateDefaults:
     $ref: ApprovalGateDefaults.yaml
     description: Default approval gate preferences for new features
+  ciMaxFixAttempts:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: "Maximum number of CI fix/push/watch iterations before giving up (default: 3)"
+  ciWatchTimeoutMs:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: "Timeout in milliseconds for watching a CI run (default: 600000 = 10 minutes)"
+  ciLogMaxChars:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: "Maximum characters of CI failure logs to pass to the executor (default: 50000)"
 required:
   - openPrOnImplementationComplete
   - approvalGateDefaults

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

@@ -66,6 +66,14 @@ export interface IFeatureRepository {
      * @param feature - The feature with updated fields
      */
     update(feature: Feature): Promise<void>;
+    /**
+     * Returns all direct (non-recursive) children of the given parent feature ID.
+     * Children are ordered by creation time ascending.
+     *
+     * @param parentId - The parent feature ID
+     * @returns Array of direct child features
+     */
+    findByParentId(parentId: string): Promise<Feature[]>;
     /**
      * Delete a feature by ID.
      *

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;CAC3B;AAED;;;;;;;GAOG;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;;;;;OAKG;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;;;;;OAKG;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;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}
+{"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;CAC3B;AAED;;;;;;;GAOG;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;;;;;OAKG;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;;;;;OAKG;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;;;;;;OAMG;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;CACnC"}

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

@@ -189,5 +189,17 @@ export interface IGitPrService {
      * @returns True if featureBranch is an ancestor of baseBranch
      */
     verifyMerge(cwd: string, featureBranch: string, baseBranch: string): Promise<boolean>;
+    /**
+     * Retrieve failure logs for a CI run via `gh run view --log-failed`.
+     * Output is truncated to the first `logMaxChars` characters (head truncation).
+     * A notice is appended when truncation occurs.
+     *
+     * @param runId - GitHub Actions run ID (numeric string)
+     * @param branch - Branch name (informational, used in truncation notice)
+     * @param logMaxChars - Maximum characters to return (default 50_000)
+     * @returns Truncated failure log output
+     * @throws GitPrError with GH_NOT_FOUND or GIT_ERROR code on failure
+     */
+    getFailureLogs(runId: string, branch: string, logMaxChars?: number): Promise<string>;
 }
 //# 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/use-cases/features/check-and-unblock-features.use-case.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CheckAndUnblockFeaturesUseCase
+ *
+ * Evaluates whether blocked direct children of a parent feature are now
+ * eligible to start, and if so transitions them to Started and spawns their
+ * agents.
+ *
+ * Business Rules:
+ * - Only direct children of parentFeatureId are evaluated (no recursive traversal).
+ *   Grandchildren stay Blocked until their own direct parent progresses.
+ * - Gate: parent lifecycle must be in POST_IMPLEMENTATION (Implementation, Review, Maintain).
+ * - Idempotent: already-Started children are not touched; calling execute() twice is safe.
+ * - spawn() is skipped for children missing agentRunId or specPath (defensive guard).
+ *
+ * Called from: UpdateFeatureLifecycleUseCase after every lifecycle transition.
+ */
+import type { IFeatureRepository } from '../../ports/output/repositories/feature-repository.interface.js';
+import type { IFeatureAgentProcessService } from '../../ports/output/agents/feature-agent-process.interface.js';
+export declare class CheckAndUnblockFeaturesUseCase {
+    private readonly featureRepo;
+    private readonly agentProcess;
+    constructor(featureRepo: IFeatureRepository, agentProcess: IFeatureAgentProcessService);
+    /**
+     * Check and unblock direct children of the given parent feature.
+     *
+     * @param parentFeatureId - ID of the feature whose children should be evaluated.
+     */
+    execute(parentFeatureId: string): Promise<void>;
+}
+//# sourceMappingURL=check-and-unblock-features.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/features/check-and-unblock-features.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-and-unblock-features.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/check-and-unblock-features.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAGhH,qBACa,8BAA8B;IAET,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE1D,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAFkB,WAAW,EAAE,kBAAkB,EAE7D,YAAY,EAAE,2BAA2B;IAG5D;;;;OAIG;IACG,OAAO,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAiCtD"}

package/dist/packages/core/src/application/use-cases/features/check-and-unblock-features.use-case.js

@@ -0,0 +1,74 @@
+/**
+ * CheckAndUnblockFeaturesUseCase
+ *
+ * Evaluates whether blocked direct children of a parent feature are now
+ * eligible to start, and if so transitions them to Started and spawns their
+ * agents.
+ *
+ * Business Rules:
+ * - Only direct children of parentFeatureId are evaluated (no recursive traversal).
+ *   Grandchildren stay Blocked until their own direct parent progresses.
+ * - Gate: parent lifecycle must be in POST_IMPLEMENTATION (Implementation, Review, Maintain).
+ * - Idempotent: already-Started children are not touched; calling execute() twice is safe.
+ * - spawn() is skipped for children missing agentRunId or specPath (defensive guard).
+ *
+ * Called from: UpdateFeatureLifecycleUseCase after every lifecycle transition.
+ */
+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';
+import { POST_IMPLEMENTATION } from '../../../domain/lifecycle-gates.js';
+let CheckAndUnblockFeaturesUseCase = class CheckAndUnblockFeaturesUseCase {
+    featureRepo;
+    agentProcess;
+    constructor(featureRepo, agentProcess) {
+        this.featureRepo = featureRepo;
+        this.agentProcess = agentProcess;
+    }
+    /**
+     * Check and unblock direct children of the given parent feature.
+     *
+     * @param parentFeatureId - ID of the feature whose children should be evaluated.
+     */
+    async execute(parentFeatureId) {
+        // Load parent and verify gate
+        const parent = await this.featureRepo.findById(parentFeatureId);
+        if (!parent || !POST_IMPLEMENTATION.has(parent.lifecycle)) {
+            return;
+        }
+        // Load direct children
+        const children = await this.featureRepo.findByParentId(parentFeatureId);
+        // Unblock each blocked child
+        for (const child of children) {
+            if (child.lifecycle !== SdlcLifecycle.Blocked) {
+                continue;
+            }
+            // Transition to Started
+            child.lifecycle = SdlcLifecycle.Started;
+            child.updatedAt = new Date();
+            await this.featureRepo.update(child);
+            // Spawn agent using fields set at feature creation time
+            if (child.agentRunId && child.specPath) {
+                this.agentProcess.spawn(child.id, child.agentRunId, child.repositoryPath, child.specPath, child.worktreePath);
+            }
+        }
+    }
+};
+CheckAndUnblockFeaturesUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IFeatureRepository')),
+    __param(1, inject('IFeatureAgentProcessService')),
+    __metadata("design:paramtypes", [Object, Object])
+], CheckAndUnblockFeaturesUseCase);
+export { CheckAndUnblockFeaturesUseCase };

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

@@ -1 +1 @@
-{"version":3,"file":"create-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/create-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oEAAoE,CAAC;AAC7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAC;AACrG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iEAAiE,CAAC;AACnH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gEAAgE,CAAC;AAC1G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uEAAuE,CAAC;AACnH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4DAA4D,CAAC;AAEhG,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE1E,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAhBZ,WAAW,EAAE,kBAAkB,EAE/B,eAAe,EAAE,gBAAgB,EAEjC,YAAY,EAAE,2BAA2B,EAEzC,aAAa,EAAE,mBAAmB,EAElC,eAAe,EAAE,uBAAuB,EAExC,iBAAiB,EAAE,iBAAiB,EAEpC,YAAY,EAAE,YAAY,EAE1B,cAAc,EAAE,qBAAqB,EAErC,YAAY,EAAE,aAAa;IAGxC,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAwGvE"}
+{"version":3,"file":"create-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/create-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oEAAoE,CAAC;AAC7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAC;AACrG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iEAAiE,CAAC;AACnH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gEAAgE,CAAC;AAC1G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uEAAuE,CAAC;AACnH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4DAA4D,CAAC;AAGhG,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE1E,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAhBZ,WAAW,EAAE,kBAAkB,EAE/B,eAAe,EAAE,gBAAgB,EAEjC,YAAY,EAAE,2BAA2B,EAEzC,aAAa,EAAE,mBAAmB,EAElC,eAAe,EAAE,uBAAuB,EAExC,iBAAiB,EAAE,iBAAiB,EAEpC,YAAY,EAAE,YAAY,EAE1B,cAAc,EAAE,qBAAqB,EAErC,YAAY,EAAE,aAAa;IAGxC,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAyJvE"}

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

@@ -31,6 +31,7 @@ import { injectable, inject } from 'tsyringe';
 import { randomUUID } from 'node:crypto';
 import { SdlcLifecycle, AgentRunStatus } from '../../../../domain/generated/output.js';
 import { getSettings } from '../../../../infrastructure/services/settings.service.js';
+import { POST_IMPLEMENTATION } from '../../../../domain/lifecycle-gates.js';
 import { MetadataGenerator } from './metadata-generator.js';
 import { SlugResolver } from './slug-resolver.js';
 let CreateFeatureUseCase = class CreateFeatureUseCase {
@@ -55,28 +56,67 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
         this.gitPrService = gitPrService;
     }
     async execute(input) {
+        // Resolve parent feature and determine child initial lifecycle (FR-8, FR-9, FR-12, FR-19)
+        let initialLifecycle = SdlcLifecycle.Requirements;
+        let shouldSpawn = true;
+        // When creating a child feature, always use the parent's repositoryPath (the
+        // original repo root), not the caller's cwd which may be a worktree (FR-10).
+        let effectiveRepoPath = input.repositoryPath;
+        if (input.parentId) {
+            const parent = await this.featureRepo.findById(input.parentId);
+            if (!parent) {
+                throw new Error(`Parent feature not found: ${input.parentId}`);
+            }
+            // Use the parent's repositoryPath so the child worktree branches from the
+            // original repo, not from inside another worktree.
+            effectiveRepoPath = parent.repositoryPath;
+            // Cycle detection — O(depth) upward walk through ancestor chain (FR-19)
+            const visited = new Set([input.parentId]);
+            let cursor = parent.parentId;
+            while (cursor) {
+                if (visited.has(cursor)) {
+                    throw new Error(`Cycle detected in feature dependency chain at feature: ${cursor}`);
+                }
+                visited.add(cursor);
+                const ancestor = await this.featureRepo.findById(cursor);
+                cursor = ancestor?.parentId ?? undefined;
+            }
+            // Two-gate lifecycle logic (FR-9):
+            //   parent.lifecycle === Blocked → cascade block (FR-12)
+            //   parent.lifecycle not in POST_IMPLEMENTATION → early gate not met → Blocked
+            //   parent.lifecycle in POST_IMPLEMENTATION → gate satisfied → Started
+            if (parent.lifecycle === SdlcLifecycle.Blocked ||
+                !POST_IMPLEMENTATION.has(parent.lifecycle)) {
+                initialLifecycle = SdlcLifecycle.Blocked;
+                shouldSpawn = false;
+            }
+            else {
+                initialLifecycle = SdlcLifecycle.Started;
+                shouldSpawn = true;
+            }
+        }
         // Ensure the target directory is a git repository (auto-init if needed)
         // Must run before slug resolution which needs git commands
-        await this.worktreeService.ensureGitRepository(input.repositoryPath);
+        await this.worktreeService.ensureGitRepository(effectiveRepoPath);
         const metadata = await this.metadataGenerator.generateMetadata(input.userInput);
         const originalSlug = metadata.slug;
         // Find a unique slug — the branch may exist from a previous (deleted) feature
-        const { slug, branch, warning } = await this.slugResolver.resolveUniqueSlug(originalSlug, input.repositoryPath);
+        const { slug, branch, warning } = await this.slugResolver.resolveUniqueSlug(originalSlug, effectiveRepoPath);
         // Determine next feature number for this repo
         const existingFeatures = await this.featureRepo.list({
-            repositoryPath: input.repositoryPath,
+            repositoryPath: effectiveRepoPath,
         });
         const featureNumber = existingFeatures.length + 1;
         const now = new Date();
         const runId = randomUUID();
         // Create git worktree branching from the repo's default branch
-        const defaultBranch = await this.gitPrService.getDefaultBranch(input.repositoryPath);
-        const worktreePath = this.worktreeService.getWorktreePath(input.repositoryPath, branch);
-        await this.worktreeService.create(input.repositoryPath, branch, worktreePath, defaultBranch);
+        const defaultBranch = await this.gitPrService.getDefaultBranch(effectiveRepoPath);
+        const worktreePath = this.worktreeService.getWorktreePath(effectiveRepoPath, branch);
+        await this.worktreeService.create(effectiveRepoPath, branch, worktreePath, defaultBranch);
         // Initialize spec directory — full user input goes into spec.yaml as-is
         const { specDir } = await this.specInitializer.initialize(worktreePath, slug, featureNumber, input.userInput);
         // Resolve or create repository entity for this path
-        const normalizedPath = input.repositoryPath.replace(/\/+$/, '') || input.repositoryPath;
+        const normalizedPath = effectiveRepoPath.replace(/\/+$/, '') || effectiveRepoPath;
         let repository = await this.repositoryRepo.findByPath(normalizedPath);
         if (!repository) {
             const repoName = normalizedPath.split('/').pop() ?? normalizedPath;
@@ -95,9 +135,9 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
             slug,
             description: metadata.description,
             userQuery: input.userInput,
-            repositoryPath: input.repositoryPath,
+            repositoryPath: effectiveRepoPath,
             branch,
-            lifecycle: SdlcLifecycle.Requirements,
+            lifecycle: initialLifecycle,
             messages: [],
             relatedArtifacts: [],
             push: input.push ?? false,
@@ -110,6 +150,7 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
             agentRunId: runId,
             specPath: specDir,
             repositoryId: repository.id,
+            ...(input.parentId ? { parentId: input.parentId } : {}),
             createdAt: now,
             updatedAt: now,
         };
@@ -124,18 +165,21 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
             prompt: input.userInput,
             threadId: randomUUID(),
             featureId: feature.id,
-            repositoryPath: input.repositoryPath,
+            repositoryPath: effectiveRepoPath,
             ...(input.approvalGates ? { approvalGates: input.approvalGates } : {}),
             createdAt: now.toISOString(),
             updatedAt: now.toISOString(),
         };
         await this.runRepository.create(agentRun);
-        this.agentProcess.spawn(feature.id, runId, input.repositoryPath, specDir, worktreePath, {
-            ...(input.approvalGates ? { approvalGates: input.approvalGates } : {}),
-            threadId: agentRun.threadId,
-            push: input.push ?? false,
-            openPr: input.openPr ?? false,
-        });
+        // Only spawn the agent immediately if the child is not blocked (FR-9, FR-16)
+        if (shouldSpawn) {
+            this.agentProcess.spawn(feature.id, runId, effectiveRepoPath, specDir, worktreePath, {
+                ...(input.approvalGates ? { approvalGates: input.approvalGates } : {}),
+                threadId: agentRun.threadId,
+                push: input.push ?? false,
+                openPr: input.openPr ?? false,
+            });
+        }
         return { feature, warning };
     }
 };

package/dist/packages/core/src/application/use-cases/features/create/types.d.ts

@@ -5,6 +5,8 @@ export interface CreateFeatureInput {
     approvalGates?: ApprovalGates;
     push?: boolean;
     openPr?: boolean;
+    /** Optional ID of the parent feature. When set, child may be created in Blocked state. */
+    parentId?: string;
 }
 export interface CreateFeatureResult {
     feature: Feature;

package/dist/packages/core/src/application/use-cases/features/create/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAErF,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAErF,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

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

@@ -1 +1 @@
-{"version":3,"file":"delete-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/delete-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAEvG,qBACa,oBAAoB;IAEC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAE5D,OAAO,CAAC,QAAQ,CAAC,cAAc;IACA,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAJR,WAAW,EAAE,kBAAkB,EACjC,eAAe,EAAE,gBAAgB,EAE7D,cAAc,EAAE,2BAA2B,EACZ,OAAO,EAAE,mBAAmB;IAGxE,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAyCnD"}
+{"version":3,"file":"delete-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/delete-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAEvG,qBACa,oBAAoB;IAEC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAE5D,OAAO,CAAC,QAAQ,CAAC,cAAc;IACA,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAJR,WAAW,EAAE,kBAAkB,EACjC,eAAe,EAAE,gBAAgB,EAE7D,cAAc,EAAE,2BAA2B,EACZ,OAAO,EAAE,mBAAmB;IAGxE,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAqDnD"}

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

@@ -24,7 +24,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { injectable, inject } from 'tsyringe';
-import { AgentRunStatus } from '../../../domain/generated/output.js';
+import { AgentRunStatus, SdlcLifecycle } from '../../../domain/generated/output.js';
 let DeleteFeatureUseCase = class DeleteFeatureUseCase {
     featureRepo;
     worktreeService;
@@ -43,7 +43,14 @@ let DeleteFeatureUseCase = class DeleteFeatureUseCase {
         if (!feature) {
             throw new Error(`Feature not found: "${featureId}"`);
         }
-        // 2. Cancel running/pending agent run if present
+        // 2. Guard: reject deletion if blocked children exist (FR-29)
+        const blockedChildren = (await this.featureRepo.findByParentId(feature.id)).filter((child) => child.lifecycle === SdlcLifecycle.Blocked);
+        if (blockedChildren.length > 0) {
+            const list = blockedChildren.map((c) => `${c.id} (${c.name})`).join(', ');
+            throw new Error(`Cannot delete feature "${feature.name}" because it has blocked children: ${list}. ` +
+                `Remove or re-parent the blocked children before deleting this feature.`);
+        }
+        // 3. Cancel running/pending agent run if present
         if (feature.agentRunId) {
             const run = await this.runRepo.findById(feature.agentRunId);
             if (run && (run.status === AgentRunStatus.running || run.status === AgentRunStatus.pending)) {
@@ -59,7 +66,7 @@ let DeleteFeatureUseCase = class DeleteFeatureUseCase {
                 await this.runRepo.updateStatus(run.id, AgentRunStatus.cancelled);
             }
         }
-        // 3. Remove worktree (ignore errors if already removed)
+        // 4. Remove worktree (ignore errors if already removed)
         const worktreePath = this.worktreeService.getWorktreePath(feature.repositoryPath, feature.branch);
         try {
             await this.worktreeService.remove(worktreePath);
@@ -67,7 +74,7 @@ let DeleteFeatureUseCase = class DeleteFeatureUseCase {
         catch {
             // Worktree might already be removed - that's fine
         }
-        // 4. Delete feature record
+        // 5. Delete feature record
         await this.featureRepo.delete(feature.id);
         return feature;
     }

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

@@ -0,0 +1,28 @@
+/**
+ * UpdateFeatureLifecycleUseCase
+ *
+ * Centralises all feature lifecycle transitions. Every call to this use case:
+ * 1. Persists the new lifecycle value via the feature repository.
+ * 2. Immediately calls CheckAndUnblockFeaturesUseCase to evaluate whether
+ *    any blocked children can now be unblocked.
+ *
+ * This is the single hook point that ensures auto-unblocking fires on every
+ * lifecycle transition made by the feature agent, satisfying FR-17.
+ *
+ * No-op when the feature is not found (swallowed gracefully so agent nodes
+ * do not crash on a missing feature record).
+ */
+import type { SdlcLifecycle } from '../../../../domain/generated/output.js';
+import type { IFeatureRepository } from '../../../ports/output/repositories/feature-repository.interface.js';
+import { CheckAndUnblockFeaturesUseCase } from '../check-and-unblock-features.use-case.js';
+export interface UpdateFeatureLifecycleInput {
+    featureId: string;
+    lifecycle: SdlcLifecycle;
+}
+export declare class UpdateFeatureLifecycleUseCase {
+    private readonly featureRepo;
+    private readonly checkAndUnblock;
+    constructor(featureRepo: IFeatureRepository, checkAndUnblock: CheckAndUnblockFeaturesUseCase);
+    execute(input: UpdateFeatureLifecycleInput): Promise<void>;
+}
+//# sourceMappingURL=update-feature-lifecycle.use-case.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-feature-lifecycle.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/update/update-feature-lifecycle.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oEAAoE,CAAC;AAC7G,OAAO,EAAE,8BAA8B,EAAE,MAAM,2CAA2C,CAAC;AAE3F,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED,qBACa,6BAA6B;IAER,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE1D,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAFe,WAAW,EAAE,kBAAkB,EAE7D,eAAe,EAAE,8BAA8B;IAG5D,OAAO,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;CAYjE"}

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

@@ -0,0 +1,53 @@
+/**
+ * UpdateFeatureLifecycleUseCase
+ *
+ * Centralises all feature lifecycle transitions. Every call to this use case:
+ * 1. Persists the new lifecycle value via the feature repository.
+ * 2. Immediately calls CheckAndUnblockFeaturesUseCase to evaluate whether
+ *    any blocked children can now be unblocked.
+ *
+ * This is the single hook point that ensures auto-unblocking fires on every
+ * lifecycle transition made by the feature agent, satisfying FR-17.
+ *
+ * No-op when the feature is not found (swallowed gracefully so agent nodes
+ * do not crash on a missing feature record).
+ */
+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 { CheckAndUnblockFeaturesUseCase } from '../check-and-unblock-features.use-case.js';
+let UpdateFeatureLifecycleUseCase = class UpdateFeatureLifecycleUseCase {
+    featureRepo;
+    checkAndUnblock;
+    constructor(featureRepo, checkAndUnblock) {
+        this.featureRepo = featureRepo;
+        this.checkAndUnblock = checkAndUnblock;
+    }
+    async execute(input) {
+        const feature = await this.featureRepo.findById(input.featureId);
+        if (!feature) {
+            return;
+        }
+        feature.lifecycle = input.lifecycle;
+        feature.updatedAt = new Date();
+        await this.featureRepo.update(feature);
+        await this.checkAndUnblock.execute(input.featureId);
+    }
+};
+UpdateFeatureLifecycleUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IFeatureRepository')),
+    __param(1, inject(CheckAndUnblockFeaturesUseCase)),
+    __metadata("design:paramtypes", [Object, CheckAndUnblockFeaturesUseCase])
+], UpdateFeatureLifecycleUseCase);
+export { UpdateFeatureLifecycleUseCase };

package/dist/packages/core/src/domain/generated/output.d.ts

@@ -332,6 +332,18 @@ export type WorkflowConfig = {
      * Default approval gate preferences for new features
      */
     approvalGateDefaults: ApprovalGateDefaults;
+    /**
+     * Maximum number of CI fix/push/watch iterations before giving up (default: 3)
+     */
+    ciMaxFixAttempts?: number;
+    /**
+     * Timeout in milliseconds for watching a CI run (default: 600000 = 10 minutes)
+     */
+    ciWatchTimeoutMs?: number;
+    /**
+     * Maximum characters of CI failure logs to pass to the executor (default: 50000)
+     */
+    ciLogMaxChars?: number;
 };
 export declare enum AgentType {
     ClaudeCode = "claude-code",
@@ -594,7 +606,8 @@ export declare enum SdlcLifecycle {
     Planning = "Planning",
     Implementation = "Implementation",
     Review = "Review",
-    Maintain = "Maintain"
+    Maintain = "Maintain",
+    Blocked = "Blocked"
 }
 /**
  * Configuration for human-in-the-loop approval gates
@@ -623,6 +636,27 @@ export declare enum CiStatus {
     Success = "Success",
     Failure = "Failure"
 }
+/**
+ * Record of one CI fix attempt in the watch/fix loop
+ */
+export type CiFixRecord = {
+    /**
+     * 1-based attempt number
+     */
+    attempt: number;
+    /**
+     * ISO timestamp when this attempt started
+     */
+    startedAt: string;
+    /**
+     * First 500 chars of failure logs for this attempt
+     */
+    failureSummary: string;
+    /**
+     * Outcome of this attempt: fixed, failed, or timeout
+     */
+    outcome: string;
+};
 /**
  * Pull request tracking data for a feature
  */
@@ -647,6 +681,14 @@ export type PullRequest = {
      * CI pipeline status
      */
     ciStatus?: CiStatus;
+    /**
+     * Number of CI fix attempts made
+     */
+    ciFixAttempts?: number;
+    /**
+     * History of CI fix attempts
+     */
+    ciFixHistory?: CiFixRecord[];
 };
 /**
  * Central entity tracking a piece of work through the SDLC lifecycle (Aggregate Root)
@@ -724,6 +766,10 @@ export type Feature = BaseEntity & {
      * Pull request data (null until PR created)
      */
     pr?: PullRequest;
+    /**
+     * Parent feature ID for dependency tracking (optional)
+     */
+    parentId?: UUID;
 };
 /**
  * Option for resolving an open question