@shepai/cli 1.33.0 → 1.34.0

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

@@ -30,8 +30,6 @@ export interface IFeatureAgentProcessService {
         resumeFromInterrupt?: boolean;
         push?: boolean;
         openPr?: boolean;
-        autoMerge?: boolean;
-        allowMerge?: 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,MAAM,wCAAwC,CAAC;AAE5E;;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,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,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,MAAM,wCAAwC,CAAC;AAE5E;;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;KAClB,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/agents/index.d.ts

@@ -12,4 +12,6 @@ export type { IAgentRunRepository } from './agent-run-repository.interface.js';
 export type { IPhaseTimingRepository } from './phase-timing-repository.interface.js';
 export type { IAgentValidator, AgentValidationResult } from './agent-validator.interface.js';
 export type { IFeatureAgentProcessService } from './feature-agent-process.interface.js';
+export type { IStructuredAgentCaller, StructuredCallOptions, } from './structured-agent-caller.interface.js';
+export { StructuredCallError } from './structured-call-error.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AACnF,YAAY,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChG,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACjF,YAAY,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,YAAY,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC7F,YAAY,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AACnF,YAAY,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChG,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACjF,YAAY,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,YAAY,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC7F,YAAY,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACxF,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/packages/core/src/application/ports/output/agents/index.js

@@ -3,4 +3,4 @@
  *
  * Interfaces for agent execution, orchestration, and persistence.
  */
-export {};
+export { StructuredCallError } from './structured-call-error.js';

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

@@ -0,0 +1,55 @@
+/**
+ * Structured Agent Caller Interface
+ *
+ * Output port for making typed, schema-validated calls to AI agents.
+ * Abstracts away differences between agents that natively support
+ * structured output (e.g., Claude Code --json-schema) and those
+ * that require prompt-based JSON extraction.
+ *
+ * @example
+ * ```typescript
+ * interface FeatureMeta { slug: string; name: string; description: string }
+ *
+ * const caller = container.resolve<IStructuredAgentCaller>('IStructuredAgentCaller');
+ * const meta = await caller.call<FeatureMeta>(
+ *   'Analyze this request and extract feature metadata: "Add OAuth login"',
+ *   {
+ *     type: 'object',
+ *     properties: {
+ *       slug: { type: 'string' },
+ *       name: { type: 'string' },
+ *       description: { type: 'string' },
+ *     },
+ *     required: ['slug', 'name', 'description'],
+ *     additionalProperties: false,
+ *   },
+ *   { maxTurns: 10, silent: true }
+ * );
+ * ```
+ */
+import type { AgentExecutionOptions } from './agent-executor.interface.js';
+/**
+ * Options for structured agent calls.
+ * Same as AgentExecutionOptions but without outputSchema (provided separately as the schema argument).
+ */
+export type StructuredCallOptions = Omit<AgentExecutionOptions, 'outputSchema'>;
+/**
+ * Port interface for making typed calls to AI agents with JSON schema output.
+ *
+ * Implementations handle the difference between agents with native structured
+ * output support and those requiring prompt-based JSON extraction.
+ */
+export interface IStructuredAgentCaller {
+    /**
+     * Execute a prompt and return a typed result matching the given JSON schema.
+     *
+     * @typeParam T - The expected return type matching the schema
+     * @param prompt - The prompt to send to the agent
+     * @param schema - JSON Schema object describing the expected output shape
+     * @param options - Optional execution configuration (cwd, maxTurns, silent, etc.)
+     * @returns Parsed and typed result from the agent
+     * @throws {StructuredCallError} When the agent response cannot be parsed as valid JSON
+     */
+    call<T>(prompt: string, schema: object, options?: StructuredCallOptions): Promise<T>;
+}
+//# sourceMappingURL=structured-agent-caller.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structured-agent-caller.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/structured-agent-caller.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,qBAAqB,EAAE,cAAc,CAAC,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;OASG;IACH,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACtF"}

package/dist/packages/core/src/application/ports/output/agents/structured-agent-caller.interface.js

@@ -0,0 +1,30 @@
+/**
+ * Structured Agent Caller Interface
+ *
+ * Output port for making typed, schema-validated calls to AI agents.
+ * Abstracts away differences between agents that natively support
+ * structured output (e.g., Claude Code --json-schema) and those
+ * that require prompt-based JSON extraction.
+ *
+ * @example
+ * ```typescript
+ * interface FeatureMeta { slug: string; name: string; description: string }
+ *
+ * const caller = container.resolve<IStructuredAgentCaller>('IStructuredAgentCaller');
+ * const meta = await caller.call<FeatureMeta>(
+ *   'Analyze this request and extract feature metadata: "Add OAuth login"',
+ *   {
+ *     type: 'object',
+ *     properties: {
+ *       slug: { type: 'string' },
+ *       name: { type: 'string' },
+ *       description: { type: 'string' },
+ *     },
+ *     required: ['slug', 'name', 'description'],
+ *     additionalProperties: false,
+ *   },
+ *   { maxTurns: 10, silent: true }
+ * );
+ * ```
+ */
+export {};

package/dist/packages/core/src/application/ports/output/agents/structured-call-error.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Error thrown when a structured agent call fails to produce valid output.
+ */
+export declare class StructuredCallError extends Error {
+    readonly code: 'parse_failed' | 'agent_error';
+    readonly cause?: unknown | undefined;
+    constructor(message: string, code: 'parse_failed' | 'agent_error', cause?: unknown | undefined);
+}
+//# sourceMappingURL=structured-call-error.d.ts.map

package/dist/packages/core/src/application/ports/output/agents/structured-call-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-call-error.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/structured-call-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,IAAI,EAAE,cAAc,GAAG,aAAa;aACpC,KAAK,CAAC,EAAE,OAAO;gBAF/B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,cAAc,GAAG,aAAa,EACpC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC"}

package/dist/packages/core/src/application/ports/output/agents/structured-call-error.js

@@ -0,0 +1,13 @@
+/**
+ * Error thrown when a structured agent call fails to produce valid output.
+ */
+export class StructuredCallError extends Error {
+    code;
+    cause;
+    constructor(message, code, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'StructuredCallError';
+    }
+}

package/dist/packages/core/src/application/use-cases/agents/approve-agent-run.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approve-agent-run.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/agents/approve-agent-run.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAGlG,qBACa,sBAAsB;IAG/B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAEnC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,eAAe;gBANf,kBAAkB,EAAE,mBAAmB,EAEvC,cAAc,EAAE,2BAA2B,EAE3C,iBAAiB,EAAE,kBAAkB,EAErC,eAAe,EAAE,gBAAgB;IAG9C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CA0C1E"}
+{"version":3,"file":"approve-agent-run.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/agents/approve-agent-run.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAChH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAGlG,qBACa,sBAAsB;IAG/B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAEnC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,eAAe;gBANf,kBAAkB,EAAE,mBAAmB,EAEvC,cAAc,EAAE,2BAA2B,EAE3C,iBAAiB,EAAE,kBAAkB,EAErC,eAAe,EAAE,gBAAgB;IAG9C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CA4C1E"}

package/dist/packages/core/src/application/use-cases/agents/approve-agent-run.use-case.js

@@ -56,6 +56,8 @@ let ApproveAgentRunUseCase = class ApproveAgentRunUseCase {
             approvalGates: run.approvalGates,
             threadId: run.threadId,
             resumeFromInterrupt: true,
+            push: feature?.push ?? false,
+            openPr: feature?.openPr ?? false,
         });
         return { approved: true, reason: 'Approved and resumed' };
     }

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;AAE5G,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;gBAZZ,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;IAGvC,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA8EvE"}
+{"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;AAE5G,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;gBAZZ,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;IAGvC,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAmFvE"}

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

@@ -72,16 +72,19 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
             name: metadata.name,
             slug,
             description: metadata.description,
+            userQuery: input.userInput,
             repositoryPath: input.repositoryPath,
             branch,
             lifecycle: SdlcLifecycle.Requirements,
             messages: [],
             relatedArtifacts: [],
+            push: input.push ?? false,
             openPr: input.openPr ?? false,
-            autoMerge: input.autoMerge ?? false,
-            allowPrd: false,
-            allowPlan: false,
-            allowMerge: false,
+            approvalGates: input.approvalGates ?? {
+                allowPrd: false,
+                allowPlan: false,
+                allowMerge: false,
+            },
             agentRunId: runId,
             specPath: specDir,
             createdAt: now,
@@ -107,6 +110,8 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
         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,
         });
         return { feature, warning };
     }

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

@@ -2,28 +2,28 @@
  * MetadataGenerator
  *
  * Generates feature metadata (slug, name, description) from user input
- * via AI call through IAgentExecutorProvider.
+ * via AI call through IStructuredAgentCaller.
  * Errors are propagated to the caller.
  */
-import type { IAgentExecutorProvider } from '../../../ports/output/agents/agent-executor-provider.interface.js';
-import type { FeatureMetadata } from './types.js';
+import type { IStructuredAgentCaller } from '../../../ports/output/agents/structured-agent-caller.interface.js';
+interface FeatureMetadata {
+    slug: string;
+    name: string;
+    description: string;
+}
 export declare class MetadataGenerator {
-    private readonly executorProvider;
-    constructor(executorProvider: IAgentExecutorProvider);
+    private readonly structuredCaller;
+    constructor(structuredCaller: IStructuredAgentCaller);
     /**
      * Generate feature metadata from user input via AI.
      * Errors are propagated to the caller.
      */
     generateMetadata(userInput: string): Promise<FeatureMetadata>;
-    /**
-     * Extract JSON from an AI response that may include markdown fences or surrounding prose.
-     * Finds the first `{` and its matching closing `}`, ignoring text outside.
-     */
-    private extractJson;
     /**
      * Convert text to kebab-case slug with 50-char limit.
      * Removes special characters, collapses spaces, limits length.
      */
     private toSlug;
 }
+export {};
 //# sourceMappingURL=metadata-generator.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"metadata-generator.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/metadata-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mEAAmE,CAAC;AAChH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKlD,qBACa,iBAAiB;IAG1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,sBAAsB;IAG3D;;;OAGG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA4CnE;;;OAGG;IACH,OAAO,CAAC,WAAW;IAqCnB;;;OAGG;IACH,OAAO,CAAC,MAAM;CAgBf"}
+{"version":3,"file":"metadata-generator.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/metadata-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mEAAmE,CAAC;AAEhH,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAgBD,qBACa,iBAAiB;IAG1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,sBAAsB;IAG3D;;;OAGG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAmCnE;;;OAGG;IACH,OAAO,CAAC,MAAM;CAgBf"}

package/dist/packages/core/src/application/use-cases/features/create/metadata-generator.js

@@ -2,7 +2,7 @@
  * MetadataGenerator
  *
  * Generates feature metadata (slug, name, description) from user input
- * via AI call through IAgentExecutorProvider.
+ * via AI call through IStructuredAgentCaller.
  * Errors are propagated to the caller.
  */
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
@@ -20,17 +20,26 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 import { injectable, inject } from 'tsyringe';
 /** Maximum characters of user input sent to the AI for metadata generation. */
 const MAX_INPUT_FOR_AI = 500;
+const METADATA_SCHEMA = {
+    type: 'object',
+    properties: {
+        slug: { type: 'string', description: 'kebab-case identifier, 2-4 words' },
+        name: { type: 'string', description: 'polished, professional title' },
+        description: { type: 'string', description: 'refined 1-2 sentence description' },
+    },
+    required: ['slug', 'name', 'description'],
+    additionalProperties: false,
+};
 let MetadataGenerator = class MetadataGenerator {
-    executorProvider;
-    constructor(executorProvider) {
-        this.executorProvider = executorProvider;
+    structuredCaller;
+    constructor(structuredCaller) {
+        this.structuredCaller = structuredCaller;
     }
     /**
      * Generate feature metadata from user input via AI.
      * Errors are propagated to the caller.
      */
     async generateMetadata(userInput) {
-        const executor = this.executorProvider.getExecutor();
         const truncated = userInput.length > MAX_INPUT_FOR_AI
             ? `${userInput.slice(0, MAX_INPUT_FOR_AI)}...`
             : userInput;
@@ -41,22 +50,15 @@ User request:
 
 IMPORTANT: Don't use the request as-is. Extract the key feature being requested and improve the wording.
 
-Return ONLY a JSON object with these fields:
+Return a JSON object with these fields:
 - slug: kebab-case identifier, 2-4 words MAX. Extract the core feature name (e.g., "github-oauth-login" from "add github oauth")
 - name: polished, professional title (improve upon user's wording)
-- description: refined 1-2 sentence description that captures the feature essence (not the request verbatim)
-
-JSON only, no markdown fences.`;
-        const result = await executor.execute(prompt, {
-            maxTurns: 1,
+- description: refined 1-2 sentence description that captures the feature essence (not the request verbatim)`;
+        const parsed = await this.structuredCaller.call(prompt, METADATA_SCHEMA, {
+            maxTurns: 10,
             allowedTools: [],
             silent: true,
         });
-        const cleaned = this.extractJson(result.result);
-        if (!cleaned) {
-            throw new Error('AI returned empty response for metadata generation');
-        }
-        const parsed = JSON.parse(cleaned);
         if (!parsed.slug || !parsed.name || !parsed.description) {
             throw new Error('Missing required fields in AI response');
         }
@@ -66,45 +68,6 @@ JSON only, no markdown fences.`;
             description: parsed.description,
         };
     }
-    /**
-     * Extract JSON from an AI response that may include markdown fences or surrounding prose.
-     * Finds the first `{` and its matching closing `}`, ignoring text outside.
-     */
-    extractJson(text) {
-        const start = text.indexOf('{');
-        if (start === -1)
-            return text.trim();
-        let depth = 0;
-        let inString = false;
-        let escape = false;
-        for (let i = start; i < text.length; i++) {
-            const ch = text[i];
-            if (escape) {
-                escape = false;
-                continue;
-            }
-            if (ch === '\\' && inString) {
-                escape = true;
-                continue;
-            }
-            if (ch === '"') {
-                inString = !inString;
-                continue;
-            }
-            if (inString)
-                continue;
-            if (ch === '{')
-                depth++;
-            else if (ch === '}') {
-                depth--;
-                if (depth === 0) {
-                    return text.slice(start, i + 1);
-                }
-            }
-        }
-        // Fallback: return from first brace to end, trimmed
-        return text.slice(start).trim();
-    }
     /**
      * Convert text to kebab-case slug with 50-char limit.
      * Removes special characters, collapses spaces, limits length.
@@ -127,7 +90,7 @@ JSON only, no markdown fences.`;
 };
 MetadataGenerator = __decorate([
     injectable(),
-    __param(0, inject('IAgentExecutorProvider')),
+    __param(0, inject('IStructuredAgentCaller')),
     __metadata("design:paramtypes", [Object])
 ], MetadataGenerator);
 export { MetadataGenerator };

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

@@ -3,16 +3,11 @@ export interface CreateFeatureInput {
     userInput: string;
     repositoryPath: string;
     approvalGates?: ApprovalGates;
+    push?: boolean;
     openPr?: boolean;
-    autoMerge?: boolean;
 }
 export interface CreateFeatureResult {
     feature: Feature;
     warning?: string;
 }
-export interface FeatureMetadata {
-    slug: string;
-    name: string;
-    description: string;
-}
 //# sourceMappingURL=types.d.ts.map

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,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB"}
+{"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"}

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,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAgF/D"}
+{"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;CA+E/D"}

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

@@ -90,9 +90,8 @@ let ResumeFeatureUseCase = class ResumeFeatureUseCase {
             approvalGates: lastRun.approvalGates,
             threadId: lastRun.threadId,
             resumeFromInterrupt: lastRun.status === AgentRunStatus.waitingApproval,
+            push: feature.push,
             openPr: feature.openPr,
-            autoMerge: feature.autoMerge,
-            allowMerge: feature.allowMerge,
         });
         return { feature, newRun };
     }

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

@@ -570,6 +570,23 @@ export declare enum SdlcLifecycle {
     Review = "Review",
     Maintain = "Maintain"
 }
+/**
+ * Configuration for human-in-the-loop approval gates
+ */
+export type ApprovalGates = {
+    /**
+     * Skip human review after requirements phase
+     */
+    allowPrd: boolean;
+    /**
+     * Skip human review after plan phase
+     */
+    allowPlan: boolean;
+    /**
+     * Skip human review after merge phase
+     */
+    allowMerge: boolean;
+};
 export declare enum PrStatus {
     Open = "Open",
     Merged = "Merged",
@@ -580,6 +597,31 @@ export declare enum CiStatus {
     Success = "Success",
     Failure = "Failure"
 }
+/**
+ * Pull request tracking data for a feature
+ */
+export type PullRequest = {
+    /**
+     * GitHub PR URL
+     */
+    url: string;
+    /**
+     * GitHub PR number
+     */
+    number: number;
+    /**
+     * Current PR status
+     */
+    status: PrStatus;
+    /**
+     * Final commit SHA after push
+     */
+    commitHash?: string;
+    /**
+     * CI pipeline status
+     */
+    ciStatus?: CiStatus;
+};
 /**
  * Central entity tracking a piece of work through the SDLC lifecycle (Aggregate Root)
  */
@@ -588,6 +630,10 @@ export type Feature = BaseEntity & {
      * Human-readable name identifying this feature
      */
     name: string;
+    /**
+     * The exact user input that initiated this feature, preserved verbatim
+     */
+    userQuery: string;
     /**
      * URL-friendly identifier derived from name (unique within repository)
      */
@@ -629,45 +675,25 @@ export type Feature = BaseEntity & {
      */
     specPath?: string;
     /**
-     * Create PR after implementation (default: false)
-     */
-    openPr: boolean;
-    /**
-     * Auto-merge after implementation (default: false)
-     */
-    autoMerge: boolean;
-    /**
-     * Skip Requirements approval gate (default: false)
-     */
-    allowPrd: boolean;
-    /**
-     * Skip Planning approval gate (default: false)
+     * Push branch to remote after implementation (default: false)
      */
-    allowPlan: boolean;
+    push: boolean;
     /**
-     * Skip Review/merge approval gate (default: false)
-     */
-    allowMerge: boolean;
-    /**
-     * GitHub PR URL (null if no PR created)
-     */
-    prUrl?: string;
-    /**
-     * GitHub PR number (null if no PR created)
+     * Create PR after implementation (default: false)
      */
-    prNumber?: number;
+    openPr: boolean;
     /**
-     * Current PR status (null if no PR created)
+     * Approval gates configuration (embedded value object)
      */
-    prStatus?: PrStatus;
+    approvalGates: ApprovalGates;
     /**
-     * Final commit SHA after push (null before push)
+     * Absolute path to the git worktree for this feature
      */
-    commitHash?: string;
+    worktreePath?: string;
     /**
-     * CI pipeline status (null before CI check)
+     * Pull request data (null until PR created)
      */
-    ciStatus?: CiStatus;
+    pr?: PullRequest;
 };
 /**
  * Open question that may need resolution before implementation
@@ -1234,23 +1260,6 @@ export declare enum AgentRunStatus {
     cancelled = "cancelled",
     waitingApproval = "waiting_approval"
 }
-/**
- * Configuration for human-in-the-loop approval gates
- */
-export type ApprovalGates = {
-    /**
-     * Skip human review after requirements phase
-     */
-    allowPrd: boolean;
-    /**
-     * Skip human review after plan phase
-     */
-    allowPlan: boolean;
-    /**
-     * Skip human review after merge phase
-     */
-    allowMerge: boolean;
-};
 /**
  * Agent execution run record
  */