@cleocode/cleo 2026.2.5

package/dist/core/compliance/index.js

@@ -0,0 +1,229 @@
+/**
+ * Compliance metrics core module.
+ * @task T4535
+ * @epic T4454
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { getManifestPath as getManifestPathFromPaths } from '../paths.js';
+// CleoError and ExitCode available if needed for future error cases
+function getCleoDir(cwd) {
+    return join(cwd ?? process.cwd(), '.cleo');
+}
+function readJsonlFile(filePath) {
+    if (!existsSync(filePath))
+        return [];
+    const content = readFileSync(filePath, 'utf-8').trim();
+    if (!content)
+        return [];
+    return content.split('\n').map(line => JSON.parse(line));
+}
+/** Get compliance summary. */
+export async function getComplianceSummary(opts) {
+    const compliancePath = join(getCleoDir(opts.cwd), 'metrics', 'COMPLIANCE.jsonl');
+    let entries = readJsonlFile(compliancePath);
+    if (opts.since) {
+        entries = entries.filter(e => e.timestamp >= opts.since);
+    }
+    if (opts.agent) {
+        entries = entries.filter(e => e.source_id === opts.agent);
+    }
+    const totalEntries = entries.length;
+    const compliance = entries.map(e => (e.compliance ?? {}));
+    const avgPassRate = totalEntries > 0
+        ? compliance.reduce((sum, c) => sum + (c.compliance_pass_rate ?? 0), 0) / totalEntries
+        : 0;
+    const avgAdherence = totalEntries > 0
+        ? compliance.reduce((sum, c) => sum + (c.rule_adherence_score ?? 0), 0) / totalEntries
+        : 0;
+    const totalViolations = compliance.reduce((sum, c) => sum + (c.violation_count ?? 0), 0);
+    return {
+        totalEntries,
+        averagePassRate: Math.round(avgPassRate * 1000) / 1000,
+        averageAdherence: Math.round(avgAdherence * 1000) / 1000,
+        totalViolations,
+    };
+}
+/** List compliance violations. */
+export async function listComplianceViolations(opts) {
+    const compliancePath = join(getCleoDir(opts.cwd), 'metrics', 'COMPLIANCE.jsonl');
+    let entries = readJsonlFile(compliancePath);
+    entries = entries.filter(e => {
+        const c = (e.compliance ?? {});
+        return (c.violation_count ?? 0) > 0;
+    });
+    if (opts.severity) {
+        entries = entries.filter(e => {
+            const c = (e.compliance ?? {});
+            return c.violation_severity === opts.severity;
+        });
+    }
+    if (opts.since) {
+        entries = entries.filter(e => e.timestamp >= opts.since);
+    }
+    if (opts.agent) {
+        entries = entries.filter(e => e.source_id === opts.agent);
+    }
+    const violations = entries.map(e => {
+        const c = (e.compliance ?? {});
+        const ctx = (e._context ?? {});
+        return {
+            timestamp: e.timestamp,
+            agentId: e.source_id,
+            taskId: ctx.task_id,
+            violationCount: c.violation_count,
+            severity: c.violation_severity,
+            passRate: c.compliance_pass_rate,
+        };
+    });
+    return { violations, totalCount: violations.length };
+}
+/** Get compliance trend. */
+export async function getComplianceTrend(days = 7, cwd) {
+    const compliancePath = join(getCleoDir(cwd), 'metrics', 'COMPLIANCE.jsonl');
+    const entries = readJsonlFile(compliancePath);
+    const cutoff = new Date(Date.now() - days * 86400000).toISOString();
+    const filtered = entries.filter(e => e.timestamp >= cutoff);
+    // Group by date
+    const byDate = {};
+    for (const e of filtered) {
+        const date = e.timestamp.split('T')[0];
+        if (!byDate[date])
+            byDate[date] = [];
+        byDate[date].push(e);
+    }
+    const dataPoints = Object.entries(byDate)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([date, dayEntries]) => {
+        const compliance = dayEntries.map(e => (e.compliance ?? {}));
+        return {
+            date,
+            entries: dayEntries.length,
+            avgPassRate: compliance.reduce((s, c) => s + (c.compliance_pass_rate ?? 0), 0) / dayEntries.length,
+            avgAdherence: compliance.reduce((s, c) => s + (c.rule_adherence_score ?? 0), 0) / dayEntries.length,
+            violations: compliance.reduce((s, c) => s + (c.violation_count ?? 0), 0),
+        };
+    });
+    let trend = 'no_data';
+    if (dataPoints.length >= 2) {
+        const first = dataPoints[0].avgPassRate;
+        const last = dataPoints[dataPoints.length - 1].avgPassRate;
+        trend = last > first ? 'improving' : last < first ? 'declining' : 'stable';
+    }
+    return { days, trend, dataPoints };
+}
+/** Audit epic compliance. */
+export async function auditEpicCompliance(epicId, opts) {
+    const compliancePath = join(getCleoDir(opts.cwd), 'metrics', 'COMPLIANCE.jsonl');
+    const entries = readJsonlFile(compliancePath);
+    const epicEntries = entries.filter(e => {
+        const ctx = (e._context ?? {});
+        return ctx.epic_id === epicId || ctx.task_id === epicId;
+    });
+    const taskIds = [...new Set(epicEntries.map(e => {
+            const ctx = (e._context ?? {});
+            return ctx.task_id;
+        }))];
+    const compliance = epicEntries.map(e => (e.compliance ?? {}));
+    const avgPassRate = epicEntries.length > 0
+        ? compliance.reduce((s, c) => s + (c.compliance_pass_rate ?? 0), 0) / epicEntries.length
+        : 0;
+    const totalViolations = compliance.reduce((s, c) => s + (c.violation_count ?? 0), 0);
+    return {
+        epicId,
+        taskCount: taskIds.length,
+        entriesAnalyzed: epicEntries.length,
+        summary: { averagePassRate: avgPassRate, totalViolations },
+    };
+}
+/** Sync compliance metrics to global. */
+export async function syncComplianceMetrics(_opts) {
+    return { synced: 0, skipped: 0, message: 'Sync not yet implemented in V2' };
+}
+/** Get skill reliability stats. */
+export async function getSkillReliability(opts) {
+    const compliancePath = join(getCleoDir(opts.cwd), 'metrics', 'COMPLIANCE.jsonl');
+    const entries = readJsonlFile(compliancePath);
+    const byAgent = {};
+    for (const e of entries) {
+        const agentId = e.source_id ?? 'unknown';
+        if (!byAgent[agentId])
+            byAgent[agentId] = { count: 0, passRateSum: 0, violations: 0 };
+        const stats = byAgent[agentId];
+        const c = (e.compliance ?? {});
+        stats.count++;
+        stats.passRateSum += c.compliance_pass_rate ?? 0;
+        stats.violations += c.violation_count ?? 0;
+    }
+    const skills = Object.entries(byAgent).map(([id, stats]) => ({
+        agentId: id,
+        totalChecks: stats.count,
+        avgPassRate: stats.count > 0 ? Math.round((stats.passRateSum / stats.count) * 1000) / 1000 : 0,
+        totalViolations: stats.violations,
+    }));
+    return { skills, total: skills.length };
+}
+/** Get value metrics (T2833). */
+export async function getValueMetrics(days = 7, cwd) {
+    const cleoDir = getCleoDir(cwd);
+    const compliancePath = join(cleoDir, 'metrics', 'COMPLIANCE.jsonl');
+    const manifestPath = getManifestPathFromPaths(cwd);
+    let manifestEntries = 0;
+    if (existsSync(manifestPath)) {
+        const content = readFileSync(manifestPath, 'utf-8').trim();
+        manifestEntries = content ? content.split('\n').length : 0;
+    }
+    const manifestTokens = manifestEntries * 200;
+    const fullFileTokens = manifestEntries * 2000;
+    const tokenSavings = fullFileTokens - manifestTokens;
+    const savingsPercent = fullFileTokens > 0
+        ? Math.round((tokenSavings / fullFileTokens) * 100)
+        : 0;
+    let totalValidations = 0;
+    let violationsCaught = 0;
+    let realValidations = 0;
+    if (existsSync(compliancePath)) {
+        const entries = readJsonlFile(compliancePath);
+        totalValidations = entries.length;
+        violationsCaught = entries.filter(e => {
+            const c = (e.compliance ?? {});
+            return (c.violation_count ?? 0) > 0;
+        }).length;
+        realValidations = entries.filter(e => {
+            const ctx = (e._context ?? {});
+            return ctx.validation_score !== undefined;
+        }).length;
+    }
+    const violationRate = totalValidations > 0
+        ? Math.round((violationsCaught / totalValidations) * 100)
+        : 0;
+    const otelEnabled = process.env.CLAUDE_CODE_ENABLE_TELEMETRY === '1';
+    return {
+        periodDays: days,
+        tokenEfficiency: {
+            manifestEntries,
+            manifestTokens,
+            fullFileEquivalent: fullFileTokens,
+            tokensSaved: tokenSavings,
+            savingsPercent,
+            verdict: savingsPercent >= 80 ? 'Excellent'
+                : savingsPercent >= 50 ? 'Good'
+                    : savingsPercent >= 20 ? 'Moderate'
+                        : 'Low',
+        },
+        validationImpact: {
+            totalValidations,
+            violationsCaught,
+            violationRatePercent: violationRate,
+            realValidations,
+            status: realValidations > 0 ? 'Active' : 'Legacy (upgrade to real validation)',
+        },
+        telemetry: {
+            otelEnabled,
+            recommendation: otelEnabled
+                ? 'Token tracking active'
+                : 'Enable CLAUDE_CODE_ENABLE_TELEMETRY=1 for real token data',
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/core/compliance/index.js.map

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

package/dist/core/config.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Configuration engine for CLEO V2.
+ *
+ * Resolution priority: CLI flags > Environment vars > Project config > Global config > Defaults
+ *
+ * @epic T4454
+ * @task T4458
+ */
+import type { CleoConfig, ResolvedValue } from '../types/config.js';
+/**
+ * Load and merge configuration from all sources.
+ * Priority: defaults < global config < project config < environment vars
+ */
+export declare function loadConfig(cwd?: string): Promise<CleoConfig>;
+/**
+ * Get a single config value with source tracking.
+ * Returns the value and which source it came from.
+ */
+export declare function getConfigValue<T>(path: string, cwd?: string): Promise<ResolvedValue<T>>;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAgB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAuHlF;;;GAGG;AACH,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAyBlE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAgC3B"}

package/dist/core/config.js

@@ -0,0 +1,179 @@
+/**
+ * Configuration engine for CLEO V2.
+ *
+ * Resolution priority: CLI flags > Environment vars > Project config > Global config > Defaults
+ *
+ * @epic T4454
+ * @task T4458
+ */
+import { readJson } from '../store/json.js';
+import { getConfigPath, getGlobalConfigPath } from './paths.js';
+/** Default configuration values. */
+const DEFAULTS = {
+    version: '2.10.0',
+    output: {
+        defaultFormat: 'json',
+        showColor: true,
+        showUnicode: true,
+        showProgressBars: true,
+        dateFormat: 'relative',
+    },
+    backup: {
+        maxOperationalBackups: 10,
+        maxSafetyBackups: 5,
+        compressionEnabled: false,
+    },
+    hierarchy: {
+        maxDepth: 3,
+        maxSiblings: 7,
+        cascadeDelete: false,
+    },
+    session: {
+        autoStart: false,
+        requireNotes: false,
+        multiSession: false,
+    },
+    lifecycle: {
+        mode: 'strict',
+    },
+};
+/** Environment variable to config path mapping. */
+const ENV_MAP = {
+    'CLEO_FORMAT': 'output.defaultFormat',
+    'CLEO_OUTPUT_DEFAULT_FORMAT': 'output.defaultFormat',
+    'CLEO_OUTPUT_SHOW_COLOR': 'output.showColor',
+    'CLEO_OUTPUT_SHOW_UNICODE': 'output.showUnicode',
+    'CLEO_OUTPUT_SHOW_PROGRESS_BARS': 'output.showProgressBars',
+    'CLEO_OUTPUT_DATE_FORMAT': 'output.dateFormat',
+    'CLEO_HIERARCHY_MAX_DEPTH': 'hierarchy.maxDepth',
+    'CLEO_HIERARCHY_MAX_SIBLINGS': 'hierarchy.maxSiblings',
+    'CLEO_SESSION_AUTO_START': 'session.autoStart',
+    'CLEO_SESSION_REQUIRE_NOTES': 'session.requireNotes',
+    'CLEO_LIFECYCLE_MODE': 'lifecycle.mode',
+};
+/**
+ * Get a value at a dotted path from an object.
+ */
+function getNestedValue(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Set a value at a dotted path in an object (mutates).
+ */
+function setNestedValue(obj, path, value) {
+    const parts = path.split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (current[part] === undefined || typeof current[part] !== 'object') {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+/**
+ * Deep merge two objects. Source values override target values.
+ * Arrays are replaced (not merged).
+ */
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        const sourceVal = source[key];
+        const targetVal = result[key];
+        if (sourceVal !== null &&
+            typeof sourceVal === 'object' &&
+            !Array.isArray(sourceVal) &&
+            targetVal !== null &&
+            typeof targetVal === 'object' &&
+            !Array.isArray(targetVal)) {
+            result[key] = deepMerge(targetVal, sourceVal);
+        }
+        else {
+            result[key] = sourceVal;
+        }
+    }
+    return result;
+}
+/**
+ * Parse an environment variable value to the appropriate type.
+ */
+function parseEnvValue(value) {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    const num = Number(value);
+    if (!isNaN(num) && value.trim() !== '')
+        return num;
+    return value;
+}
+/**
+ * Load and merge configuration from all sources.
+ * Priority: defaults < global config < project config < environment vars
+ */
+export async function loadConfig(cwd) {
+    // Start with defaults
+    let merged = JSON.parse(JSON.stringify(DEFAULTS));
+    // Layer 1: Global config
+    const globalConfig = await readJson(getGlobalConfigPath());
+    if (globalConfig) {
+        merged = deepMerge(merged, globalConfig);
+    }
+    // Layer 2: Project config
+    const projectConfig = await readJson(getConfigPath(cwd));
+    if (projectConfig) {
+        merged = deepMerge(merged, projectConfig);
+    }
+    // Layer 3: Environment variables
+    for (const [envKey, configPath] of Object.entries(ENV_MAP)) {
+        const envValue = process.env[envKey];
+        if (envValue !== undefined) {
+            setNestedValue(merged, configPath, parseEnvValue(envValue));
+        }
+    }
+    return merged;
+}
+/**
+ * Get a single config value with source tracking.
+ * Returns the value and which source it came from.
+ */
+export async function getConfigValue(path, cwd) {
+    // Check environment variables first
+    for (const [envKey, configPath] of Object.entries(ENV_MAP)) {
+        if (configPath === path && process.env[envKey] !== undefined) {
+            return {
+                value: parseEnvValue(process.env[envKey]),
+                source: 'env',
+            };
+        }
+    }
+    // Check project config
+    const projectConfig = await readJson(getConfigPath(cwd));
+    if (projectConfig) {
+        const val = getNestedValue(projectConfig, path);
+        if (val !== undefined) {
+            return { value: val, source: 'project' };
+        }
+    }
+    // Check global config
+    const globalConfig = await readJson(getGlobalConfigPath());
+    if (globalConfig) {
+        const val = getNestedValue(globalConfig, path);
+        if (val !== undefined) {
+            return { value: val, source: 'global' };
+        }
+    }
+    // Fall back to defaults
+    const defaultVal = getNestedValue(DEFAULTS, path);
+    return { value: defaultVal, source: 'default' };
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/context/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Context window monitoring core module.
+ * @task T4535
+ * @epic T4454
+ */
+/** Get context status. */
+export declare function getContextStatus(opts: {
+    session?: string;
+    cwd?: string;
+}): Promise<Record<string, unknown>>;
+/** Check context threshold (returns exit code info). */
+export declare function checkContextThreshold(opts: {
+    session?: string;
+    cwd?: string;
+}): Promise<Record<string, unknown> & {
+    exitCode?: number;
+}>;
+/** List all context state files. */
+export declare function listContextSessions(cwd?: string): Promise<Record<string, unknown>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/context/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA+BH,0BAA0B;AAC1B,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAmCnC;AAED,wDAAwD;AACxD,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA+B3D;AAED,oCAAoC;AACpC,wBAAsB,mBAAmB,CACvC,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA4ClC"}

package/dist/core/context/index.js

@@ -0,0 +1,137 @@
+/**
+ * Context window monitoring core module.
+ * @task T4535
+ * @epic T4454
+ */
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
+import { join, basename } from 'node:path';
+function getCleoDir(cwd) {
+    return join(cwd ?? process.cwd(), '.cleo');
+}
+function getStateFile(session, cwd) {
+    const cleoDir = getCleoDir(cwd);
+    if (session) {
+        const sessionFile = join(cleoDir, 'context-states', `context-state-${session}.json`);
+        if (existsSync(sessionFile))
+            return sessionFile;
+    }
+    // Check for current session binding
+    const currentSessionFile = join(cleoDir, '.current-session');
+    if (existsSync(currentSessionFile)) {
+        const currentSession = readFileSync(currentSessionFile, 'utf-8').trim();
+        if (currentSession) {
+            const sessionFile = join(cleoDir, 'context-states', `context-state-${currentSession}.json`);
+            if (existsSync(sessionFile))
+                return sessionFile;
+        }
+    }
+    // Fall back to global state file
+    return join(cleoDir, '.context-state.json');
+}
+/** Get context status. */
+export async function getContextStatus(opts) {
+    const stateFile = getStateFile(opts.session, opts.cwd);
+    if (!existsSync(stateFile)) {
+        return {
+            available: false,
+            message: 'No context state file',
+            hint: 'Ensure status line integration is configured',
+        };
+    }
+    const state = JSON.parse(readFileSync(stateFile, 'utf-8'));
+    const timestamp = state.timestamp;
+    const staleMs = state.staleAfterMs ?? 5000;
+    const percentage = state.contextWindow?.percentage ?? 0;
+    const current = state.contextWindow?.currentTokens ?? 0;
+    const max = state.contextWindow?.maxTokens ?? 0;
+    let status = state.status ?? 'unknown';
+    // Check staleness
+    const fileTime = new Date(timestamp).getTime();
+    const now = Date.now();
+    if ((now - fileTime) > staleMs) {
+        status = 'stale';
+    }
+    return {
+        available: true,
+        status,
+        percentage,
+        currentTokens: current,
+        maxTokens: max,
+        timestamp,
+        stale: status === 'stale',
+    };
+}
+/** Check context threshold (returns exit code info). */
+export async function checkContextThreshold(opts) {
+    const stateFile = getStateFile(opts.session, opts.cwd);
+    if (!existsSync(stateFile)) {
+        return { status: 'stale', exitCode: 54 };
+    }
+    const state = JSON.parse(readFileSync(stateFile, 'utf-8'));
+    const timestamp = state.timestamp;
+    const staleMs = state.staleAfterMs ?? 5000;
+    let status = state.status ?? 'unknown';
+    const fileTime = new Date(timestamp).getTime();
+    if ((Date.now() - fileTime) > staleMs) {
+        status = 'stale';
+    }
+    const exitCodeMap = {
+        ok: 0,
+        warning: 50,
+        caution: 51,
+        critical: 52,
+        emergency: 53,
+        stale: 54,
+    };
+    return {
+        status,
+        percentage: state.contextWindow?.percentage ?? 0,
+        exitCode: exitCodeMap[status] ?? 54,
+    };
+}
+/** List all context state files. */
+export async function listContextSessions(cwd) {
+    const cleoDir = getCleoDir(cwd);
+    const sessions = [];
+    // Check canonical directory
+    const statesDir = join(cleoDir, 'context-states');
+    if (existsSync(statesDir)) {
+        for (const file of readdirSync(statesDir)) {
+            if (file.startsWith('context-state-') && file.endsWith('.json')) {
+                const filePath = join(statesDir, file);
+                try {
+                    const state = JSON.parse(readFileSync(filePath, 'utf-8'));
+                    sessions.push({
+                        file: basename(filePath),
+                        sessionId: state.sessionId ?? null,
+                        percentage: state.contextWindow?.percentage ?? 0,
+                        status: state.status ?? 'unknown',
+                        timestamp: state.timestamp,
+                    });
+                }
+                catch {
+                    // skip invalid files
+                }
+            }
+        }
+    }
+    // Check singleton fallback
+    const singletonFile = join(cleoDir, '.context-state.json');
+    if (existsSync(singletonFile)) {
+        try {
+            const state = JSON.parse(readFileSync(singletonFile, 'utf-8'));
+            sessions.push({
+                file: '.context-state.json',
+                sessionId: state.sessionId ?? 'global',
+                percentage: state.contextWindow?.percentage ?? 0,
+                status: state.status ?? 'unknown',
+                timestamp: state.timestamp,
+            });
+        }
+        catch {
+            // skip
+        }
+    }
+    return { sessions, count: sessions.length };
+}
+//# sourceMappingURL=index.js.map

package/dist/core/context/index.js.map

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