@shepai/cli 1.20.0 → 1.21.0

package/dist/eslint.config.mjs

@@ -53,6 +53,7 @@ export default tseslint.config(
         '*.config.js',
         '*.config.mjs',
         '*.config.cjs',
+        '*.config.ts',
     ],
 }, 
 // =============================================================================

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

@@ -6,6 +6,7 @@
 export type { IExternalIssueFetcher, ExternalIssue } from './external-issue-fetcher.interface.js';
 export { IssueFetcherError, IssueNotFoundError, IssueAuthenticationError, IssueServiceUnavailableError, } from './external-issue-fetcher.interface.js';
 export type { ISpecInitializerService, SpecInitializerResult, } from './spec-initializer.interface.js';
+export type { IToolInstallerService } from './tool-installer.service.js';
 export type { IVersionService } from './version-service.interface.js';
 export type { IWebServerService } from './web-server-service.interface.js';
 export type { IWorktreeService, WorktreeInfo } from './worktree-service.interface.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/src/application/ports/output/services/tool-installer.service.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Tool Installer Service Interface
+ *
+ * Output port for tool installation operations.
+ * Implementations check tool availability and execute installations.
+ */
+import type { ToolInstallationStatus, ToolInstallCommand } from '../../../../domain/generated/output.js';
+/**
+ * Service interface for tool installation management.
+ */
+export interface IToolInstallerService {
+    /**
+     * Check if a tool is available on the system (PATH check).
+     *
+     * @param toolName - Name of the tool to check
+     * @returns ToolInstallationStatus with availability information
+     */
+    checkAvailability(toolName: string): Promise<ToolInstallationStatus>;
+    /**
+     * Get the install command metadata for a tool on the current platform.
+     *
+     * @param toolName - Name of the tool to get install command for
+     * @returns ToolInstallCommand with installation details, or null if not available
+     */
+    getInstallCommand(toolName: string): ToolInstallCommand | null;
+    /**
+     * Execute installation of a tool with live output streaming.
+     *
+     * @param toolName - Name of the tool to install
+     * @param onOutput - Optional callback for streaming installation output
+     * @returns ToolInstallationStatus with result of installation
+     */
+    executeInstall(toolName: string, onOutput?: (data: string) => void): Promise<ToolInstallationStatus>;
+}
+//# sourceMappingURL=tool-installer.service.d.ts.map

package/dist/src/application/ports/output/services/tool-installer.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-installer.service.d.ts","sourceRoot":"","sources":["../../../../../../src/application/ports/output/services/tool-installer.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,wCAAwC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAErE;;;;;OAKG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAAC;IAE/D;;;;;;OAMG;IACH,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACpC"}

package/dist/src/application/ports/output/services/tool-installer.service.js

@@ -0,0 +1,7 @@
+/**
+ * Tool Installer Service Interface
+ *
+ * Output port for tool installation operations.
+ * Implementations check tool availability and execute installations.
+ */
+export {};

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

@@ -0,0 +1,37 @@
+/**
+ * Create Feature Use Case
+ *
+ * Creates a new feature entity with a git worktree for isolated development,
+ * initializes the spec directory with YAML templates, then spawns the
+ * feature agent to begin autonomous SDLC processing.
+ *
+ * Business Rules:
+ * - Metadata generation delegated to MetadataGenerator service
+ * - Slug uniqueness delegated to SlugResolver service
+ * - Full user input is preserved as-is in spec.yaml
+ * - A git worktree is created at ~/.shep/repos/HASH/wt/SLUG/
+ * - Spec YAML files are scaffolded at WORKTREE/specs/NNN-SLUG/
+ * - Feature agent is spawned with the spec dir path
+ * - specPath is persisted on the Feature record
+ * - Initial lifecycle is Requirements
+ */
+import type { IFeatureRepository } from '../../../ports/output/repositories/feature-repository.interface.js';
+import type { IWorktreeService } from '../../../ports/output/services/worktree-service.interface.js';
+import type { IFeatureAgentProcessService } from '../../../ports/output/agents/feature-agent-process.interface.js';
+import type { IAgentRunRepository } from '../../../ports/output/agents/agent-run-repository.interface.js';
+import type { ISpecInitializerService } from '../../../ports/output/services/spec-initializer.interface.js';
+import { MetadataGenerator } from './metadata-generator.js';
+import { SlugResolver } from './slug-resolver.js';
+import type { CreateFeatureInput, CreateFeatureResult } from './types.js';
+export declare class CreateFeatureUseCase {
+    private readonly featureRepo;
+    private readonly worktreeService;
+    private readonly agentProcess;
+    private readonly runRepository;
+    private readonly specInitializer;
+    private readonly metadataGenerator;
+    private readonly slugResolver;
+    constructor(featureRepo: IFeatureRepository, worktreeService: IWorktreeService, agentProcess: IFeatureAgentProcessService, runRepository: IAgentRunRepository, specInitializer: ISpecInitializerService, metadataGenerator: MetadataGenerator, slugResolver: SlugResolver);
+    execute(input: CreateFeatureInput): Promise<CreateFeatureResult>;
+}
+//# sourceMappingURL=create-feature.use-case.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../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;CAyEvE"}

package/dist/src/application/use-cases/features/{create-feature.use-case.js → create/create-feature.use-case.js}

@@ -6,10 +6,9 @@
  * feature agent to begin autonomous SDLC processing.
  *
  * Business Rules:
- * - AI generates slug/name/description from user's free-text input
- * - Falls back to regex-based slug if AI fails
+ * - Metadata generation delegated to MetadataGenerator service
+ * - Slug uniqueness delegated to SlugResolver service
  * - Full user input is preserved as-is in spec.yaml
- * - Slug must be unique within the repository
  * - A git worktree is created at ~/.shep/repos/HASH/wt/SLUG/
  * - Spec YAML files are scaffolded at WORKTREE/specs/NNN-SLUG/
  * - Feature agent is spawned with the spec dir path
@@ -30,31 +29,32 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { injectable, inject } from 'tsyringe';
 import { randomUUID } from 'node:crypto';
-import { SdlcLifecycle } from '../../../domain/generated/output.js';
-import { AgentRunStatus } from '../../../domain/generated/output.js';
-import { getSettings } from '../../../infrastructure/services/settings.service.js';
-/** Maximum characters of user input sent to the AI for metadata generation. */
-const MAX_INPUT_FOR_AI = 500;
+import { SdlcLifecycle, AgentRunStatus } from '../../../../domain/generated/output.js';
+import { getSettings } from '../../../../infrastructure/services/settings.service.js';
+import { MetadataGenerator } from './metadata-generator.js';
+import { SlugResolver } from './slug-resolver.js';
 let CreateFeatureUseCase = class CreateFeatureUseCase {
     featureRepo;
     worktreeService;
     agentProcess;
     runRepository;
     specInitializer;
-    executorProvider;
-    constructor(featureRepo, worktreeService, agentProcess, runRepository, specInitializer, executorProvider) {
+    metadataGenerator;
+    slugResolver;
+    constructor(featureRepo, worktreeService, agentProcess, runRepository, specInitializer, metadataGenerator, slugResolver) {
         this.featureRepo = featureRepo;
         this.worktreeService = worktreeService;
         this.agentProcess = agentProcess;
         this.runRepository = runRepository;
         this.specInitializer = specInitializer;
-        this.executorProvider = executorProvider;
+        this.metadataGenerator = metadataGenerator;
+        this.slugResolver = slugResolver;
     }
     async execute(input) {
-        const metadata = await this.generateMetadata(input.userInput);
+        const metadata = await this.metadataGenerator.generateMetadata(input.userInput);
         const originalSlug = metadata.slug;
         // Find a unique slug — the branch may exist from a previous (deleted) feature
-        const { slug, branch, warning } = await this.resolveUniqueSlug(originalSlug, input.repositoryPath);
+        const { slug, branch, warning } = await this.slugResolver.resolveUniqueSlug(originalSlug, input.repositoryPath);
         // Determine next feature number for this repo
         const existingFeatures = await this.featureRepo.list({
             repositoryPath: input.repositoryPath,
@@ -105,91 +105,6 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
         });
         return { feature, warning };
     }
-    /**
-     * Find a unique slug by checking both the feature DB and git branches.
-     * If the original slug conflicts, appends -2, -3, etc. until a free one is found.
-     */
-    async resolveUniqueSlug(originalSlug, repositoryPath) {
-        const MAX_SUFFIX = 10;
-        for (let suffix = 0; suffix <= MAX_SUFFIX; suffix++) {
-            const slug = suffix === 0 ? originalSlug : `${originalSlug}-${suffix + 1}`;
-            const branch = `feat/${slug}`;
-            // Check if a feature with this slug already exists in the DB
-            const existing = await this.featureRepo.findBySlug(slug, repositoryPath);
-            if (existing) {
-                if (suffix === 0)
-                    continue; // try suffixed version
-                continue;
-            }
-            // Check if the git branch already exists (leftover from deleted feature)
-            const branchInUse = await this.worktreeService.exists(repositoryPath, branch);
-            if (branchInUse)
-                continue;
-            if (suffix > 0) {
-                return {
-                    slug,
-                    branch,
-                    warning: `Branch "feat/${originalSlug}" already exists, using "${branch}" instead`,
-                };
-            }
-            return { slug, branch };
-        }
-        throw new Error(`Could not find a unique slug for "${originalSlug}" after ${MAX_SUFFIX} attempts`);
-    }
-    async generateMetadata(userInput) {
-        try {
-            const executor = this.executorProvider.getExecutor();
-            const truncated = userInput.length > MAX_INPUT_FOR_AI
-                ? `${userInput.slice(0, MAX_INPUT_FOR_AI)}...`
-                : userInput;
-            const prompt = `Generate feature metadata from this user request:
-"${truncated}"
-
-Return ONLY a JSON object with these fields:
-- slug: kebab-case identifier, 2-4 words max (e.g., "github-oauth-login")
-- name: short human-readable title (e.g., "GitHub OAuth Login")
-- description: refined 1-2 sentence description
-
-JSON only, no markdown fences.`;
-            const result = await executor.execute(prompt, {
-                maxTurns: 1,
-                allowedTools: [],
-                silent: true,
-            });
-            const parsed = JSON.parse(result.result);
-            if (!parsed.slug || !parsed.name || !parsed.description) {
-                throw new Error('Missing required fields in AI response');
-            }
-            return {
-                slug: this.toSlug(parsed.slug),
-                name: parsed.name,
-                description: parsed.description,
-            };
-        }
-        catch {
-            // Fallback to regex-based slug generation
-            return {
-                slug: this.toSlug(userInput),
-                name: userInput,
-                description: userInput,
-            };
-        }
-    }
-    toSlug(text) {
-        const slug = text
-            .toLowerCase()
-            .replace(/[^a-z0-9\s-]/g, '')
-            .replace(/\s+/g, '-')
-            .replace(/-+/g, '-')
-            .replace(/^-|-$/g, '');
-        // Limit to ~50 chars, cutting at a word boundary
-        if (slug.length <= 50) {
-            return slug;
-        }
-        const truncated = slug.slice(0, 50);
-        const lastDash = truncated.lastIndexOf('-');
-        return lastDash > 10 ? truncated.slice(0, lastDash) : truncated;
-    }
 };
 CreateFeatureUseCase = __decorate([
     injectable(),
@@ -198,7 +113,9 @@ CreateFeatureUseCase = __decorate([
     __param(2, inject('IFeatureAgentProcessService')),
     __param(3, inject('IAgentRunRepository')),
     __param(4, inject('ISpecInitializerService')),
-    __param(5, inject('IAgentExecutorProvider')),
-    __metadata("design:paramtypes", [Object, Object, Object, Object, Object, Object])
+    __param(5, inject(MetadataGenerator)),
+    __param(6, inject(SlugResolver)),
+    __metadata("design:paramtypes", [Object, Object, Object, Object, Object, MetadataGenerator,
+        SlugResolver])
 ], CreateFeatureUseCase);
 export { CreateFeatureUseCase };

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

@@ -0,0 +1,28 @@
+/**
+ * MetadataGenerator
+ *
+ * Generates feature metadata (slug, name, description) from user input
+ * via AI call through IAgentExecutorProvider.
+ * Errors are propagated to the caller.
+ */
+import type { IAgentExecutorProvider } from '../../../ports/output/agents/agent-executor-provider.interface.js';
+import type { FeatureMetadata } from './types.js';
+export declare class MetadataGenerator {
+    private readonly executorProvider;
+    constructor(executorProvider: IAgentExecutorProvider);
+    /**
+     * Generate feature metadata from user input via AI.
+     * Errors are propagated to the caller.
+     */
+    generateMetadata(userInput: string): Promise<FeatureMetadata>;
+    /**
+     * Strip markdown code fence wrappers (```lang ... ```) if present at start/end.
+     */
+    private stripCodeFence;
+    /**
+     * Convert text to kebab-case slug with 50-char limit.
+     * Removes special characters, collapses spaces, limits length.
+     */
+    private toSlug;
+}
+//# sourceMappingURL=metadata-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-generator.d.ts","sourceRoot":"","sources":["../../../../../../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;IAyCnE;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;OAGG;IACH,OAAO,CAAC,MAAM;CAgBf"}

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

@@ -0,0 +1,109 @@
+/**
+ * MetadataGenerator
+ *
+ * Generates feature metadata (slug, name, description) from user input
+ * via AI call through IAgentExecutorProvider.
+ * Errors are propagated to the caller.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+/** Maximum characters of user input sent to the AI for metadata generation. */
+const MAX_INPUT_FOR_AI = 500;
+let MetadataGenerator = class MetadataGenerator {
+    executorProvider;
+    constructor(executorProvider) {
+        this.executorProvider = executorProvider;
+    }
+    /**
+     * 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;
+        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.
+
+Return ONLY 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,
+            allowedTools: [],
+            silent: true,
+        });
+        const cleaned = this.stripCodeFence(result.result);
+        const parsed = JSON.parse(cleaned);
+        if (!parsed.slug || !parsed.name || !parsed.description) {
+            throw new Error('Missing required fields in AI response');
+        }
+        return {
+            slug: this.toSlug(parsed.slug),
+            name: parsed.name,
+            description: parsed.description,
+        };
+    }
+    /**
+     * Strip markdown code fence wrappers (```lang ... ```) if present at start/end.
+     */
+    stripCodeFence(text) {
+        const trimmed = text.trim();
+        if (!trimmed.startsWith('```')) {
+            return trimmed;
+        }
+        // Find end of first line (```json or ```anything)
+        const firstNewline = trimmed.indexOf('\n');
+        if (firstNewline === -1) {
+            return trimmed;
+        }
+        if (!trimmed.endsWith('```')) {
+            return trimmed;
+        }
+        return trimmed.slice(firstNewline + 1, trimmed.length - 3).trim();
+    }
+    /**
+     * Convert text to kebab-case slug with 50-char limit.
+     * Removes special characters, collapses spaces, limits length.
+     */
+    toSlug(text) {
+        const slug = text
+            .toLowerCase()
+            .replace(/[^a-z0-9\s-]/g, '')
+            .replace(/\s+/g, '-')
+            .replace(/-+/g, '-')
+            .replace(/^-|-$/g, '');
+        // Limit to ~50 chars, cutting at a word boundary
+        if (slug.length <= 50) {
+            return slug;
+        }
+        const truncated = slug.slice(0, 50);
+        const lastDash = truncated.lastIndexOf('-');
+        return lastDash > 10 ? truncated.slice(0, lastDash) : truncated;
+    }
+};
+MetadataGenerator = __decorate([
+    injectable(),
+    __param(0, inject('IAgentExecutorProvider')),
+    __metadata("design:paramtypes", [Object])
+], MetadataGenerator);
+export { MetadataGenerator };

package/dist/src/application/use-cases/features/create/slug-resolver.d.ts

@@ -0,0 +1,24 @@
+/**
+ * SlugResolver
+ *
+ * Resolves unique slugs by checking against database and git branches.
+ * Ensures no slug collision by appending numeric suffixes (-2, -3, etc.)
+ */
+import type { IFeatureRepository } from '../../../ports/output/repositories/feature-repository.interface.js';
+import type { IWorktreeService } from '../../../ports/output/services/worktree-service.interface.js';
+export interface SlugResolutionResult {
+    slug: string;
+    branch: string;
+    warning?: string;
+}
+export declare class SlugResolver {
+    private readonly featureRepo;
+    private readonly worktreeService;
+    constructor(featureRepo: IFeatureRepository, worktreeService: IWorktreeService);
+    /**
+     * Find a unique slug by checking both the feature DB and git branches.
+     * If the original slug conflicts, appends -2, -3, etc. until a free one is found.
+     */
+    resolveUniqueSlug(originalSlug: string, repositoryPath: string): Promise<SlugResolutionResult>;
+}
+//# sourceMappingURL=slug-resolver.d.ts.map

package/dist/src/application/use-cases/features/create/slug-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug-resolver.d.ts","sourceRoot":"","sources":["../../../../../../src/application/use-cases/features/create/slug-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oEAAoE,CAAC;AAC7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAC;AAKrG,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBACa,YAAY;IAGrB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAFf,WAAW,EAAE,kBAAkB,EAE/B,eAAe,EAAE,gBAAgB;IAGpD;;;OAGG;IACG,iBAAiB,CACrB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,oBAAoB,CAAC;CA+BjC"}

package/dist/src/application/use-cases/features/create/slug-resolver.js

@@ -0,0 +1,66 @@
+/**
+ * SlugResolver
+ *
+ * Resolves unique slugs by checking against database and git branches.
+ * Ensures no slug collision by appending numeric suffixes (-2, -3, etc.)
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+/** Maximum number of suffix attempts before giving up */
+const MAX_SUFFIX = 10;
+let SlugResolver = class SlugResolver {
+    featureRepo;
+    worktreeService;
+    constructor(featureRepo, worktreeService) {
+        this.featureRepo = featureRepo;
+        this.worktreeService = worktreeService;
+    }
+    /**
+     * Find a unique slug by checking both the feature DB and git branches.
+     * If the original slug conflicts, appends -2, -3, etc. until a free one is found.
+     */
+    async resolveUniqueSlug(originalSlug, repositoryPath) {
+        for (let suffix = 0; suffix <= MAX_SUFFIX; suffix++) {
+            const slug = suffix === 0 ? originalSlug : `${originalSlug}-${suffix + 1}`;
+            const branch = `feat/${slug}`;
+            // Check if a feature with this slug already exists in the DB
+            const existing = await this.featureRepo.findBySlug(slug, repositoryPath);
+            if (existing) {
+                if (suffix === 0)
+                    continue; // try suffixed version
+                continue;
+            }
+            // Check if the git branch already exists (leftover from deleted feature)
+            const branchInUse = await this.worktreeService.exists(repositoryPath, branch);
+            if (branchInUse)
+                continue;
+            if (suffix > 0) {
+                return {
+                    slug,
+                    branch,
+                    warning: `Branch "feat/${originalSlug}" already exists, using "${branch}" instead`,
+                };
+            }
+            return { slug, branch };
+        }
+        throw new Error(`Could not find a unique slug for "${originalSlug}" after ${MAX_SUFFIX} attempts`);
+    }
+};
+SlugResolver = __decorate([
+    injectable(),
+    __param(0, inject('IFeatureRepository')),
+    __param(1, inject('IWorktreeService')),
+    __metadata("design:paramtypes", [Object, Object])
+], SlugResolver);
+export { SlugResolver };

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

@@ -0,0 +1,16 @@
+import type { ApprovalGates, Feature } from '../../../../domain/generated/output.js';
+export interface CreateFeatureInput {
+    userInput: string;
+    repositoryPath: string;
+    approvalGates?: ApprovalGates;
+}
+export interface CreateFeatureResult {
+    feature: Feature;
+    warning?: string;
+}
+export interface FeatureMetadata {
+    slug: string;
+    name: string;
+    description: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../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;CAC/B;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"}

package/dist/src/application/use-cases/features/create/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/application/use-cases/tools/install-tool.use-case.d.ts

@@ -0,0 +1,21 @@
+/**
+ * InstallToolUseCase
+ *
+ * Executes the installation of a tool with live output streaming support.
+ * Returns detailed status information about the installation result.
+ */
+import type { ToolInstallationStatus } from '../../../domain/generated/output.js';
+import type { IToolInstallerService } from '../../ports/output/services/index.js';
+export declare class InstallToolUseCase {
+    private readonly toolInstallerService;
+    constructor(toolInstallerService: IToolInstallerService);
+    /**
+     * Executes installation of a tool with optional output streaming.
+     *
+     * @param toolName - Name of the tool to install
+     * @param onOutput - Optional callback for streaming installation output
+     * @returns Status information about the installation result
+     */
+    execute(toolName: string, onOutput?: (data: string) => void): Promise<ToolInstallationStatus>;
+}
+//# sourceMappingURL=install-tool.use-case.d.ts.map

package/dist/src/application/use-cases/tools/install-tool.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-tool.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/tools/install-tool.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAElF,qBACa,kBAAkB;IAG3B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBAApB,oBAAoB,EAAE,qBAAqB;IAG9D;;;;;;OAMG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC,sBAAsB,CAAC;CAGnC"}

package/dist/src/application/use-cases/tools/install-tool.use-case.js

@@ -0,0 +1,41 @@
+/**
+ * InstallToolUseCase
+ *
+ * Executes the installation of a tool with live output streaming support.
+ * Returns detailed status information about the installation result.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+let InstallToolUseCase = class InstallToolUseCase {
+    toolInstallerService;
+    constructor(toolInstallerService) {
+        this.toolInstallerService = toolInstallerService;
+    }
+    /**
+     * Executes installation of a tool with optional output streaming.
+     *
+     * @param toolName - Name of the tool to install
+     * @param onOutput - Optional callback for streaming installation output
+     * @returns Status information about the installation result
+     */
+    async execute(toolName, onOutput) {
+        return this.toolInstallerService.executeInstall(toolName, onOutput);
+    }
+};
+InstallToolUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IToolInstallerService')),
+    __metadata("design:paramtypes", [Object])
+], InstallToolUseCase);
+export { InstallToolUseCase };

package/dist/src/application/use-cases/tools/validate-tool-availability.use-case.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ValidateToolAvailabilityUseCase
+ *
+ * Validates if a tool is available on the system by checking its presence in PATH.
+ * Returns detailed status information including installation suggestions if missing.
+ */
+import type { ToolInstallationStatus } from '../../../domain/generated/output.js';
+import type { IToolInstallerService } from '../../ports/output/services/index.js';
+export declare class ValidateToolAvailabilityUseCase {
+    private readonly toolInstallerService;
+    constructor(toolInstallerService: IToolInstallerService);
+    /**
+     * Validates if a tool is available on the system.
+     *
+     * @param toolName - Name of the tool to validate
+     * @returns Status information about the tool's availability
+     */
+    execute(toolName: string): Promise<ToolInstallationStatus>;
+}
+//# sourceMappingURL=validate-tool-availability.use-case.d.ts.map

package/dist/src/application/use-cases/tools/validate-tool-availability.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-tool-availability.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/tools/validate-tool-availability.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAElF,qBACa,+BAA+B;IAGxC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBAApB,oBAAoB,EAAE,qBAAqB;IAG9D;;;;;OAKG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAGjE"}