@amsterdamdatalabs/enact-factory 0.1.1

package/dist/adapters/cryptoQuantAdapter.js

@@ -0,0 +1,238 @@
+// ============================================
+// CryptoQuant API Adapter
+// Stablecoin Exchange Flow Analysis
+// USDC Netflow data integration for Risk-On signals
+import * as https from 'https';
+// CryptoQuantAdapter Class
+export class CryptoQuantAdapter {
+    apiToken;
+    baseUrl;
+    cacheDir;
+    rateLimitPerDay;
+    dataWindow;
+    rateLimitState;
+    constructor(config) {
+        this.apiToken = config.apiToken;
+        this.baseUrl = config.baseUrl || 'https://api.cryptoquant.com/v1';
+        this.cacheDir = config.cacheDir || './cache/cryptoquant';
+        this.rateLimitPerDay = config.rateLimitPerDay || 50;
+        this.dataWindow = config.dataWindow || 7; // Default 7 days
+        this.rateLimitState = {
+            requestsToday: 0,
+            lastResetDate: new Date().toISOString().slice(0, 10),
+        };
+    }
+    /**
+     * Fetch USDC Netflow data from CryptoQuant
+     * @param exchange - Exchange name (e.g., "binance", "coinbase", "kraken")
+     * @param daysBack - Number of days back from today (default: 7)
+     */
+    async getUSDCNetflow(exchange, daysBack = 7) {
+        // Check rate limit
+        this.checkRateLimit();
+        const toDate = new Date();
+        const fromDate = new Date(toDate.getTime() - daysBack * 24 * 60 * 60 * 1000);
+        const fromStr = fromDate.toISOString().slice(0, 10).replace(/-/g, '');
+        const toStr = toDate.toISOString().slice(0, 10).replace(/-/g, '');
+        const params = {
+            token: 'usdc_eth', // USDC on Ethereum
+            exchange: exchange,
+            window: 'day',
+            from: fromStr,
+            to: toStr,
+            limit: daysBack,
+        };
+        const queryString = new URLSearchParams(params).toString(); // eslint-disable-line @typescript-eslint/no-explicit-any -- mixed param types
+        const url = `${this.baseUrl}/stablecoin/exchange-flows/netflow?${queryString}`;
+        console.log(`[CryptoQuantAdapter] Fetching USDC Netflow: ${exchange} (${daysBack}d)`);
+        try {
+            const response = await this.makeRequest(url);
+            if (!response.data || !Array.isArray(response.data)) {
+                console.warn('[CryptoQuantAdapter] Unexpected response format:', response);
+                return [];
+            }
+            // Transform API response to USDCNetflowData
+            const data = response.data.map((item) => ({
+                timestamp: item.timestamp || Math.floor(new Date(item.date).getTime() / 1000),
+                date: item.date,
+                exchange: exchange,
+                netflow: item.netflow || (item.inflow - item.outflow),
+                inflow: item.inflow,
+                outflow: item.outflow,
+                token: 'usdc_eth',
+            }));
+            this.recordApiCall();
+            return data;
+        }
+        catch (err) {
+            console.error('[CryptoQuantAdapter] API error:', err);
+            throw err;
+        }
+    }
+    /**
+     * Fetch USDC Netflow from multiple exchanges
+     */
+    async getUSDCNetflowMultiExchange(exchanges = ['binance', 'coinbase', 'kraken'], daysBack = 7) {
+        const results = new Map();
+        for (const exchange of exchanges) {
+            try {
+                const data = await this.getUSDCNetflow(exchange, daysBack);
+                results.set(exchange, data);
+            }
+            catch (err) {
+                console.warn(`[CryptoQuantAdapter] Failed to fetch ${exchange}:`, err);
+                results.set(exchange, []);
+            }
+        }
+        return results;
+    }
+    /**
+     * Analyze USDC Netflow data for Risk-On signal
+     */
+    analyzeRiskOnSignal(data) {
+        if (data.length === 0) {
+            return {
+                score: 50,
+                trend: 'stable',
+                netflowTrend: 0,
+                cexInflowStrength: 0,
+                cexOutflowStrength: 0,
+                confidence: 0,
+                lastUpdated: Date.now(),
+                recommendation: '데이터 부족으로 신호를 분석할 수 없습니다.',
+            };
+        }
+        // Sort by timestamp
+        const sorted = [...data].sort((a, b) => a.timestamp - b.timestamp);
+        // Calculate netflow trend (recent vs older)
+        const recent = sorted.slice(-3);
+        const older = sorted.slice(0, Math.max(1, sorted.length - 3));
+        const recentNetflow = recent.reduce((sum, d) => sum + d.netflow, 0) / recent.length;
+        const olderNetflow = older.reduce((sum, d) => sum + d.netflow, 0) / older.length;
+        const netflowTrend = recentNetflow - olderNetflow;
+        const trend = netflowTrend > 100 ? 'increasing' : netflowTrend < -100 ? 'decreasing' : 'stable';
+        // Calculate inflow/outflow strength
+        const totalInflow = sorted.reduce((sum, d) => sum + d.inflow, 0);
+        const totalOutflow = sorted.reduce((sum, d) => sum + d.outflow, 0);
+        const totalFlow = totalInflow + totalOutflow;
+        const inflowRatio = totalFlow > 0 ? totalInflow / totalFlow : 0.5;
+        const outflowRatio = totalFlow > 0 ? totalOutflow / totalFlow : 0.5;
+        // Risk-On Score calculation
+        // 위험자산 선호: CEX inflow 증가 = 구매압 증가
+        // 위험자산 회피: CEX outflow 증가 = 판매압 증가
+        const inflowScore = Math.min(100, inflowRatio * 200); // 0-100
+        const outflowScore = Math.min(100, outflowRatio * 200); // 0-100
+        const trendScore = Math.min(100, Math.max(0, 50 + (netflowTrend / 1000) * 50)); // 0-100
+        const score = Math.round((inflowScore * 0.5 + trendScore * 0.5));
+        // Confidence based on data consistency
+        const variance = this.calculateVariance(sorted.map(d => d.netflow));
+        const confidence = Math.round(Math.max(0, Math.min(100, 100 - variance / 100)));
+        // Recommendation
+        let recommendation = '';
+        if (score > 65) {
+            recommendation = '🟢 위험자산 선호 신호 (Risk-On): CEX 유입이 강함';
+        }
+        else if (score < 35) {
+            recommendation = '🔴 위험자산 회피 신호 (Risk-Off): CEX 유출이 강함';
+        }
+        else {
+            recommendation = '🟡 중립: 명확한 신호 없음';
+        }
+        return {
+            score,
+            trend,
+            netflowTrend,
+            cexInflowStrength: Math.round(inflowScore),
+            cexOutflowStrength: Math.round(outflowScore),
+            confidence,
+            lastUpdated: Date.now(),
+            recommendation,
+        };
+    }
+    /**
+     * Private: Make HTTPS request
+     */
+    async makeRequest(url) {
+        return new Promise((resolve, reject) => {
+            https.get(url, {
+                headers: {
+                    'Authorization': `Bearer ${this.apiToken}`,
+                    'User-Agent': 'EnactFactory/1.0',
+                },
+            }, (res) => {
+                let data = '';
+                res.on('data', (chunk) => {
+                    data += chunk;
+                });
+                res.on('end', () => {
+                    try {
+                        const json = JSON.parse(data);
+                        if (res.statusCode !== 200) {
+                            reject(new Error(`CryptoQuant API error: ${res.statusCode} ${json.message || ''}`));
+                        }
+                        else {
+                            resolve(json);
+                        }
+                    }
+                    catch (err) {
+                        reject(new Error(`Failed to parse CryptoQuant response: ${err}`));
+                    }
+                });
+            }).on('error', reject);
+        });
+    }
+    /**
+     * Private: Check rate limit
+     */
+    checkRateLimit() {
+        const today = new Date().toISOString().slice(0, 10);
+        if (today !== this.rateLimitState.lastResetDate) {
+            this.rateLimitState.requestsToday = 0;
+            this.rateLimitState.lastResetDate = today;
+        }
+        if (this.rateLimitState.requestsToday >= this.rateLimitPerDay) {
+            throw new Error(`[CryptoQuantAdapter] Rate limit exceeded: ${this.rateLimitPerDay} requests/day`);
+        }
+    }
+    /**
+     * Private: Record API call
+     */
+    recordApiCall() {
+        this.rateLimitState.requestsToday++;
+        console.log(`[CryptoQuantAdapter] API calls today: ${this.rateLimitState.requestsToday}/${this.rateLimitPerDay}`);
+    }
+    /**
+     * Private: Calculate variance for confidence
+     */
+    calculateVariance(values) {
+        if (values.length === 0)
+            return 0;
+        const mean = values.reduce((a, b) => a + b) / values.length;
+        const squaredDiffs = values.map(v => Math.pow(v - mean, 2));
+        const variance = squaredDiffs.reduce((a, b) => a + b) / values.length;
+        return Math.sqrt(variance); // Return standard deviation
+    }
+    /**
+     * Get current rate limit status
+     */
+    getRateLimitStatus() {
+        return {
+            used: this.rateLimitState.requestsToday,
+            limit: this.rateLimitPerDay,
+            remaining: Math.max(0, this.rateLimitPerDay - this.rateLimitState.requestsToday),
+        };
+    }
+}
+// Singleton Instance
+let adapterInstance = null;
+export function initCryptoQuantAdapter(config) {
+    adapterInstance = new CryptoQuantAdapter(config);
+    return adapterInstance;
+}
+export function getCryptoQuantAdapter() {
+    if (!adapterInstance) {
+        throw new Error('CryptoQuantAdapter not initialized. Call initCryptoQuantAdapter() first.');
+    }
+    return adapterInstance;
+}
+//# sourceMappingURL=cryptoQuantAdapter.js.map

package/dist/adapters/cryptoQuantAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cryptoQuantAdapter.js","sourceRoot":"","sources":["../../src/adapters/cryptoQuantAdapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/cursor.d.ts

@@ -0,0 +1,13 @@
+import type { CliAdapter, CliRunOptions, CliRunResult, AdapterCapabilities, ExecutorResult, ReviewResult } from '../adapters/types.js';
+export declare class CursorCliAdapter implements CliAdapter {
+    readonly name = "cursor";
+    readonly capabilities: AdapterCapabilities;
+    isAvailable(): Promise<boolean>;
+    buildCommand(options: CliRunOptions): {
+        command: string;
+        args: string[];
+    };
+    parseExecutorOutput(raw: CliRunResult): ExecutorResult;
+    parseReviewerOutput(raw: CliRunResult): ReviewResult;
+}
+//# sourceMappingURL=cursor.d.ts.map

package/dist/adapters/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/adapters/cursor.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,YAAY,EACb,MAAM,qBAAqB,CAAC;AAO7B,qBAAa,gBAAiB,YAAW,UAAU;IACjD,QAAQ,CAAC,IAAI,YAAY;IAEzB,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAMxC;IAEI,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;IASzE,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,cAAc;IAmBtD,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY;CAQrD"}

package/dist/adapters/cursor.js

@@ -0,0 +1,300 @@
+// ============================================
+// EnactFactory - Cursor CLI Adapter
+// Wraps `agent -p` for agent execution
+// ============================================
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { t } from '../locale/index.js';
+const execFileAsync = promisify(execFile);
+// Cursor CLI Adapter
+export class CursorCliAdapter {
+    name = 'cursor';
+    capabilities = {
+        supportsStreaming: false,
+        supportsJsonOutput: false,
+        supportsModelSelection: true,
+        managedGit: false,
+        supportedSkills: [],
+    };
+    async isAvailable() {
+        try {
+            await execFileAsync('which', ['agent']);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    buildCommand(options) {
+        const promptFile = options.prompt;
+        const model = options.model || 'auto';
+        const modelFlag = ` --model ${model}`;
+        // cursor command is `agent`
+        const cmd = `agent --trust -p "$(cat ${shellEscape(promptFile)})"${modelFlag}`;
+        return { command: cmd, args: [] };
+    }
+    parseExecutorOutput(raw) {
+        try {
+            const parsed = extractExecutorResultJson(raw.stdout);
+            if (parsed) {
+                return ensureExitCodeOutcome(parsed, raw.exitCode, raw.stderr);
+            }
+            const fallback = extractExecutorFromText(raw.stdout);
+            return ensureExitCodeOutcome(fallback, raw.exitCode, raw.stderr);
+        }
+        catch (error) {
+            console.error('[Executor] Parse error:', error);
+            return ensureExitCodeOutcome(extractExecutorFromText(raw.stdout), raw.exitCode, raw.stderr);
+        }
+    }
+    parseReviewerOutput(raw) {
+        try {
+            return extractReviewerResultJson(raw.stdout) || extractReviewerFromText(raw.stdout);
+        }
+        catch (error) {
+            console.error('[Reviewer] Parse error:', error);
+            return extractReviewerFromText(raw.stdout);
+        }
+    }
+}
+function shellEscape(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+// Executor Output Parsing
+function extractExecutorResultJson(text) {
+    const jsonMatch = text.match(/```json\s*([\s\S]*?)\s*```/);
+    if (!jsonMatch) {
+        const objMatch = text.match(/\{\s*"success"\s*:/);
+        if (!objMatch)
+            return null;
+        const startIdx = objMatch.index;
+        let depth = 0;
+        let endIdx = startIdx;
+        for (let i = startIdx; i < text.length; i++) {
+            if (text[i] === '{')
+                depth++;
+            if (text[i] === '}') {
+                depth--;
+                if (depth === 0) {
+                    endIdx = i + 1;
+                    break;
+                }
+            }
+        }
+        try {
+            const parsed = JSON.parse(text.slice(startIdx, endIdx));
+            return {
+                success: Boolean(parsed.success),
+                summary: parsed.summary || t('common.fallback.noSummary'),
+                filesChanged: Array.isArray(parsed.filesChanged) ? parsed.filesChanged : [],
+                commands: Array.isArray(parsed.commands) ? parsed.commands : [],
+                output: text,
+                error: parsed.error,
+                confidencePercent: typeof parsed.confidencePercent === 'number'
+                    ? parsed.confidencePercent : undefined,
+                haltReason: parsed.haltReason || undefined,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    try {
+        const parsed = JSON.parse(jsonMatch[1]);
+        return {
+            success: Boolean(parsed.success),
+            summary: parsed.summary || '(no summary)',
+            filesChanged: Array.isArray(parsed.filesChanged) ? parsed.filesChanged : [],
+            commands: Array.isArray(parsed.commands) ? parsed.commands : [],
+            output: text,
+            error: parsed.error,
+            confidencePercent: typeof parsed.confidencePercent === 'number'
+                ? parsed.confidencePercent : undefined,
+            haltReason: parsed.haltReason || undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function extractExecutorFromText(text) {
+    const isShortOutput = text.length < 500;
+    const hasError = /\b(?:error|fail(?:ed)?|exception|cannot|blocked|timeout)\b/i.test(text);
+    const hasCompletionToken = /<\|DONE\|>|‹DONE›|⟦DONE⟧/i.test(text);
+    const hasSuccess = hasCompletionToken || /\b(success|completed|done|finished)\b/i.test(text);
+    const filePatterns = [
+        /(?:changed?|modified?|created?|updated?):\s*(.+\.(?:ts|js|py|json|yaml|yml|md))/gi,
+        /(?:src|lib|test|tests)\/[\w/\-.]+\.(?:ts|js|py)/gi,
+    ];
+    const filesChanged = [];
+    for (const pattern of filePatterns) {
+        const matches = text.matchAll(pattern);
+        for (const m of matches) {
+            const file = m[1] || m[0];
+            if (!filesChanged.includes(file)) {
+                filesChanged.push(file);
+            }
+        }
+    }
+    const cmdPattern = /(?:`|\$)\s*((?:npm|pnpm|yarn|git|python|pytest|tsc|eslint)\s+[^\n`]+)/gi;
+    const commands = [];
+    const cmdMatches = text.matchAll(cmdPattern);
+    for (const m of cmdMatches) {
+        if (!commands.includes(m[1])) {
+            commands.push(m[1].trim());
+        }
+    }
+    return {
+        success: hasCompletionToken || (isShortOutput ? !hasError : hasSuccess),
+        summary: extractSummary(text),
+        filesChanged: filesChanged.slice(0, 10),
+        commands: commands.slice(0, 10),
+        output: text,
+        error: hasError ? extractErrorMessage(text) : undefined,
+    };
+}
+function ensureExitCodeOutcome(result, exitCode, stderr) {
+    if (exitCode === 0)
+        return result;
+    const stderrHint = stderr ? ` STDERR: ${stderr.trim()}` : '';
+    const existingError = result.error ? `${result.error}${stderrHint}` : `Process exited with code ${exitCode}${stderrHint}`;
+    return {
+        ...result,
+        success: false,
+        error: existingError || `Process exited with code ${exitCode}`,
+    };
+}
+function extractSummary(text) {
+    const lines = text.split('\n').filter((l) => l.trim().length > 10);
+    if (lines.length === 0)
+        return t('common.fallback.noSummary');
+    const summary = lines[0].trim();
+    return summary.length > 200 ? summary.slice(0, 200) + '...' : summary;
+}
+function extractErrorMessage(text) {
+    const errorMatch = text.match(/(?:error|exception|failed?):\s*(.+)/i);
+    if (errorMatch) {
+        return errorMatch[1].slice(0, 200);
+    }
+    const lines = text.split('\n').filter((l) => /error|fail/i.test(l));
+    if (lines.length > 0) {
+        return lines[0].slice(0, 200);
+    }
+    return 'Unknown error';
+}
+// Reviewer Output Parsing
+function extractReviewerResultJson(text) {
+    const jsonMatch = text.match(/```json\s*([\s\S]*?)\s*```/);
+    if (!jsonMatch) {
+        const objMatch = text.match(/\{\s*"decision"\s*:/);
+        if (!objMatch)
+            return null;
+        const startIdx = objMatch.index;
+        let depth = 0;
+        let endIdx = startIdx;
+        for (let i = startIdx; i < text.length; i++) {
+            if (text[i] === '{')
+                depth++;
+            if (text[i] === '}') {
+                depth--;
+                if (depth === 0) {
+                    endIdx = i + 1;
+                    break;
+                }
+            }
+        }
+        try {
+            const parsed = JSON.parse(text.slice(startIdx, endIdx));
+            return normalizeReviewResult(parsed);
+        }
+        catch {
+            return null;
+        }
+    }
+    try {
+        const parsed = JSON.parse(jsonMatch[1]);
+        return normalizeReviewResult(parsed);
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeReviewResult(parsed) {
+    let decision = 'revise';
+    if (['approve', 'revise', 'reject'].includes(parsed.decision)) {
+        decision = parsed.decision;
+    }
+    else if (parsed.decision) {
+        const normalized = parsed.decision.toLowerCase();
+        if (normalized.includes('approv') || normalized.includes('pass')) {
+            decision = 'approve';
+        }
+        else if (normalized.includes('reject') || normalized.includes('fail')) {
+            decision = 'reject';
+        }
+    }
+    return {
+        decision,
+        feedback: parsed.feedback || t('common.fallback.noFeedback'),
+        workItems: Array.isArray(parsed.workItems) ? parsed.workItems : [],
+        suggestions: Array.isArray(parsed.suggestions) ? parsed.suggestions : [],
+    };
+}
+function extractReviewerFromText(text) {
+    let decision = 'revise';
+    const lowerText = text.toLowerCase();
+    if (lowerText.includes('approve') || lowerText.includes('lgtm')) {
+        decision = 'approve';
+    }
+    else if (lowerText.includes('reject')) {
+        decision = 'reject';
+    }
+    else if (lowerText.includes('revise') || lowerText.includes('improve')) {
+        decision = 'revise';
+    }
+    const workItems = [];
+    const workItemPatterns = [
+        /(?:workItem|problem|error):\s*(.+)/gi,
+        /(?:missing):\s*(.+)/gi,
+        /- (?:fix|resolve):\s*(.+)/gi,
+    ];
+    for (const pattern of workItemPatterns) {
+        const matches = text.matchAll(pattern);
+        for (const m of matches) {
+            if (m[1] && !workItems.includes(m[1].trim())) {
+                workItems.push(m[1].trim().slice(0, 200));
+            }
+        }
+    }
+    const suggestions = [];
+    const suggestionPatterns = [
+        /(?:suggest|recommend):\s*(.+)/gi,
+        /(?:consider):\s*(.+)/gi,
+        /(?:should):\s*(.+)/gi,
+    ];
+    for (const pattern of suggestionPatterns) {
+        const matches = text.matchAll(pattern);
+        for (const m of matches) {
+            if (m[1] && !suggestions.includes(m[1].trim())) {
+                suggestions.push(m[1].trim().slice(0, 200));
+            }
+        }
+    }
+    return {
+        decision,
+        feedback: extractFeedback(text),
+        workItems: workItems.slice(0, 5),
+        suggestions: suggestions.slice(0, 5),
+    };
+}
+function extractFeedback(text) {
+    const lines = text.split('\n').filter((l) => {
+        const trimmed = l.trim();
+        return trimmed.length > 20 && !trimmed.startsWith('#') && !trimmed.startsWith('```');
+    });
+    if (lines.length === 0)
+        return t('common.fallback.noFeedback');
+    const feedback = lines[0].trim();
+    return feedback.length > 300 ? feedback.slice(0, 300) + '...' : feedback;
+}
+//# sourceMappingURL=cursor.js.map

package/dist/adapters/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/adapters/cursor.ts"],"names":[],"mappings":"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"}

package/dist/adapters/envPath.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Resolve EnactFactory's bundled `node_modules/.bin` directory.
+ *
+ * envPath.js lives at `<pkg>/dist/adapters/envPath.js` after build, so the
+ * package root is two directories up. During `npm run dev` / `tsx`, the file
+ * is at `<pkg>/src/adapters/envPath.ts` — same relative structure.
+ *
+ * Returns null if the .bin directory does not exist (e.g. dev checkout
+ * without `npm install`), so callers can fall back to process.env.PATH as-is.
+ */
+export declare function getBundledBinDir(): string | null;
+/**
+ * Build an env object for spawned executors with EnactFactory's bundled `.bin`
+ * directory prepended to PATH. Keeps every other env var untouched.
+ *
+ * Prepending (not appending) means a locally-bundled `cxt` wins over an
+ * older global install, which matters when we start pinning cxt versions.
+ */
+export declare function buildExecutorEnv(base?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+//# sourceMappingURL=envPath.d.ts.map

package/dist/adapters/envPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envPath.d.ts","sourceRoot":"","sources":["../../src/adapters/envPath.ts"],"names":[],"mappings":"AAcA;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAKhD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,UAAU,CAazF"}

package/dist/adapters/envPath.js

@@ -0,0 +1,49 @@
+// ============================================
+// EnactFactory - Executor environment PATH helper
+// ============================================
+//
+// Executors spawned by EnactFactory need access to bundled CLI dependencies
+// (notably `cxt` from @intrect/cxt) without the user having them installed
+// globally. We inject EnactFactory's own `node_modules/.bin` into PATH for the
+// spawned process only — user's shell PATH and ~/.claude/* are untouched.
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { delimiter } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Resolve EnactFactory's bundled `node_modules/.bin` directory.
+ *
+ * envPath.js lives at `<pkg>/dist/adapters/envPath.js` after build, so the
+ * package root is two directories up. During `npm run dev` / `tsx`, the file
+ * is at `<pkg>/src/adapters/envPath.ts` — same relative structure.
+ *
+ * Returns null if the .bin directory does not exist (e.g. dev checkout
+ * without `npm install`), so callers can fall back to process.env.PATH as-is.
+ */
+export function getBundledBinDir() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pkgRoot = resolve(here, '..', '..');
+    const binDir = join(pkgRoot, 'node_modules', '.bin');
+    return existsSync(binDir) ? binDir : null;
+}
+/**
+ * Build an env object for spawned executors with EnactFactory's bundled `.bin`
+ * directory prepended to PATH. Keeps every other env var untouched.
+ *
+ * Prepending (not appending) means a locally-bundled `cxt` wins over an
+ * older global install, which matters when we start pinning cxt versions.
+ */
+export function buildExecutorEnv(base = process.env) {
+    const binDir = getBundledBinDir();
+    if (binDir === null)
+        return { ...base };
+    const existingPath = base.PATH ?? base.Path ?? '';
+    // Avoid duplicate entries if this env is reused across spawns.
+    const parts = existingPath.split(delimiter).filter(Boolean);
+    if (parts[0] === binDir) {
+        return { ...base };
+    }
+    const nextPath = [binDir, ...parts.filter((p) => p !== binDir)].join(delimiter);
+    return { ...base, PATH: nextPath };
+}
+//# sourceMappingURL=envPath.js.map