@shepai/cli 1.18.0 → 1.20.0

package/dist/src/infrastructure/services/agents/feature-agent/nodes/schemas/research.schema.js

@@ -0,0 +1,24 @@
+import { requireString, requireArrayOfShape, requireNonEmptyArray, } from './validation.js';
+export function validateResearch(data) {
+    const errors = [];
+    if (!data || typeof data !== 'object') {
+        errors.push('YAML parsed to null or non-object');
+        return { valid: false, errors };
+    }
+    const d = data;
+    requireString(d, 'name', errors);
+    requireString(d, 'summary', errors);
+    requireString(d, 'content', errors);
+    requireArrayOfShape(d, 'decisions', errors, (item, idx, errs) => {
+        const decision = item;
+        if (!decision || typeof decision !== 'object') {
+            errs.push(`decisions[${idx}] must be an object`);
+            return;
+        }
+        requireString(decision, 'title', errs, `decisions[${idx}].`);
+        requireString(decision, 'chosen', errs, `decisions[${idx}].`);
+        requireNonEmptyArray(decision, 'rejected', errs, `decisions[${idx}].`);
+        requireString(decision, 'rationale', errs, `decisions[${idx}].`);
+    });
+    return { valid: errors.length === 0, errors };
+}

package/dist/src/infrastructure/services/agents/feature-agent/nodes/schemas/spec.schema.d.ts

@@ -0,0 +1,4 @@
+import { type ValidationResult } from './validation.js';
+export declare function validateSpecAnalyze(data: unknown): ValidationResult;
+export declare function validateSpecRequirements(data: unknown): ValidationResult;
+//# sourceMappingURL=spec.schema.d.ts.map

package/dist/src/infrastructure/services/agents/feature-agent/nodes/schemas/spec.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.schema.d.ts","sourceRoot":"","sources":["../../../../../../../../src/infrastructure/services/agents/feature-agent/nodes/schemas/spec.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AA4B7F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAInE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAqBxE"}

package/dist/src/infrastructure/services/agents/feature-agent/nodes/schemas/spec.schema.js

@@ -0,0 +1,50 @@
+import { requireString, requireNonEmptyArray } from './validation.js';
+const VALID_SIZE_ESTIMATES = ['S', 'M', 'L', 'XL'];
+function validateBaseSpec(data, errors) {
+    if (!data || typeof data !== 'object') {
+        errors.push('YAML parsed to null or non-object');
+        return false;
+    }
+    const d = data;
+    requireString(d, 'name', errors);
+    requireString(d, 'oneLiner', errors);
+    requireString(d, 'summary', errors);
+    requireString(d, 'phase', errors);
+    requireString(d, 'content', errors);
+    requireNonEmptyArray(d, 'technologies', errors);
+    if (typeof d.sizeEstimate === 'string' && !VALID_SIZE_ESTIMATES.includes(d.sizeEstimate)) {
+        errors.push(`Field 'sizeEstimate' must be one of ${VALID_SIZE_ESTIMATES.join(', ')}, got '${d.sizeEstimate}'`);
+    }
+    else if (typeof d.sizeEstimate !== 'string') {
+        requireString(d, 'sizeEstimate', errors);
+    }
+    return true;
+}
+export function validateSpecAnalyze(data) {
+    const errors = [];
+    validateBaseSpec(data, errors);
+    return { valid: errors.length === 0, errors };
+}
+export function validateSpecRequirements(data) {
+    const errors = [];
+    if (!validateBaseSpec(data, errors))
+        return { valid: false, errors };
+    const d = data;
+    if (!('openQuestions' in d)) {
+        errors.push("Missing required field 'openQuestions'");
+    }
+    else if (Array.isArray(d.openQuestions)) {
+        for (let i = 0; i < d.openQuestions.length; i++) {
+            const q = d.openQuestions[i];
+            if (!q || typeof q !== 'object') {
+                errors.push(`openQuestions[${i}] must be an object`);
+                continue;
+            }
+            requireString(q, 'question', errors, `openQuestions[${i}].`);
+        }
+    }
+    else {
+        errors.push("Field 'openQuestions' must be an array");
+    }
+    return { valid: errors.length === 0, errors };
+}

package/dist/src/infrastructure/services/agents/feature-agent/nodes/schemas/validation.d.ts

@@ -0,0 +1,8 @@
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare function requireString(data: Record<string, unknown>, field: string, errors: string[], prefix?: string): void;
+export declare function requireNonEmptyArray(data: Record<string, unknown>, field: string, errors: string[], prefix?: string): unknown[] | null;
+export declare function requireArrayOfShape(data: Record<string, unknown>, field: string, errors: string[], itemChecker: (item: unknown, index: number, errors: string[]) => void, prefix?: string): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/infrastructure/services/agents/feature-agent/nodes/schemas/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../../../../../src/infrastructure/services/agents/feature-agent/nodes/schemas/validation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,SAAK,GACV,IAAI,CASN;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,SAAK,GACV,OAAO,EAAE,GAAG,IAAI,CAelB;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,EAChB,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,EACrE,MAAM,SAAK,GACV,IAAI,CAMN"}

package/dist/src/infrastructure/services/agents/feature-agent/nodes/schemas/validation.js

@@ -0,0 +1,36 @@
+export function requireString(data, field, errors, prefix = '') {
+    const val = data[field];
+    if (val === undefined || val === null) {
+        errors.push(`Missing required string field '${prefix}${field}'`);
+    }
+    else if (typeof val !== 'string') {
+        errors.push(`Field '${prefix}${field}' must be a string, got ${typeof val}`);
+    }
+    else if (val.trim() === '') {
+        errors.push(`Field '${prefix}${field}' must not be empty`);
+    }
+}
+export function requireNonEmptyArray(data, field, errors, prefix = '') {
+    const val = data[field];
+    if (val === undefined || val === null) {
+        errors.push(`Missing required array field '${prefix}${field}'`);
+        return null;
+    }
+    if (!Array.isArray(val)) {
+        errors.push(`Field '${prefix}${field}' must be an array, got ${typeof val}`);
+        return null;
+    }
+    if (val.length === 0) {
+        errors.push(`Field '${prefix}${field}' must not be empty`);
+        return null;
+    }
+    return val;
+}
+export function requireArrayOfShape(data, field, errors, itemChecker, prefix = '') {
+    const arr = requireNonEmptyArray(data, field, errors, prefix);
+    if (!arr)
+        return;
+    for (let i = 0; i < arr.length; i++) {
+        itemChecker(arr[i], i, errors);
+    }
+}

package/dist/src/infrastructure/services/agents/feature-agent/nodes/validate.node.d.ts

@@ -0,0 +1,12 @@
+import type { FeatureAgentState } from '../state.js';
+import type { ValidationResult } from './schemas/validation.js';
+type SchemaValidator = (data: unknown) => ValidationResult;
+/**
+ * Factory that creates a validate node for a specific YAML file.
+ *
+ * On success: resets validationRetries to 0, clears errors.
+ * On failure: increments validationRetries, sets errors for repair node.
+ */
+export declare function createValidateNode(filename: string, schema: SchemaValidator): (state: FeatureAgentState) => Promise<Partial<FeatureAgentState>>;
+export {};
+//# sourceMappingURL=validate.node.d.ts.map

package/dist/src/infrastructure/services/agents/feature-agent/nodes/validate.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.node.d.ts","sourceRoot":"","sources":["../../../../../../../src/infrastructure/services/agents/feature-agent/nodes/validate.node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,KAAK,eAAe,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,gBAAgB,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,GACtB,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAsDnE"}

package/dist/src/infrastructure/services/agents/feature-agent/nodes/validate.node.js

@@ -0,0 +1,58 @@
+import { readSpecFile, safeYamlLoad, createNodeLogger } from './node-helpers.js';
+/**
+ * Factory that creates a validate node for a specific YAML file.
+ *
+ * On success: resets validationRetries to 0, clears errors.
+ * On failure: increments validationRetries, sets errors for repair node.
+ */
+export function createValidateNode(filename, schema) {
+    const log = createNodeLogger(`validate:${filename}`);
+    return async (state) => {
+        log.info(`Validating ${filename}`);
+        const content = readSpecFile(state.specDir, filename);
+        if (!content) {
+            const errors = [`File '${filename}' not found or empty in ${state.specDir}`];
+            log.error(errors[0]);
+            return {
+                lastValidationTarget: filename,
+                lastValidationErrors: errors,
+                validationRetries: state.validationRetries + 1,
+                messages: [`[validate:${filename}] FAIL: ${errors[0]}`],
+            };
+        }
+        // Try to parse
+        let parsed;
+        try {
+            parsed = safeYamlLoad(content);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            const errors = [`YAML parse error in ${filename}: ${msg}`];
+            log.error(errors[0]);
+            return {
+                lastValidationTarget: filename,
+                lastValidationErrors: errors,
+                validationRetries: state.validationRetries + 1,
+                messages: [`[validate:${filename}] FAIL: parse error`],
+            };
+        }
+        // Run schema validation
+        const result = schema(parsed);
+        if (result.valid) {
+            log.info('Validation passed');
+            return {
+                lastValidationTarget: filename,
+                lastValidationErrors: [],
+                validationRetries: 0,
+                messages: [`[validate:${filename}] PASS`],
+            };
+        }
+        log.error(`Validation failed: ${result.errors.join('; ')}`);
+        return {
+            lastValidationTarget: filename,
+            lastValidationErrors: result.errors,
+            validationRetries: state.validationRetries + 1,
+            messages: [`[validate:${filename}] FAIL: ${result.errors.length} error(s)`],
+        };
+    };
+}

package/dist/src/infrastructure/services/agents/feature-agent/phase-timing-context.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Phase Timing Context
+ *
+ * Module-level singleton that provides phase timing recording
+ * to executeNode() without changing its public API.
+ *
+ * The worker calls setPhaseTimingContext() once after DI init.
+ * Node helpers call recordPhaseStart/End() during graph execution.
+ * Errors are swallowed so timing never blocks graph execution.
+ */
+import type { IPhaseTimingRepository } from '../../../../application/ports/output/agents/phase-timing-repository.interface.js';
+/**
+ * Set the phase timing context. Called once by the worker after DI init.
+ */
+export declare function setPhaseTimingContext(runId: string, repository: IPhaseTimingRepository): void;
+/**
+ * Clear the phase timing context. Useful for testing.
+ */
+export declare function clearPhaseTimingContext(): void;
+/**
+ * Record the start of a phase. Returns the timing record ID (for later update)
+ * or null if context is not set or save fails.
+ */
+export declare function recordPhaseStart(phase: string): Promise<string | null>;
+/**
+ * Record the end of a phase. Updates the timing record with completedAt and durationMs.
+ * No-op if timingId is null (phase start was skipped or failed).
+ */
+export declare function recordPhaseEnd(timingId: string | null, durationMs: number): Promise<void>;
+//# sourceMappingURL=phase-timing-context.d.ts.map

package/dist/src/infrastructure/services/agents/feature-agent/phase-timing-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-timing-context.d.ts","sourceRoot":"","sources":["../../../../../../src/infrastructure/services/agents/feature-agent/phase-timing-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wEAAwE,CAAC;AAKrH;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAG7F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmB5E;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/F"}

package/dist/src/infrastructure/services/agents/feature-agent/phase-timing-context.js

@@ -0,0 +1,68 @@
+/**
+ * Phase Timing Context
+ *
+ * Module-level singleton that provides phase timing recording
+ * to executeNode() without changing its public API.
+ *
+ * The worker calls setPhaseTimingContext() once after DI init.
+ * Node helpers call recordPhaseStart/End() during graph execution.
+ * Errors are swallowed so timing never blocks graph execution.
+ */
+import { randomUUID } from 'node:crypto';
+let contextRunId;
+let contextRepository;
+/**
+ * Set the phase timing context. Called once by the worker after DI init.
+ */
+export function setPhaseTimingContext(runId, repository) {
+    contextRunId = runId;
+    contextRepository = repository;
+}
+/**
+ * Clear the phase timing context. Useful for testing.
+ */
+export function clearPhaseTimingContext() {
+    contextRunId = undefined;
+    contextRepository = undefined;
+}
+/**
+ * Record the start of a phase. Returns the timing record ID (for later update)
+ * or null if context is not set or save fails.
+ */
+export async function recordPhaseStart(phase) {
+    if (!contextRunId || !contextRepository)
+        return null;
+    const id = randomUUID();
+    const now = new Date();
+    try {
+        await contextRepository.save({
+            id,
+            agentRunId: contextRunId,
+            phase,
+            startedAt: now,
+            createdAt: now,
+            updatedAt: now,
+        });
+        return id;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Record the end of a phase. Updates the timing record with completedAt and durationMs.
+ * No-op if timingId is null (phase start was skipped or failed).
+ */
+export async function recordPhaseEnd(timingId, durationMs) {
+    if (!timingId || !contextRepository)
+        return;
+    try {
+        await contextRepository.update(timingId, {
+            completedAt: new Date(),
+            durationMs: BigInt(durationMs),
+        });
+    }
+    catch {
+        // Swallow — timing update failure is non-fatal
+    }
+}

package/dist/src/infrastructure/services/agents/feature-agent/state.d.ts

@@ -1,3 +1,4 @@
+import type { ApprovalGates } from '../../../../domain/generated/output.js';
 /**
  * State annotation for the feature-agent graph.
  *
@@ -32,8 +33,11 @@ export declare const FeatureAgentAnnotation: import("@langchain/langgraph").Anno
         Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
     };
     error: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
-    approvalMode: import("@langchain/langgraph").BinaryOperatorAggregate<string | undefined, string | undefined>;
+    approvalGates: import("@langchain/langgraph").BinaryOperatorAggregate<ApprovalGates | undefined, 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[]>;
 }>;
 export type FeatureAgentState = typeof FeatureAgentAnnotation.State;
 //# sourceMappingURL=state.d.ts.map

package/dist/src/infrastructure/services/agents/feature-agent/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../../src/infrastructure/services/agents/feature-agent/state.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBjC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,OAAO,sBAAsB,CAAC,KAAK,CAAC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../../src/infrastructure/services/agents/feature-agent/state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BjC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,OAAO,sBAAsB,CAAC,KAAK,CAAC"}

package/dist/src/infrastructure/services/agents/feature-agent/state.js

@@ -16,7 +16,7 @@ export const FeatureAgentAnnotation = Annotation.Root({
         reducer: (prev, next) => (next !== undefined ? next : prev),
         default: () => null,
     }),
-    approvalMode: Annotation({
+    approvalGates: Annotation({
         reducer: (prev, next) => next ?? prev,
         default: () => undefined,
     }),
@@ -24,4 +24,17 @@ export const FeatureAgentAnnotation = Annotation.Root({
         reducer: (prev, next) => [...prev, ...next],
         default: () => [],
     }),
+    // --- Validation state channels (for validate/repair loops) ---
+    validationRetries: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => 0,
+    }),
+    lastValidationTarget: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => '',
+    }),
+    lastValidationErrors: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => [],
+    }),
 });

package/dist/src/infrastructure/services/ide-launchers/antigravity.launcher.d.ts

@@ -0,0 +1,10 @@
+import { EditorType } from '../../../domain/generated/output.js';
+import type { IdeLauncher } from './ide-launcher.interface';
+export declare class AntigravityLauncher implements IdeLauncher {
+    readonly name = "Antigravity";
+    readonly editorId = EditorType.Antigravity;
+    readonly binary = "antigravity";
+    launch(path: string): Promise<void>;
+    checkAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=antigravity.launcher.d.ts.map

package/dist/src/infrastructure/services/ide-launchers/antigravity.launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"antigravity.launcher.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/services/ide-launchers/antigravity.launcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,mBAAoB,YAAW,WAAW;IACrD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,QAAQ,0BAA0B;IAC3C,QAAQ,CAAC,MAAM,iBAAiB;IAE1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}

package/dist/src/infrastructure/services/ide-launchers/antigravity.launcher.js

@@ -0,0 +1,21 @@
+import { spawn, execFile } from 'node:child_process';
+import { EditorType } from '../../../domain/generated/output.js';
+export class AntigravityLauncher {
+    name = 'Antigravity';
+    editorId = EditorType.Antigravity;
+    binary = 'antigravity';
+    async launch(path) {
+        const child = spawn(this.binary, [path], {
+            detached: true,
+            stdio: 'ignore',
+        });
+        child.unref();
+    }
+    checkAvailable() {
+        return new Promise((resolve) => {
+            execFile('which', [this.binary], (err) => {
+                resolve(!err);
+            });
+        });
+    }
+}

package/dist/src/infrastructure/services/ide-launchers/cursor.launcher.d.ts

@@ -0,0 +1,10 @@
+import { EditorType } from '../../../domain/generated/output.js';
+import type { IdeLauncher } from './ide-launcher.interface';
+export declare class CursorLauncher implements IdeLauncher {
+    readonly name = "Cursor";
+    readonly editorId = EditorType.Cursor;
+    readonly binary = "cursor";
+    launch(path: string): Promise<void>;
+    checkAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=cursor.launcher.d.ts.map

package/dist/src/infrastructure/services/ide-launchers/cursor.launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.launcher.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/services/ide-launchers/cursor.launcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,cAAe,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,QAAQ,qBAAqB;IACtC,QAAQ,CAAC,MAAM,YAAY;IAErB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}

package/dist/src/infrastructure/services/ide-launchers/cursor.launcher.js

@@ -0,0 +1,21 @@
+import { spawn, execFile } from 'node:child_process';
+import { EditorType } from '../../../domain/generated/output.js';
+export class CursorLauncher {
+    name = 'Cursor';
+    editorId = EditorType.Cursor;
+    binary = 'cursor';
+    async launch(path) {
+        const child = spawn(this.binary, [path], {
+            detached: true,
+            stdio: 'ignore',
+        });
+        child.unref();
+    }
+    checkAvailable() {
+        return new Promise((resolve) => {
+            execFile('which', [this.binary], (err) => {
+                resolve(!err);
+            });
+        });
+    }
+}

package/dist/src/infrastructure/services/ide-launchers/ide-launcher.interface.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Interface for IDE launcher implementations.
+ *
+ * Each supported IDE (VS Code, Cursor, Windsurf, Zed, Antigravity) provides
+ * its own implementation of this interface. Launchers are responsible for
+ * spawning a detached editor process and checking binary availability.
+ */
+import type { EditorType } from '../../../domain/generated/output.js';
+export interface IdeLauncher {
+    /** Display name shown to the user (e.g., "VS Code"). */
+    readonly name: string;
+    /** Editor identifier matching the EditorType enum value. */
+    readonly editorId: EditorType;
+    /** CLI binary used to launch the editor (e.g., "code"). */
+    readonly binary: string;
+    /**
+     * Open the IDE at the given filesystem path.
+     *
+     * Spawns a detached process so the CLI does not block.
+     *
+     * @param path - Absolute path to the file or directory to open.
+     */
+    launch(path: string): Promise<void>;
+    /**
+     * Check whether the IDE binary is available on the system PATH.
+     *
+     * @returns `true` if the binary can be found and executed, `false` otherwise.
+     */
+    checkAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=ide-launcher.interface.d.ts.map

package/dist/src/infrastructure/services/ide-launchers/ide-launcher.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ide-launcher.interface.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/services/ide-launchers/ide-launcher.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAE9B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;;;OAIG;IACH,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACpC"}

package/dist/src/infrastructure/services/ide-launchers/ide-launcher.interface.js

@@ -0,0 +1,8 @@
+/**
+ * Interface for IDE launcher implementations.
+ *
+ * Each supported IDE (VS Code, Cursor, Windsurf, Zed, Antigravity) provides
+ * its own implementation of this interface. Launchers are responsible for
+ * spawning a detached editor process and checking binary availability.
+ */
+export {};

package/dist/src/infrastructure/services/ide-launchers/ide-launcher.registry.d.ts

@@ -0,0 +1,9 @@
+import type { EditorType } from '../../../domain/generated/output.js';
+import type { IdeLauncher } from './ide-launcher.interface.js';
+/**
+ * Create a registry of all supported IDE launchers, keyed by EditorType.
+ *
+ * @returns A Map from EditorType to its IdeLauncher instance.
+ */
+export declare function createLauncherRegistry(): Map<EditorType, IdeLauncher>;
+//# sourceMappingURL=ide-launcher.registry.d.ts.map

package/dist/src/infrastructure/services/ide-launchers/ide-launcher.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ide-launcher.registry.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/services/ide-launchers/ide-launcher.registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAO/D;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAcrE"}

package/dist/src/infrastructure/services/ide-launchers/ide-launcher.registry.js

@@ -0,0 +1,24 @@
+import { AntigravityLauncher } from './antigravity.launcher.js';
+import { CursorLauncher } from './cursor.launcher.js';
+import { VsCodeLauncher } from './vscode.launcher.js';
+import { WindsurfLauncher } from './windsurf.launcher.js';
+import { ZedLauncher } from './zed.launcher.js';
+/**
+ * Create a registry of all supported IDE launchers, keyed by EditorType.
+ *
+ * @returns A Map from EditorType to its IdeLauncher instance.
+ */
+export function createLauncherRegistry() {
+    const launchers = [
+        new VsCodeLauncher(),
+        new CursorLauncher(),
+        new WindsurfLauncher(),
+        new ZedLauncher(),
+        new AntigravityLauncher(),
+    ];
+    const registry = new Map();
+    for (const launcher of launchers) {
+        registry.set(launcher.editorId, launcher);
+    }
+    return registry;
+}

package/dist/src/infrastructure/services/ide-launchers/vscode.launcher.d.ts

@@ -0,0 +1,10 @@
+import { EditorType } from '../../../domain/generated/output.js';
+import type { IdeLauncher } from './ide-launcher.interface';
+export declare class VsCodeLauncher implements IdeLauncher {
+    readonly name = "VS Code";
+    readonly editorId = EditorType.VsCode;
+    readonly binary = "code";
+    launch(path: string): Promise<void>;
+    checkAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=vscode.launcher.d.ts.map

package/dist/src/infrastructure/services/ide-launchers/vscode.launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vscode.launcher.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/services/ide-launchers/vscode.launcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,cAAe,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,QAAQ,qBAAqB;IACtC,QAAQ,CAAC,MAAM,UAAU;IAEnB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}

package/dist/src/infrastructure/services/ide-launchers/vscode.launcher.js

@@ -0,0 +1,21 @@
+import { spawn, execFile } from 'node:child_process';
+import { EditorType } from '../../../domain/generated/output.js';
+export class VsCodeLauncher {
+    name = 'VS Code';
+    editorId = EditorType.VsCode;
+    binary = 'code';
+    async launch(path) {
+        const child = spawn(this.binary, [path], {
+            detached: true,
+            stdio: 'ignore',
+        });
+        child.unref();
+    }
+    checkAvailable() {
+        return new Promise((resolve) => {
+            execFile('which', [this.binary], (err) => {
+                resolve(!err);
+            });
+        });
+    }
+}

package/dist/src/infrastructure/services/ide-launchers/windsurf.launcher.d.ts

@@ -0,0 +1,10 @@
+import { EditorType } from '../../../domain/generated/output.js';
+import type { IdeLauncher } from './ide-launcher.interface';
+export declare class WindsurfLauncher implements IdeLauncher {
+    readonly name = "Windsurf";
+    readonly editorId = EditorType.Windsurf;
+    readonly binary = "windsurf";
+    launch(path: string): Promise<void>;
+    checkAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=windsurf.launcher.d.ts.map

package/dist/src/infrastructure/services/ide-launchers/windsurf.launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.launcher.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/services/ide-launchers/windsurf.launcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,gBAAiB,YAAW,WAAW;IAClD,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,QAAQ,uBAAuB;IACxC,QAAQ,CAAC,MAAM,cAAc;IAEvB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}

package/dist/src/infrastructure/services/ide-launchers/windsurf.launcher.js

@@ -0,0 +1,21 @@
+import { spawn, execFile } from 'node:child_process';
+import { EditorType } from '../../../domain/generated/output.js';
+export class WindsurfLauncher {
+    name = 'Windsurf';
+    editorId = EditorType.Windsurf;
+    binary = 'windsurf';
+    async launch(path) {
+        const child = spawn(this.binary, [path], {
+            detached: true,
+            stdio: 'ignore',
+        });
+        child.unref();
+    }
+    checkAvailable() {
+        return new Promise((resolve) => {
+            execFile('which', [this.binary], (err) => {
+                resolve(!err);
+            });
+        });
+    }
+}

package/dist/src/infrastructure/services/ide-launchers/zed.launcher.d.ts

@@ -0,0 +1,10 @@
+import { EditorType } from '../../../domain/generated/output.js';
+import type { IdeLauncher } from './ide-launcher.interface';
+export declare class ZedLauncher implements IdeLauncher {
+    readonly name = "Zed";
+    readonly editorId = EditorType.Zed;
+    readonly binary = "zed";
+    launch(path: string): Promise<void>;
+    checkAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=zed.launcher.d.ts.map

package/dist/src/infrastructure/services/ide-launchers/zed.launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zed.launcher.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/services/ide-launchers/zed.launcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,WAAY,YAAW,WAAW;IAC7C,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,QAAQ,kBAAkB;IACnC,QAAQ,CAAC,MAAM,SAAS;IAElB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAOnC"}