@shepai/cli 1.136.0 → 1.136.1

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;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"}
+{"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;CAiI1D"}

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

@@ -197,7 +197,7 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
         const effectiveRepoPath = feature.repositoryPath;
         // Ensure the target directory is a git repository (auto-init if needed)
         await this.worktreeService.ensureGitRepository(effectiveRepoPath);
-        const metadata = await this.metadataGenerator.generateMetadata(input.userInput, input.agentType);
+        const metadata = await this.metadataGenerator.generateMetadata(input.userInput, input.agentType, effectiveRepoPath);
         const originalSlug = metadata.slug;
         const { slug, branch, warning } = await this.slugResolver.resolveUniqueSlug(originalSlug, effectiveRepoPath);
         // Determine next feature number for this repo

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

@@ -3,6 +3,9 @@
  *
  * Generates feature metadata (slug, name, description) from user input
  * via AI call through IStructuredAgentCaller.
+ * When the user input references a file (e.g. SPEC.md), the file content
+ * is read and included in the prompt so the AI derives metadata from the
+ * actual file rather than the bare reference string.
  * Errors are propagated to the caller.
  */
 import type { AgentType } from '../../../../domain/generated/output.js';
@@ -17,9 +20,17 @@ export declare class MetadataGenerator {
     constructor(structuredCaller: IStructuredAgentCaller);
     /**
      * Generate feature metadata from user input via AI.
+     * When repositoryPath is provided, file references in the user input
+     * (e.g. "Develop based on the current SPEC.md") are resolved and their
+     * content is included in the prompt.
      * Errors are propagated to the caller.
      */
-    generateMetadata(userInput: string, agentType?: AgentType): Promise<FeatureMetadata>;
+    generateMetadata(userInput: string, agentType?: AgentType, repositoryPath?: string): Promise<FeatureMetadata>;
+    /**
+     * Detect a file reference in user input and read the file content.
+     * Returns the file content if found and readable, undefined otherwise.
+     */
+    resolveFileReference(userInput: string, repositoryPath: string): string | undefined;
     /**
      * Extract metadata locally from user input without AI.
      * Used as fallback when the AI call fails or returns invalid data.

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,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACxE,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,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC;IAwC1F;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;;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;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACxE,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;AA2BD,qBACa,iBAAiB;IAG1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,sBAAsB;IAG3D;;;;;;OAMG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,SAAS,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,eAAe,CAAC;IAoD3B;;;OAGG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IA8BnF;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;;OAGG;IACH,OAAO,CAAC,MAAM;CAgBf"}

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

@@ -3,6 +3,9 @@
  *
  * Generates feature metadata (slug, name, description) from user input
  * via AI call through IStructuredAgentCaller.
+ * When the user input references a file (e.g. SPEC.md), the file content
+ * is read and included in the prompt so the AI derives metadata from the
+ * actual file rather than the bare reference string.
  * Errors are propagated to the caller.
  */
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
@@ -18,8 +21,18 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { injectable, inject } from 'tsyringe';
+import { readFileSync, existsSync } from 'node:fs';
+import { join, isAbsolute } from 'node:path';
 /** Maximum characters of user input sent to the AI for metadata generation. */
 const MAX_INPUT_FOR_AI = 500;
+/** Maximum characters of file content included in the AI prompt. */
+const MAX_FILE_CONTENT_FOR_AI = 4000;
+/**
+ * Pattern that matches user input referencing a file for feature definition.
+ * Captures the filename in group 1. Case-insensitive.
+ * Examples: "Develop based on the current SPEC.md", "based on SPEC.md", "use ./docs/SPEC.md"
+ */
+const FILE_REFERENCE_PATTERN = /(?:based\s+on|from|use|using|see|refer\s+to|according\s+to)[\s]+(?:the\s+)?(?:current\s+)?(\S+\.(?:md|txt|yaml|yml))/i;
 const METADATA_SCHEMA = {
     type: 'object',
     properties: {
@@ -37,18 +50,30 @@ let MetadataGenerator = class MetadataGenerator {
     }
     /**
      * Generate feature metadata from user input via AI.
+     * When repositoryPath is provided, file references in the user input
+     * (e.g. "Develop based on the current SPEC.md") are resolved and their
+     * content is included in the prompt.
      * Errors are propagated to the caller.
      */
-    async generateMetadata(userInput, agentType) {
-        const truncated = userInput.length > MAX_INPUT_FOR_AI
-            ? `${userInput.slice(0, MAX_INPUT_FOR_AI)}...`
+    async generateMetadata(userInput, agentType, repositoryPath) {
+        const fileContent = repositoryPath
+            ? this.resolveFileReference(userInput, repositoryPath)
+            : undefined;
+        const effectiveInput = fileContent
+            ? `${userInput}\n\n--- Referenced file content ---\n${fileContent}`
             : userInput;
+        const truncated = effectiveInput.length > MAX_INPUT_FOR_AI + MAX_FILE_CONTENT_FOR_AI
+            ? `${effectiveInput.slice(0, MAX_INPUT_FOR_AI + MAX_FILE_CONTENT_FOR_AI)}...`
+            : effectiveInput;
+        const fileHint = fileContent
+            ? "\nIMPORTANT: The user referenced a file. Derive the feature name, slug, and description from the FILE CONTENT, not from the user's reference instruction."
+            : '';
         const prompt = `Analyze this user request and extract the CORE feature intent. Condense to essential concepts.
 
 User request:
 "${truncated}"
 
-IMPORTANT: Don't use the request as-is. Extract the key feature being requested and improve the wording.
+IMPORTANT: Don't use the request as-is. Extract the key feature being requested and improve the wording.${fileHint}
 
 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")
@@ -74,6 +99,38 @@ Return a JSON object with these fields:
         }
         return this.extractMetadataLocally(userInput);
     }
+    /**
+     * Detect a file reference in user input and read the file content.
+     * Returns the file content if found and readable, undefined otherwise.
+     */
+    resolveFileReference(userInput, repositoryPath) {
+        const match = FILE_REFERENCE_PATTERN.exec(userInput);
+        if (!match)
+            return undefined;
+        const filename = match[1];
+        const candidates = [
+            // Try the path as-is (handles absolute or relative with ./)
+            isAbsolute(filename) ? filename : join(repositoryPath, filename),
+            // Also try common locations
+            join(repositoryPath, filename.replace(/^\.\//, '')),
+        ];
+        for (const candidate of candidates) {
+            try {
+                if (existsSync(candidate)) {
+                    const content = readFileSync(candidate, 'utf-8');
+                    if (content.trim().length > 0) {
+                        return content.length > MAX_FILE_CONTENT_FOR_AI
+                            ? `${content.slice(0, MAX_FILE_CONTENT_FOR_AI)}...`
+                            : content;
+                    }
+                }
+            }
+            catch {
+                // File not readable — try next candidate
+            }
+        }
+        return undefined;
+    }
     /**
      * Extract metadata locally from user input without AI.
      * Used as fallback when the AI call fails or returns invalid data.