@shepai/cli 1.74.0 → 1.75.0-pr237.5e7fa4f

package/dist/packages/core/src/application/ports/output/agents/feature-agent-process.interface.d.ts

@@ -32,6 +32,7 @@ export interface IFeatureAgentProcessService {
         openPr?: boolean;
         resumePayload?: string;
         agentType?: AgentType;
+        fast?: boolean;
     }): number;
     /**
      * Check if a process is still alive.

package/dist/packages/core/src/application/ports/output/agents/feature-agent-process.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-agent-process.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/feature-agent-process.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;OAQG;IACH,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,SAAS,CAAC;KACvB,GACA,MAAM,CAAC;IAEV;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE9B;;;;;OAKG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD"}
+{"version":3,"file":"feature-agent-process.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/feature-agent-process.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;OAQG;IACH,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,GACA,MAAM,CAAC;IAEV;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE9B;;;;;OAKG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD"}

package/dist/packages/core/src/application/ports/output/services/spec-initializer.interface.d.ts

@@ -22,12 +22,15 @@ export interface ISpecInitializerService {
      * - tasks.yaml
      * - feature.yaml
      *
+     * When mode is 'fast', only feature.yaml is created (no spec/research/plan/tasks).
+     *
      * @param basePath - Directory to create specs/ in (typically the worktree path)
      * @param slug - Feature slug (kebab-case, e.g., "user-authentication")
      * @param featureNumber - Sequential feature number (will be zero-padded to 3 digits)
      * @param description - Feature description for template substitution
+     * @param mode - Optional mode; when 'fast', only feature.yaml is created
      * @returns The spec directory path and feature number used
      */
-    initialize(basePath: string, slug: string, featureNumber: number, description: string): Promise<SpecInitializerResult>;
+    initialize(basePath: string, slug: string, featureNumber: number, description: string, mode?: 'fast'): Promise<SpecInitializerResult>;
 }
 //# sourceMappingURL=spec-initializer.interface.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"spec-initializer.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/spec-initializer.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACnC"}
+{"version":3,"file":"spec-initializer.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/spec-initializer.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;;;;;;;;;OAkBG;IACH,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACnC"}

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;AAEtE,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,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;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;IAG9C;;;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;IAgH1E;;;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;CAiE1D"}
+{"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;AAEtE,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,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;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;IAG9C;;;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;IAkH1E;;;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;CAmE1D"}

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

@@ -70,7 +70,9 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
      * No AI calls, no git operations — just DB writes.
      */
     async createRecord(input) {
-        let initialLifecycle = SdlcLifecycle.Requirements;
+        let initialLifecycle = input.fast
+            ? SdlcLifecycle.Implementation
+            : SdlcLifecycle.Requirements;
         let shouldSpawn = true;
         let effectiveRepoPath = input.repositoryPath;
         if (input.parentId) {
@@ -188,7 +190,7 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
         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);
+        const { specDir } = await this.specInitializer.initialize(worktreePath, slug, featureNumber, input.userInput, input.fast ? 'fast' : undefined);
         // Update feature record with refined metadata, branch, and specPath
         const updatedFeature = {
             ...feature,
@@ -208,6 +210,7 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
                 threadId: agentRun?.threadId ?? randomUUID(),
                 push: input.push ?? false,
                 openPr: input.openPr ?? false,
+                ...(input.fast ? { fast: true } : {}),
             });
         }
         return { warning, updatedFeature };

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

@@ -11,6 +11,8 @@ export interface CreateFeatureInput {
     name?: string;
     /** Pre-supplied description (skips AI metadata extraction for description). */
     description?: string;
+    /** When true, skip SDLC phases and implement directly from the user prompt. */
+    fast?: boolean;
 }
 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;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;CACtB;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,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;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;CAChB;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/infrastructure/services/agents/feature-agent/fast-feature-agent-graph.d.ts

@@ -0,0 +1,220 @@
+/**
+ * Fast Feature Agent Graph Factory
+ *
+ * Creates a LangGraph StateGraph with only 2 nodes: fast-implement → merge.
+ * This is the fast-mode alternative to createFeatureAgentGraph() which has
+ * 15+ nodes. The merge node and its CI watch/fix loop are reused via
+ * composition from the full graph's createMergeNode().
+ *
+ * Uses the same FeatureAgentAnnotation state shape as the full graph,
+ * enabling checkpointing, resume, and identical worker lifecycle handling.
+ */
+import { type BaseCheckpointSaver } from '@langchain/langgraph';
+import type { IAgentExecutor } from '../../../../application/ports/output/agents/agent-executor.interface.js';
+import { type MergeNodeDeps } from './nodes/merge/merge.node.js';
+export { FeatureAgentAnnotation, type FeatureAgentState } from './state.js';
+/**
+ * Dependencies needed to build the fast feature agent graph.
+ * Same shape as FeatureAgentGraphDeps for consistency.
+ */
+export interface FastFeatureAgentGraphDeps {
+    executor: IAgentExecutor;
+    mergeNodeDeps?: Omit<MergeNodeDeps, 'executor'>;
+}
+/**
+ * Factory function that creates and compiles the fast-mode feature agent graph.
+ *
+ * The graph defines a minimal workflow:
+ *   START → fast-implement → merge → conditional(reexecute or END)
+ *
+ * When merge is rejected, routeReexecution routes back to fast-implement
+ * for a fresh implementation pass.
+ *
+ * @param depsOrExecutor - Graph dependencies or a legacy executor
+ * @param checkpointer - Optional checkpoint saver for state persistence
+ * @returns A compiled LangGraph ready to be invoked
+ */
+export declare function createFastFeatureAgentGraph(depsOrExecutor: FastFeatureAgentGraphDeps | IAgentExecutor, checkpointer?: BaseCheckpointSaver): import("@langchain/langgraph").CompiledStateGraph<{
+    featureId: string;
+    repositoryPath: string;
+    specDir: string;
+    worktreePath: string;
+    currentNode: string;
+    error: string | null;
+    approvalGates: import("../../../../domain/index.js").ApprovalGates | undefined;
+    messages: string[];
+    validationRetries: number;
+    lastValidationTarget: string;
+    lastValidationErrors: string[];
+    _approvalAction: string | null;
+    _rejectionFeedback: string | null;
+    _needsReexecution: boolean;
+    prUrl: string | null;
+    prNumber: number | null;
+    commitHash: string | null;
+    ciStatus: string | null;
+    push: boolean;
+    openPr: boolean;
+    ciFixAttempts: number;
+    ciFixHistory: import("../../../../domain/index.js").CiFixRecord[];
+    ciFixStatus: "success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted";
+}, {
+    featureId?: string | undefined;
+    repositoryPath?: string | undefined;
+    specDir?: string | undefined;
+    worktreePath?: string | undefined;
+    currentNode?: string | undefined;
+    error?: string | null | undefined;
+    approvalGates?: import("../../../../domain/index.js").ApprovalGates | undefined;
+    messages?: string[] | undefined;
+    validationRetries?: number | undefined;
+    lastValidationTarget?: string | undefined;
+    lastValidationErrors?: string[] | undefined;
+    _approvalAction?: string | null | undefined;
+    _rejectionFeedback?: string | null | undefined;
+    _needsReexecution?: boolean | undefined;
+    prUrl?: string | null | undefined;
+    prNumber?: number | null | undefined;
+    commitHash?: string | null | undefined;
+    ciStatus?: string | null | undefined;
+    push?: boolean | undefined;
+    openPr?: boolean | undefined;
+    ciFixAttempts?: number | undefined;
+    ciFixHistory?: import("../../../../domain/index.js").CiFixRecord[] | undefined;
+    ciFixStatus?: "success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted" | undefined;
+}, "__start__" | "fast-implement", {
+    featureId: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    repositoryPath: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    specDir: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    worktreePath: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    currentNode: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    error: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    approvalGates: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").ApprovalGates | undefined, import("../../../../domain/index.js").ApprovalGates | undefined>;
+    messages: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    validationRetries: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    lastValidationTarget: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+    lastValidationErrors: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    _approvalAction: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    _rejectionFeedback: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    _needsReexecution: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    prUrl: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    prNumber: import("@langchain/langgraph").BinaryOperatorAggregate<number | null, number | null>;
+    commitHash: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    ciStatus: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    push: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    openPr: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    ciFixAttempts: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    ciFixHistory: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").CiFixRecord[], import("../../../../domain/index.js").CiFixRecord[]>;
+    ciFixStatus: import("@langchain/langgraph").BinaryOperatorAggregate<"success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted", "success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted">;
+}, {
+    featureId: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    repositoryPath: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    specDir: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    worktreePath: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    currentNode: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    error: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    approvalGates: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").ApprovalGates | undefined, import("../../../../domain/index.js").ApprovalGates | undefined>;
+    messages: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    validationRetries: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    lastValidationTarget: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+    lastValidationErrors: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    _approvalAction: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    _rejectionFeedback: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    _needsReexecution: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    prUrl: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    prNumber: import("@langchain/langgraph").BinaryOperatorAggregate<number | null, number | null>;
+    commitHash: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    ciStatus: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    push: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    openPr: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+    ciFixAttempts: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    ciFixHistory: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").CiFixRecord[], import("../../../../domain/index.js").CiFixRecord[]>;
+    ciFixStatus: import("@langchain/langgraph").BinaryOperatorAggregate<"success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted", "success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted">;
+}, import("@langchain/langgraph").StateDefinition, {
+    "fast-implement": Partial<import("@langchain/langgraph").StateType<{
+        featureId: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        repositoryPath: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        specDir: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        worktreePath: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        currentNode: {
+            (): import("@langchain/langgraph").LastValue<string>;
+            (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        error: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        approvalGates: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").ApprovalGates | undefined, import("../../../../domain/index.js").ApprovalGates | undefined>;
+        messages: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+        validationRetries: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+        lastValidationTarget: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        lastValidationErrors: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+        _approvalAction: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        _rejectionFeedback: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        _needsReexecution: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        prUrl: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        prNumber: import("@langchain/langgraph").BinaryOperatorAggregate<number | null, number | null>;
+        commitHash: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        ciStatus: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+        push: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        openPr: import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        ciFixAttempts: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+        ciFixHistory: import("@langchain/langgraph").BinaryOperatorAggregate<import("../../../../domain/index.js").CiFixRecord[], import("../../../../domain/index.js").CiFixRecord[]>;
+        ciFixStatus: import("@langchain/langgraph").BinaryOperatorAggregate<"success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted", "success" | "timeout" | "idle" | "watching" | "fixing" | "exhausted">;
+    }>>;
+}, unknown, unknown>;
+//# sourceMappingURL=fast-feature-agent-graph.d.ts.map

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/fast-feature-agent-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast-feature-agent-graph.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/fast-feature-agent-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+DAA+D,CAAC;AAGpG,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGlF,OAAO,EAAE,sBAAsB,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,cAAc,CAAC;IACzB,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;CACjD;AAkBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CACzC,cAAc,EAAE,yBAAyB,GAAG,cAAc,EAC1D,YAAY,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA6BnC"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/fast-feature-agent-graph.js

@@ -0,0 +1,66 @@
+/**
+ * Fast Feature Agent Graph Factory
+ *
+ * Creates a LangGraph StateGraph with only 2 nodes: fast-implement → merge.
+ * This is the fast-mode alternative to createFeatureAgentGraph() which has
+ * 15+ nodes. The merge node and its CI watch/fix loop are reused via
+ * composition from the full graph's createMergeNode().
+ *
+ * Uses the same FeatureAgentAnnotation state shape as the full graph,
+ * enabling checkpointing, resume, and identical worker lifecycle handling.
+ */
+import { StateGraph, START, END } from '@langchain/langgraph';
+import { FeatureAgentAnnotation } from './state.js';
+import { createFastImplementNode } from './nodes/fast-implement.node.js';
+import { createMergeNode } from './nodes/merge/merge.node.js';
+// Re-export for consumers
+export { FeatureAgentAnnotation } from './state.js';
+/**
+ * Conditional edge: route back to fast-implement on merge rejection,
+ * otherwise proceed to END.
+ *
+ * Mirrors the routeReexecution() pattern from feature-agent-graph.ts.
+ */
+function routeReexecution(selfNode, nextNode) {
+    return (state) => {
+        if (state._needsReexecution)
+            return selfNode;
+        return nextNode;
+    };
+}
+/**
+ * Factory function that creates and compiles the fast-mode feature agent graph.
+ *
+ * The graph defines a minimal workflow:
+ *   START → fast-implement → merge → conditional(reexecute or END)
+ *
+ * When merge is rejected, routeReexecution routes back to fast-implement
+ * for a fresh implementation pass.
+ *
+ * @param depsOrExecutor - Graph dependencies or a legacy executor
+ * @param checkpointer - Optional checkpoint saver for state persistence
+ * @returns A compiled LangGraph ready to be invoked
+ */
+export function createFastFeatureAgentGraph(depsOrExecutor, checkpointer) {
+    // Support legacy signature: createFastFeatureAgentGraph(executor, checkpointer)
+    const deps = 'execute' in depsOrExecutor ? { executor: depsOrExecutor } : depsOrExecutor;
+    const { executor } = deps;
+    const graph = new StateGraph(FeatureAgentAnnotation).addNode('fast-implement', createFastImplementNode(executor));
+    // Wire merge node when deps are provided
+    if (deps.mergeNodeDeps) {
+        const mergeNodeDeps = {
+            executor,
+            ...deps.mergeNodeDeps,
+        };
+        graph
+            .addNode('merge', createMergeNode(mergeNodeDeps))
+            .addEdge(START, 'fast-implement')
+            .addEdge('fast-implement', 'merge')
+            .addConditionalEdges('merge', routeReexecution('fast-implement', END));
+    }
+    else {
+        // Without merge deps, fast-implement goes directly to END
+        graph.addEdge(START, 'fast-implement').addEdge('fast-implement', END);
+    }
+    return graph.compile({ checkpointer });
+}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-process.service.d.ts

@@ -20,6 +20,7 @@ export declare class FeatureAgentProcessService implements IFeatureAgentProcessS
         openPr?: boolean;
         resumePayload?: string;
         agentType?: AgentType;
+        fast?: boolean;
     }): number;
     isAlive(pid: number): boolean;
     checkAndMarkCrashed(runId: string): Promise<void>;

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-process.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-agent-process.service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-process.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sEAAsE,CAAC;AACxH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qEAAqE,CAAC;AAC/G,OAAO,EAAkB,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAYlG,qBAAa,0BAA2B,YAAW,2BAA2B;IAChE,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,mBAAmB;IAE/D,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,SAAS,CAAC;KACvB,GACA,MAAM;IA6DT,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IASvB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAexD"}
+{"version":3,"file":"feature-agent-process.service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-process.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sEAAsE,CAAC;AACxH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qEAAqE,CAAC;AAC/G,OAAO,EAAkB,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAYlG,qBAAa,0BAA2B,YAAW,2BAA2B;IAChE,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,mBAAmB;IAE/D,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,GACA,MAAM;IAgET,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IASvB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAexD"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-process.service.js

@@ -65,6 +65,9 @@ export class FeatureAgentProcessService {
         if (options?.agentType) {
             args.push('--agent-type', options.agentType);
         }
+        if (options?.fast) {
+            args.push('--fast');
+        }
         // Create log file for worker output (for debugging)
         const logsDir = join(homedir(), '.shep', 'logs');
         mkdirSync(logsDir, { recursive: true });

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-worker.d.ts

@@ -25,6 +25,7 @@ export interface WorkerArgs {
     openPr?: boolean;
     resumePayload?: string;
     agentType?: AgentType;
+    fast?: boolean;
 }
 /**
  * Parse CLI arguments into a WorkerArgs object.

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-agent-worker.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-worker.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,kBAAkB,CAAC;AAa1B,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAS9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA2D1D;AAgCD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiN/D"}
+{"version":3,"file":"feature-agent-worker.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-worker.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,kBAAkB,CAAC;AAe1B,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAS9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA6D1D;AAgCD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0N/D"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/feature-agent-worker.js

@@ -14,6 +14,7 @@ import { homedir } from 'node:os';
 import { Command } from '@langchain/langgraph';
 import { initializeContainer, container } from '../../../di/container.js';
 import { createFeatureAgentGraph } from './feature-agent-graph.js';
+import { createFastFeatureAgentGraph } from './fast-feature-agent-graph.js';
 import { createCheckpointer } from '../common/checkpointer.js';
 import { AgentRunStatus } from '../../../../domain/generated/output.js';
 import { initializeSettings } from '../../../services/settings.service.js';
@@ -51,6 +52,7 @@ export function parseWorkerArgs(args) {
     const resumeFromInterrupt = args.includes('--resume-from-interrupt');
     const push = args.includes('--push');
     const openPr = args.includes('--open-pr');
+    const fast = args.includes('--fast');
     const threadIdx = args.indexOf('--thread-id');
     const threadId = threadIdx !== -1 && threadIdx + 1 < args.length ? args[threadIdx + 1] : undefined;
     const agentTypeIdx = args.indexOf('--agent-type');
@@ -75,6 +77,7 @@ export function parseWorkerArgs(args) {
         openPr,
         resumePayload,
         agentType,
+        fast,
     };
 }
 /** Simple worker logger — writes to stdout which is redirected to log file by the parent. */
@@ -115,6 +118,7 @@ export async function runWorker(args) {
     log(`  worktreePath=${args.worktreePath ?? '(none)'}`);
     log(`  approvalGates=${args.approvalGates ? JSON.stringify(args.approvalGates) : '(none)'}`);
     log(`  resume=${args.resume}`);
+    log(`  fast=${args.fast ?? false}`);
     log('Initializing container...');
     await initializeContainer();
     // Initialize settings in the worker process
@@ -155,7 +159,12 @@ export async function runWorker(args) {
     const checkpointPath = join(homedir(), '.shep', 'checkpoints', `${checkpointId}.db`);
     log(`Creating checkpointer at ${checkpointPath} (thread: ${checkpointId})`);
     const checkpointer = createCheckpointer(checkpointPath);
-    const graph = createFeatureAgentGraph(graphDeps, checkpointer);
+    // Both graph factories return compiled graphs with identical FeatureAgentAnnotation
+    // state shape and invoke() interface. Cast through unknown because the compiled
+    // graphs have different node name types but share the same runtime contract.
+    const graph = args.fast
+        ? createFastFeatureAgentGraph(graphDeps, checkpointer)
+        : createFeatureAgentGraph(graphDeps, checkpointer);
     // Mark the run as running with our PID
     const now = new Date();
     log(`Updating status to running (PID ${process.pid})...`);

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/lifecycle-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-context.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/lifecycle-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D;;;;GAIG;AACH,UAAU,gBAAgB;IACxB,OAAO,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,aAAa,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChF;AAeD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAGtF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWzE"}
+{"version":3,"file":"lifecycle-context.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/lifecycle-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D;;;;GAIG;AACH,UAAU,gBAAgB;IACxB,OAAO,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,aAAa,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChF;AAgBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAGtF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWzE"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/lifecycle-context.js

@@ -24,6 +24,7 @@ const NODE_TO_LIFECYCLE = {
     research: SdlcLifecycle.Research,
     plan: SdlcLifecycle.Planning,
     implement: SdlcLifecycle.Implementation,
+    'fast-implement': SdlcLifecycle.Implementation,
     merge: SdlcLifecycle.Review,
 };
 /**

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/fast-implement.node.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Fast-Implement Node
+ *
+ * Single-pass implementation node for fast mode. Builds a prompt from
+ * the user's query plus lightweight codebase context, calls the executor
+ * once, and returns. Does NOT handle commit/push/PR — that's the merge
+ * node's job.
+ *
+ * Follows the same factory pattern as other nodes: takes executor
+ * dependency, returns async (state) => Partial<FeatureAgentState>.
+ */
+import type { IAgentExecutor } from '../../../../../application/ports/output/agents/agent-executor.interface.js';
+import type { FeatureAgentState } from '../state.js';
+/**
+ * Factory that creates the fast-implement node function.
+ *
+ * @param executor - The agent executor to use for implementation
+ * @returns A LangGraph node function
+ */
+export declare function createFastImplementNode(executor: IAgentExecutor): (state: FeatureAgentState) => Promise<Partial<FeatureAgentState>>;
+//# sourceMappingURL=fast-implement.node.d.ts.map

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/fast-implement.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast-implement.node.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/fast-implement.node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+DAA+D,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOrD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,IAGhD,OAAO,iBAAiB,KAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAwC7E"}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/fast-implement.node.js

@@ -0,0 +1,60 @@
+/**
+ * Fast-Implement Node
+ *
+ * Single-pass implementation node for fast mode. Builds a prompt from
+ * the user's query plus lightweight codebase context, calls the executor
+ * once, and returns. Does NOT handle commit/push/PR — that's the merge
+ * node's job.
+ *
+ * Follows the same factory pattern as other nodes: takes executor
+ * dependency, returns async (state) => Partial<FeatureAgentState>.
+ */
+import { isGraphBubbleUp } from '@langchain/langgraph';
+import { createNodeLogger, buildExecutorOptions, retryExecute } from './node-helpers.js';
+import { reportNodeStart } from '../heartbeat.js';
+import { recordPhaseStart, recordPhaseEnd } from '../phase-timing-context.js';
+import { updateNodeLifecycle } from '../lifecycle-context.js';
+import { buildFastImplementPrompt } from './prompts/fast-implement.prompt.js';
+/**
+ * Factory that creates the fast-implement node function.
+ *
+ * @param executor - The agent executor to use for implementation
+ * @returns A LangGraph node function
+ */
+export function createFastImplementNode(executor) {
+    const log = createNodeLogger('fast-implement');
+    return async (state) => {
+        log.info('Starting fast implementation');
+        reportNodeStart('fast-implement');
+        await updateNodeLifecycle('fast-implement');
+        const startTime = Date.now();
+        const timingId = await recordPhaseStart('fast-implement');
+        try {
+            const prompt = buildFastImplementPrompt(state);
+            const options = buildExecutorOptions(state);
+            log.info(`Executing agent at cwd=${options.cwd}`);
+            log.info(`Prompt length: ${prompt.length} chars`);
+            const result = await retryExecute(executor, prompt, options, { logger: log });
+            const durationMs = Date.now() - startTime;
+            const elapsed = (durationMs / 1000).toFixed(1);
+            log.info(`Complete (${result.result.length} chars, ${elapsed}s)`);
+            await recordPhaseEnd(timingId, durationMs);
+            return {
+                currentNode: 'fast-implement',
+                messages: [`[fast-implement] Complete (${result.result.length} chars, ${elapsed}s)`],
+                _needsReexecution: false,
+            };
+        }
+        catch (err) {
+            if (isGraphBubbleUp(err))
+                throw err;
+            const message = err instanceof Error ? err.message : String(err);
+            const durationMs = Date.now() - startTime;
+            const elapsed = (durationMs / 1000).toFixed(1);
+            log.error(`${message} (after ${elapsed}s)`);
+            await recordPhaseEnd(timingId, durationMs);
+            // Throw so LangGraph does NOT checkpoint this node as "completed".
+            throw new Error(`[fast-implement] ${message}`);
+        }
+    };
+}

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/fast-implement.prompt.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Fast-Implement Prompt Builder
+ *
+ * Builds a single-pass implementation prompt for fast mode.
+ * Combines the user's raw query with lightweight codebase context
+ * (CLAUDE.md, package.json, shallow directory listing).
+ *
+ * The prompt instructs the executor to implement changes and run tests,
+ * but NOT to commit, push, or create PRs (that's the merge node's job).
+ */
+import type { FeatureAgentState } from '../../state.js';
+/**
+ * Build the fast-implement prompt from user query + codebase context.
+ *
+ * The prompt includes:
+ * 1. User's raw query (from spec.yaml userQuery field)
+ * 2. CLAUDE.md content (if exists)
+ * 3. package.json (if exists)
+ * 4. Shallow directory listing (depth 1-2)
+ *
+ * Instructs the executor to implement, test, and validate — but NOT
+ * commit/push/PR (that's the merge node's job).
+ */
+export declare function buildFastImplementPrompt(state: FeatureAgentState): string;
+//# sourceMappingURL=fast-implement.prompt.d.ts.map

package/dist/packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/fast-implement.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast-implement.prompt.d.ts","sourceRoot":"","sources":["../../../../../../../../../../packages/core/src/infrastructure/services/agents/feature-agent/nodes/prompts/fast-implement.prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AA+FxD;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAiEzE"}