@shepai/cli 1.116.3-pr375.ea5b2a2 → 1.117.0-pr367.ca5b6ac

package/apis/json-schema/AnalyzeRepoTimeouts.yaml

@@ -0,0 +1,10 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: AnalyzeRepoTimeouts.yaml
+type: object
+properties:
+  analyzeMs:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: "Timeout for the repository analysis stage (default: 600000)"
+description: Timeout overrides for the analyze-repository agent (all values in milliseconds)

package/apis/json-schema/SdlcLifecycle.yaml

@@ -11,5 +11,6 @@ enum:
   - Review
   - Maintain
   - Blocked
+  - Pending
   - Deleting
 description: Software Development Lifecycle stages for feature progression

package/apis/json-schema/StageTimeouts.yaml

@@ -0,0 +1,35 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: StageTimeouts.yaml
+type: object
+properties:
+  analyzeMs:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: "Timeout for the analyze stage (default: 600000)"
+  requirementsMs:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: "Timeout for the requirements stage (default: 600000)"
+  researchMs:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: "Timeout for the research stage (default: 600000)"
+  planMs:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: "Timeout for the plan stage (default: 600000)"
+  implementMs:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: "Timeout for the implement stage (default: 600000)"
+  mergeMs:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: "Timeout for the merge stage (default: 600000)"
+description: Per-stage timeout overrides for the feature agent workflow (all values in milliseconds)

package/apis/json-schema/WorkflowConfig.yaml

@@ -24,6 +24,12 @@ properties:
     minimum: -2147483648
     maximum: 2147483647
     description: "Maximum characters of CI failure logs to pass to the executor (default: 50000)"
+  stageTimeouts:
+    $ref: StageTimeouts.yaml
+    description: "Per-stage timeout overrides for the feature agent (default: 600000 = 10 minutes per stage)"
+  analyzeRepoTimeouts:
+    $ref: AnalyzeRepoTimeouts.yaml
+    description: "Timeout overrides for the analyze-repository agent (default: 600000 = 10 minutes)"
   enableEvidence:
     type: boolean
     default: false

package/dist/packages/core/src/application/ports/output/services/index.d.ts

@@ -17,4 +17,6 @@ export { GitPrError, GitPrErrorCode } from './git-pr-service.interface.js';
 export type { IIdeLauncherService, LaunchIdeInput, LaunchIdeResult, LaunchIdeSuccess, LaunchIdeFailed, } from './ide-launcher-service.interface.js';
 export type { IDaemonService, DaemonState } from './daemon-service.interface.js';
 export type { IDeploymentService, DeploymentStatus } from './deployment-service.interface.js';
+export type { ITunnelService, TunnelUrlChangeHandler } from './tunnel-service.interface.js';
+export type { IWebhookService, WebhookEvent, WebhookValidationResult, } from './webhook-service.interface.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/application/ports/output/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,YAAY,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,YAAY,EACV,eAAe,EACf,YAAY,EACZ,uBAAuB,GACxB,MAAM,gCAAgC,CAAC"}

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

@@ -0,0 +1,41 @@
+/**
+ * Tunnel Service Interface
+ *
+ * Output port for managing a reverse tunnel that exposes local endpoints
+ * to the public internet. Used to receive webhooks from external services
+ * (e.g., GitHub) when running locally.
+ *
+ * Implementations must:
+ * - Start a tunnel process pointing at a local port
+ * - Expose only a specific URL path (e.g., /api/webhooks)
+ * - Detect when the public URL changes (tunnel reconnection)
+ * - Support graceful shutdown
+ */
+export type TunnelUrlChangeHandler = (newUrl: string) => void | Promise<void>;
+export interface ITunnelService {
+    /**
+     * Start the tunnel, exposing a local port to the internet.
+     *
+     * @param localPort - Local port to tunnel traffic to
+     * @returns The public URL assigned by the tunnel provider
+     */
+    start(localPort: number): Promise<string>;
+    /**
+     * Stop the tunnel and clean up the child process.
+     */
+    stop(): Promise<void>;
+    /**
+     * Get the current public URL, or null if the tunnel is not running.
+     */
+    getPublicUrl(): string | null;
+    /**
+     * Register a callback that fires when the tunnel URL changes
+     * (e.g., after a reconnection assigns a new random subdomain).
+     */
+    onUrlChange(handler: TunnelUrlChangeHandler): void;
+    /**
+     * Whether the tunnel process is currently running.
+     */
+    isRunning(): boolean;
+}
+//# sourceMappingURL=tunnel-service.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/tunnel-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1C;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI,CAAC;IAE9B;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAEnD;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC;CACtB"}

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

@@ -0,0 +1,14 @@
+/**
+ * Tunnel Service Interface
+ *
+ * Output port for managing a reverse tunnel that exposes local endpoints
+ * to the public internet. Used to receive webhooks from external services
+ * (e.g., GitHub) when running locally.
+ *
+ * Implementations must:
+ * - Start a tunnel process pointing at a local port
+ * - Expose only a specific URL path (e.g., /api/webhooks)
+ * - Detect when the public URL changes (tunnel reconnection)
+ * - Support graceful shutdown
+ */
+export {};

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

@@ -0,0 +1,65 @@
+/**
+ * Webhook Service Interface
+ *
+ * Output port for managing webhook registrations with external services
+ * (e.g., GitHub) and processing incoming webhook events.
+ *
+ * Works alongside the polling-based PrSyncWatcher to provide near-instant
+ * event delivery when a tunnel is available, with polling as fallback.
+ */
+/**
+ * Parsed webhook event from an external service.
+ */
+export interface WebhookEvent {
+    /** Source service (e.g., 'github') */
+    source: string;
+    /** Event type (e.g., 'pull_request', 'check_suite') */
+    eventType: string;
+    /** Delivery ID for deduplication */
+    deliveryId: string;
+    /** Full event payload */
+    payload: Record<string, unknown>;
+}
+/**
+ * Result of webhook signature validation.
+ */
+export interface WebhookValidationResult {
+    valid: boolean;
+    error?: string;
+}
+export interface IWebhookService {
+    /**
+     * Register webhooks for all tracked repositories.
+     *
+     * @param publicUrl - The public tunnel URL where webhooks will be received
+     */
+    registerWebhooks(publicUrl: string): Promise<void>;
+    /**
+     * Update the webhook URL for all registered webhooks.
+     * Called when the tunnel reconnects with a new URL.
+     *
+     * @param newUrl - The new public tunnel URL
+     */
+    updateWebhookUrl(newUrl: string): Promise<void>;
+    /**
+     * Remove all registered webhooks (cleanup on shutdown).
+     */
+    removeWebhooks(): Promise<void>;
+    /**
+     * Validate an incoming webhook request signature.
+     *
+     * @param payload - Raw request body
+     * @param signature - Signature header value
+     * @param secret - The webhook secret used for HMAC
+     * @returns Validation result
+     */
+    validateSignature(payload: string, signature: string, secret: string): WebhookValidationResult;
+    /**
+     * Process an incoming webhook event.
+     * Routes the event to the appropriate handler (e.g., PR status update).
+     *
+     * @param event - The parsed webhook event
+     */
+    handleEvent(event: WebhookEvent): Promise<void>;
+}
+//# sourceMappingURL=webhook-service.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-service.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/webhook-service.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;;;;;;OAOG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,uBAAuB,CAAC;IAE/F;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD"}

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

@@ -0,0 +1,10 @@
+/**
+ * Webhook Service Interface
+ *
+ * Output port for managing webhook registrations with external services
+ * (e.g., GitHub) and processing incoming webhook events.
+ *
+ * Works alongside the polling-based PrSyncWatcher to provide near-instant
+ * event delivery when a tunnel is available, with polling as fallback.
+ */
+export {};

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;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAMtE,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;AAChG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2DAA2D,CAAC;AAGjG,OAAO,EAAE,wBAAwB,EAAE,MAAM,mEAAmE,CAAC;AAC7G,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE9F,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;IAE7B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,cAAc;gBApBd,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,EAE3B,iBAAiB,EAAE,wBAAwB,EAE3C,cAAc,EAAE,eAAe;IAGlD;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMtE;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAyH1E;;;OAGG;IACG,kBAAkB,CACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,kBAAkB,EACzB,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC;CAgI1D"}
+{"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;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAMtE,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;AAChG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2DAA2D,CAAC;AAGjG,OAAO,EAAE,wBAAwB,EAAE,MAAM,mEAAmE,CAAC;AAC7G,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE9F,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;IAE7B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,cAAc;gBApBd,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,EAE3B,iBAAiB,EAAE,wBAAwB,EAE3C,cAAc,EAAE,eAAe;IAGlD;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMtE;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmI1E;;;OAGG;IACG,kBAAkB,CACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,kBAAkB,EACzB,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC;CAgI1D"}

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

@@ -80,6 +80,12 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
             : SdlcLifecycle.Requirements;
         let shouldSpawn = true;
         let effectiveRepoPath = input.repositoryPath.replace(/\\/g, '/');
+        // Pending flag takes precedence — user explicitly defers agent execution.
+        // Parent gate validation is deferred to StartFeatureUseCase.
+        if (input.pending) {
+            initialLifecycle = SdlcLifecycle.Pending;
+            shouldSpawn = false;
+        }
         if (input.parentId) {
             const parent = await this.featureRepo.findById(input.parentId);
             if (!parent) {
@@ -97,14 +103,17 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
                 const ancestor = await this.featureRepo.findById(cursor);
                 cursor = ancestor?.parentId ?? undefined;
             }
-            if (parent.lifecycle === SdlcLifecycle.Blocked ||
-                !POST_IMPLEMENTATION.has(parent.lifecycle)) {
-                initialLifecycle = SdlcLifecycle.Blocked;
-                shouldSpawn = false;
-            }
-            else {
-                initialLifecycle = SdlcLifecycle.Started;
-                shouldSpawn = true;
+            // Skip gate logic when pending — parent gate is deferred to start time
+            if (!input.pending) {
+                if (parent.lifecycle === SdlcLifecycle.Blocked ||
+                    !POST_IMPLEMENTATION.has(parent.lifecycle)) {
+                    initialLifecycle = SdlcLifecycle.Blocked;
+                    shouldSpawn = false;
+                }
+                else {
+                    initialLifecycle = SdlcLifecycle.Started;
+                    shouldSpawn = true;
+                }
             }
         }
         // Resolve or create repository entity for this path

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

@@ -13,6 +13,8 @@ export interface CreateFeatureInput {
     description?: string;
     /** When true, skip SDLC phases and implement directly from the user prompt. */
     fast?: boolean;
+    /** When true, create feature in Pending state — fully initialized but agent not spawned. */
+    pending?: boolean;
     /** Optional agent type override (overrides settings.agent.type). */
     agentType?: string;
     /** Optional model identifier forwarded to the agent executor for this invocation. */

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,UAAU,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAEjG,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;IAClB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,WAAW,EAAE,OAAO,CAAC;CACtB"}
+{"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,UAAU,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAEjG,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;IAClB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4FAA4F;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,WAAW,EAAE,OAAO,CAAC;CACtB"}

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

@@ -19,8 +19,6 @@ export declare class ResumeFeatureUseCase {
     private readonly processService;
     private readonly worktreeService;
     constructor(featureRepo: IFeatureRepository, runRepo: IAgentRunRepository, processService: IFeatureAgentProcessService, worktreeService: IWorktreeService);
-    execute(featureId: string, options?: {
-        promptPrefix?: string;
-    }): Promise<ResumeFeatureResult>;
+    execute(featureId: string): Promise<ResumeFeatureResult>;
 }
 //# sourceMappingURL=resume-feature.use-case.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"resume-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/resume-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAE7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAQlG,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,eAAe;gBANf,WAAW,EAAE,kBAAkB,EAE/B,OAAO,EAAE,mBAAmB,EAE5B,cAAc,EAAE,2BAA2B,EAE3C,eAAe,EAAE,gBAAgB;IAG9C,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAClC,OAAO,CAAC,mBAAmB,CAAC;CAuGhC"}
+{"version":3,"file":"resume-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/resume-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAE7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAQlG,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,eAAe;gBANf,WAAW,EAAE,kBAAkB,EAE/B,OAAO,EAAE,mBAAmB,EAE5B,cAAc,EAAE,2BAA2B,EAE3C,eAAe,EAAE,gBAAgB;IAG9C,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAqG/D"}

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

@@ -35,7 +35,7 @@ let ResumeFeatureUseCase = class ResumeFeatureUseCase {
         this.processService = processService;
         this.worktreeService = worktreeService;
     }
-    async execute(featureId, options) {
+    async execute(featureId) {
         // Resolve feature by exact ID or prefix
         const feature = (await this.featureRepo.findById(featureId)) ??
             (await this.featureRepo.findByIdPrefix(featureId));
@@ -79,9 +79,7 @@ let ResumeFeatureUseCase = class ResumeFeatureUseCase {
             agentType: lastRun.agentType,
             agentName: lastRun.agentName,
             status: AgentRunStatus.pending,
-            prompt: options?.promptPrefix
-                ? `${options.promptPrefix}\n\n${lastRun.prompt}`
-                : lastRun.prompt,
+            prompt: lastRun.prompt,
             threadId: lastRun.threadId, // Same thread for checkpoint continuity
             featureId: feature.id,
             repositoryPath: feature.repositoryPath,

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

@@ -0,0 +1,25 @@
+/**
+ * Start Feature Use Case
+ *
+ * Transitions a Pending feature to its active lifecycle and spawns
+ * the agent. Validates lifecycle state, checks parent dependency
+ * gates, and reuses the existing AgentRun record.
+ */
+import type { Feature, AgentRun } from '../../../domain/generated/output.js';
+import type { IFeatureRepository } from '../../ports/output/repositories/feature-repository.interface.js';
+import type { IAgentRunRepository } from '../../ports/output/agents/agent-run-repository.interface.js';
+import type { IFeatureAgentProcessService } from '../../ports/output/agents/feature-agent-process.interface.js';
+import type { IWorktreeService } from '../../ports/output/services/worktree-service.interface.js';
+export interface StartFeatureResult {
+    feature: Feature;
+    agentRun: AgentRun;
+}
+export declare class StartFeatureUseCase {
+    private readonly featureRepo;
+    private readonly runRepo;
+    private readonly processService;
+    private readonly worktreeService;
+    constructor(featureRepo: IFeatureRepository, runRepo: IAgentRunRepository, processService: IFeatureAgentProcessService, worktreeService: IWorktreeService);
+    execute(featureId: string): Promise<StartFeatureResult>;
+}
+//# sourceMappingURL=start-feature.use-case.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/features/start-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAE7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAGlG,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,qBACa,mBAAmB;IAG5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,eAAe;gBANf,WAAW,EAAE,kBAAkB,EAE/B,OAAO,EAAE,mBAAmB,EAE5B,cAAc,EAAE,2BAA2B,EAE3C,eAAe,EAAE,gBAAgB;IAG9C,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAoG9D"}

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

@@ -0,0 +1,116 @@
+/**
+ * Start Feature Use Case
+ *
+ * Transitions a Pending feature to its active lifecycle and spawns
+ * the agent. Validates lifecycle state, checks parent dependency
+ * gates, and reuses the existing AgentRun 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 { SdlcLifecycle } from '../../../domain/generated/output.js';
+import { POST_IMPLEMENTATION } from '../../../domain/lifecycle-gates.js';
+let StartFeatureUseCase = class StartFeatureUseCase {
+    featureRepo;
+    runRepo;
+    processService;
+    worktreeService;
+    constructor(featureRepo, runRepo, processService, worktreeService) {
+        this.featureRepo = featureRepo;
+        this.runRepo = runRepo;
+        this.processService = processService;
+        this.worktreeService = worktreeService;
+    }
+    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}`);
+        }
+        // Validate lifecycle is Pending
+        if (feature.lifecycle !== SdlcLifecycle.Pending) {
+            throw new Error(`Feature "${feature.name}" is not in Pending state (current: ${feature.lifecycle}). Only pending features can be started.`);
+        }
+        // Validate agentRunId exists
+        if (!feature.agentRunId) {
+            throw new Error(`No agent run found for feature "${feature.name}"`);
+        }
+        const agentRun = await this.runRepo.findById(feature.agentRunId);
+        if (!agentRun) {
+            throw new Error(`No agent run found for feature "${feature.name}"`);
+        }
+        // Wait for specPath — the web UI creates features in two phases: a fast
+        // DB record (specPath: '') followed by background initialization that
+        // populates specPath. If the user clicks "Start" before Phase 2 finishes,
+        // specPath will still be empty. Poll the DB briefly to let it complete.
+        let resolved = feature;
+        if (!resolved.specPath) {
+            const MAX_POLLS = 20;
+            const POLL_INTERVAL_MS = 500;
+            for (let i = 0; i < MAX_POLLS; i++) {
+                await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+                const refreshed = await this.featureRepo.findById(resolved.id);
+                if (refreshed?.specPath) {
+                    resolved = refreshed;
+                    break;
+                }
+            }
+            if (!resolved.specPath) {
+                throw new Error(`Feature "${resolved.name}" is still being initialized — please try again shortly`);
+            }
+        }
+        // Check parent gate if feature has a parent
+        let targetLifecycle = resolved.fast ? SdlcLifecycle.Implementation : SdlcLifecycle.Requirements;
+        let shouldSpawn = true;
+        if (resolved.parentId) {
+            const parent = await this.featureRepo.findById(resolved.parentId);
+            if (!parent ||
+                parent.lifecycle === SdlcLifecycle.Blocked ||
+                !POST_IMPLEMENTATION.has(parent.lifecycle)) {
+                targetLifecycle = SdlcLifecycle.Blocked;
+                shouldSpawn = false;
+            }
+        }
+        // Transition lifecycle
+        const updatedFeature = {
+            ...resolved,
+            lifecycle: targetLifecycle,
+            updatedAt: new Date(),
+        };
+        await this.featureRepo.update(updatedFeature);
+        // Spawn agent if not blocked
+        if (shouldSpawn) {
+            const worktreePath = this.worktreeService.getWorktreePath(resolved.repositoryPath, resolved.branch);
+            this.processService.spawn(resolved.id, resolved.agentRunId, resolved.repositoryPath, resolved.specPath, worktreePath, {
+                approvalGates: resolved.approvalGates,
+                threadId: agentRun.threadId,
+                push: resolved.push,
+                openPr: resolved.openPr,
+                agentType: agentRun.agentType,
+                ...(resolved.fast ? { fast: true } : {}),
+                ...(agentRun.modelId ? { model: agentRun.modelId } : {}),
+            });
+        }
+        return { feature: updatedFeature, agentRun };
+    }
+};
+StartFeatureUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IFeatureRepository')),
+    __param(1, inject('IAgentRunRepository')),
+    __param(2, inject('IFeatureAgentProcessService')),
+    __param(3, inject('IWorktreeService')),
+    __metadata("design:paramtypes", [Object, Object, Object, Object])
+], StartFeatureUseCase);
+export { StartFeatureUseCase };

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

@@ -308,6 +308,44 @@ export type ApprovalGateDefaults = {
      */
     pushOnImplementationComplete: boolean;
 };
+/**
+ * Per-stage timeout overrides for the feature agent workflow (all values in milliseconds)
+ */
+export type StageTimeouts = {
+    /**
+     * Timeout for the analyze stage (default: 600000)
+     */
+    analyzeMs?: number;
+    /**
+     * Timeout for the requirements stage (default: 600000)
+     */
+    requirementsMs?: number;
+    /**
+     * Timeout for the research stage (default: 600000)
+     */
+    researchMs?: number;
+    /**
+     * Timeout for the plan stage (default: 600000)
+     */
+    planMs?: number;
+    /**
+     * Timeout for the implement stage (default: 600000)
+     */
+    implementMs?: number;
+    /**
+     * Timeout for the merge stage (default: 600000)
+     */
+    mergeMs?: number;
+};
+/**
+ * Timeout overrides for the analyze-repository agent (all values in milliseconds)
+ */
+export type AnalyzeRepoTimeouts = {
+    /**
+     * Timeout for the repository analysis stage (default: 600000)
+     */
+    analyzeMs?: number;
+};
 /**
  * Global workflow configuration defaults
  */
@@ -332,6 +370,14 @@ export type WorkflowConfig = {
      * Maximum characters of CI failure logs to pass to the executor (default: 50000)
      */
     ciLogMaxChars?: number;
+    /**
+     * Per-stage timeout overrides for the feature agent (default: 600000 = 10 minutes per stage)
+     */
+    stageTimeouts?: StageTimeouts;
+    /**
+     * Timeout overrides for the analyze-repository agent (default: 600000 = 10 minutes)
+     */
+    analyzeRepoTimeouts?: AnalyzeRepoTimeouts;
     /**
      * Enable evidence collection after implementation (default: false)
      */
@@ -649,6 +695,7 @@ export declare enum SdlcLifecycle {
     Review = "Review",
     Maintain = "Maintain",
     Blocked = "Blocked",
+    Pending = "Pending",
     Deleting = "Deleting"
 }
 /**