@neurcode-ai/cli 0.14.0 → 0.15.1

package/dist/utils/runtime-companion.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RUNTIME_COMPANION_SCHEMA_VERSION = void 0;
+exports.invalidateRuntimeCompanionFreshness = invalidateRuntimeCompanionFreshness;
+exports.buildRuntimeCompanionSnapshot = buildRuntimeCompanionSnapshot;
+exports.approveRuntimeCompanionPath = approveRuntimeCompanionPath;
+exports.refreshRuntimeCompanionProfile = refreshRuntimeCompanionProfile;
+exports.runtimeCompanionSession = runtimeCompanionSession;
+const governance_runtime_1 = require("@neurcode-ai/governance-runtime");
+const v0_governance_1 = require("./v0-governance");
+const agent_session_launcher_1 = require("./agent-session-launcher");
+const runtime_outbox_1 = require("./runtime-outbox");
+const runtime_connection_1 = require("./runtime-connection");
+exports.RUNTIME_COMPANION_SCHEMA_VERSION = 'neurcode.runtime-companion.v1';
+const PROFILE_FRESHNESS_CACHE_MS = 5_000;
+const freshnessCache = new Map();
+function pendingAmendments(session) {
+    return (session.contract.planAmendmentProposals ?? [])
+        .filter((proposal) => proposal.status === 'pending')
+        .map((proposal) => ({
+        proposalId: proposal.proposalId,
+        action: proposal.action,
+        proposedBy: proposal.proposedBy,
+        reason: proposal.reason,
+        riskLevel: proposal.risk.level,
+        addedFiles: [...proposal.risk.addedFiles],
+        addedGlobs: [...proposal.risk.addedGlobs],
+        removedConstraints: [...proposal.risk.removedConstraints],
+        createdAt: proposal.createdAt,
+    }));
+}
+function shapePlan(session) {
+    const plan = session.contract.agentPlan;
+    if (!plan)
+        return null;
+    return {
+        revision: session.contract.agentPlanRevision ?? 1,
+        summary: plan.summary,
+        steps: [...plan.steps],
+        expectedFiles: [...plan.expectedFiles],
+        expectedGlobs: [...plan.expectedGlobs],
+        constraints: [...plan.constraints],
+        risks: [...plan.risks],
+        capturedAt: plan.capturedAt,
+        source: plan.source,
+        confidence: plan.confidence,
+        pendingAmendments: pendingAmendments(session),
+    };
+}
+function shapeWaivers(waivers) {
+    return waivers.map((waiver) => ({
+        obligationId: waiver.obligationId,
+        reason: waiver.reason,
+        waivedAt: waiver.waivedAt,
+        expiresAt: waiver.expiresAt,
+        waivedBy: waiver.waivedBy,
+    }));
+}
+function shapeObligations(session) {
+    const items = session.contract.architectureObligations ?? [];
+    const waivers = (0, governance_runtime_1.activeArchitectureObligationWaivers)(session.contract.architectureObligationWaivers ?? []);
+    return {
+        policy: (0, governance_runtime_1.normalizeArchitectureObligationPolicy)(session.contract.architectureObligationPolicy),
+        summary: (0, governance_runtime_1.summarizeArchitectureObligations)(items),
+        items: items.map((item) => ({
+            id: item.id,
+            category: item.category,
+            title: item.title,
+            description: item.description,
+            severity: item.severity,
+            status: item.status,
+            requiredEvidence: [...item.requiredEvidence],
+            observedEvidence: item.observedEvidence.map((evidence) => ({ ...evidence })),
+            ...(item.requiredPath ? { requiredPath: item.requiredPath } : {}),
+            ...(item.effectiveMode ? { effectiveMode: item.effectiveMode } : {}),
+        })),
+        activeWaivers: shapeWaivers(waivers),
+    };
+}
+function extractApprovalContext(event) {
+    const raw = event.detail?.approvalContext;
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return {
+            owners: [],
+            suggestedApprovalPath: event.filePath ?? '',
+        };
+    }
+    const context = raw;
+    return {
+        owners: Array.isArray(context.owners)
+            ? context.owners.filter((owner) => typeof owner === 'string')
+            : [],
+        suggestedApprovalPath: typeof context.suggestedApprovalPath === 'string'
+            ? context.suggestedApprovalPath
+            : (typeof context.blockedPath === 'string' ? context.blockedPath : event.filePath ?? ''),
+    };
+}
+function shapeLatestBlock(session) {
+    const block = [...session.events].reverse().find((event) => event.type === 'check_block');
+    if (!block?.filePath)
+        return null;
+    const context = extractApprovalContext(block);
+    return {
+        filePath: block.filePath,
+        message: block.message ?? 'Edit is blocked by an approval-required boundary.',
+        owners: context.owners,
+        suggestedApprovalPath: context.suggestedApprovalPath || block.filePath,
+        exactPathApproved: (0, governance_runtime_1.activeApprovalPaths)(session.contract).includes(context.suggestedApprovalPath || block.filePath),
+    };
+}
+function shapeRecentEvents(session) {
+    return session.events.slice(-20).map((event) => ({
+        type: event.type,
+        ts: event.ts,
+        ...(event.filePath ? { filePath: event.filePath } : {}),
+        ...(event.verdict ? { verdict: event.verdict } : {}),
+        ...(event.decision ? { decision: event.decision } : {}),
+        ...(event.message ? { message: event.message } : {}),
+    }));
+}
+function shapeLauncher(session) {
+    const state = (0, agent_session_launcher_1.latestAgentLauncherState)(session);
+    if (!state)
+        return null;
+    return {
+        agent: state.agent.normalized,
+        adapter: state.agent.adapter,
+        enforcementLevel: state.agent.enforcementLevel,
+        automatic: state.agent.automatic,
+        hardDeny: state.agent.hardDeny,
+        handshakeStatus: state.handshakeStatus,
+        ...(state.launchedAt ? { launchedAt: state.launchedAt } : {}),
+        ...(state.promptSeenAt ? { promptSeenAt: state.promptSeenAt } : {}),
+    };
+}
+function freshnessFor(repoRoot, session, force) {
+    const cached = freshnessCache.get(repoRoot);
+    if (!force && cached && cached.expiresAt > Date.now())
+        return cached.signal;
+    const staleness = (0, v0_governance_1.getProfileStaleness)(repoRoot);
+    const action = (0, v0_governance_1.profileFreshnessActionForSession)(staleness, session?.profileHash);
+    const signal = (0, v0_governance_1.buildProfileFreshnessSignal)(staleness, action);
+    freshnessCache.set(repoRoot, { expiresAt: Date.now() + PROFILE_FRESHNESS_CACHE_MS, signal });
+    return signal;
+}
+function invalidateRuntimeCompanionFreshness(repoRoot) {
+    freshnessCache.delete(repoRoot);
+}
+function buildRuntimeCompanionSnapshot(repoRoot, options = {}) {
+    const session = (0, governance_runtime_1.loadActiveSession)(repoRoot);
+    const profileFreshness = freshnessFor(repoRoot, session, options.forceFreshness === true);
+    const transport = (0, runtime_outbox_1.inspectRuntimeOutbox)(repoRoot);
+    return {
+        schemaVersion: exports.RUNTIME_COMPANION_SCHEMA_VERSION,
+        generatedAt: new Date().toISOString(),
+        repoRoot,
+        privacy: {
+            metadataOnly: true,
+            sourceIncluded: false,
+            sourceUploaded: false,
+        },
+        enforcement: {
+            adapter: 'vscode-extension',
+            level: 'observe_only',
+            automatic: false,
+            hardDenyAvailable: false,
+            detail: 'The VS Code companion reflects CLI runtime state. Claude Code hooks provide pre-write hard deny; editor observation does not.',
+        },
+        profileFreshness: {
+            ...profileFreshness,
+            sessionProfileHash: session?.profileHash ?? null,
+        },
+        transport: {
+            ...transport,
+            connected: Boolean((0, runtime_connection_1.loadRuntimeConnection)(repoRoot)),
+        },
+        session: session
+            ? {
+                sessionId: session.sessionId,
+                status: session.status,
+                repoName: session.repoName,
+                goal: session.contract.goal,
+                profileHash: session.profileHash,
+                scopeMode: session.contract.scopeMode,
+                planCoherenceMode: session.contract.planCoherenceMode ?? 'warn',
+                allowedGlobs: [...session.contract.allowedGlobs],
+                approvalRequiredGlobs: [...session.contract.approvalRequiredGlobs],
+                approvedPaths: (0, governance_runtime_1.activeApprovalPaths)(session.contract),
+                launcher: shapeLauncher(session),
+                plan: shapePlan(session),
+                obligations: shapeObligations(session),
+                latestBlock: shapeLatestBlock(session),
+                recentEvents: shapeRecentEvents(session),
+            }
+            : null,
+    };
+}
+function approveRuntimeCompanionPath(repoRoot, input) {
+    if (!input.path?.trim())
+        throw new Error('path is required');
+    if (!input.reason?.trim())
+        throw new Error('reason is required');
+    if (/[*?[\]{}!]/.test(input.path)) {
+        throw new Error('VS Code runtime companion approvals must target one exact file path.');
+    }
+    const approval = (0, governance_runtime_1.approveSession)(repoRoot, input.path.trim(), {
+        reason: input.reason.trim(),
+        sessionId: input.sessionId,
+        source: 'vscode',
+        approvedBy: input.approvedBy ?? null,
+        requestId: input.requestId ?? null,
+    });
+    invalidateRuntimeCompanionFreshness(repoRoot);
+    return {
+        schemaVersion: exports.RUNTIME_COMPANION_SCHEMA_VERSION,
+        sessionId: approval.sessionId,
+        approvedPath: approval.approvedPath,
+        eventId: approval.eventId,
+        expiresAt: approval.expiresAt,
+        snapshot: buildRuntimeCompanionSnapshot(repoRoot, { forceFreshness: true }),
+    };
+}
+function refreshRuntimeCompanionProfile(repoRoot) {
+    (0, v0_governance_1.ensureFreshGovernanceProfile)(repoRoot, { force: true });
+    invalidateRuntimeCompanionFreshness(repoRoot);
+    return buildRuntimeCompanionSnapshot(repoRoot, { forceFreshness: true });
+}
+function runtimeCompanionSession(repoRoot, sessionId) {
+    return (0, governance_runtime_1.loadSession)(repoRoot, sessionId);
+}
+//# sourceMappingURL=runtime-companion.js.map

package/dist/utils/runtime-companion.js.map

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

package/dist/utils/runtime-connection.d.ts

@@ -0,0 +1,46 @@
+import type { ProfileFreshnessSignal } from './v0-governance';
+export interface RuntimeConnection {
+    schemaVersion: 1;
+    apiUrl: string;
+    organizationId: string;
+    projectId?: string | null;
+    repo: {
+        id: string;
+        name: string;
+        repoKey: string;
+    };
+    profileHash?: string;
+    topologyHash?: string;
+    keyPrefix?: string;
+    connectedAt: string;
+    autoSync: {
+        enabled: boolean;
+        lastQueuedAt?: string;
+        lastAttemptAt?: string;
+        lastSyncedAt?: string;
+        lastStatus?: 'queued' | 'ok' | 'failed' | 'skipped';
+        lastUploaded?: number;
+        lastSkipped?: number;
+        lastFailed?: number;
+        lastError?: string;
+    };
+}
+export interface RuntimeRepoMetadata {
+    name: string;
+    rootHash: string;
+    remoteHash?: string;
+    profileHash?: string;
+    topologyHash?: string;
+    profileFreshness?: ProfileFreshnessSignal;
+    source: 'local';
+}
+export declare function runtimeConnectionPath(repoRoot: string): string;
+export declare function collectRuntimeRepoMetadata(repoRoot: string, profileFreshness?: ProfileFreshnessSignal): RuntimeRepoMetadata;
+export declare function loadRuntimeConnection(repoRoot: string): RuntimeConnection | null;
+export declare function saveRuntimeConnection(repoRoot: string, connection: RuntimeConnection): void;
+export declare function updateRuntimeConnection(repoRoot: string, update: (connection: RuntimeConnection) => RuntimeConnection): RuntimeConnection | null;
+export declare function triggerRuntimeAutoSync(repoRoot: string): {
+    started: boolean;
+    reason?: string;
+};
+//# sourceMappingURL=runtime-connection.d.ts.map

package/dist/utils/runtime-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-connection.d.ts","sourceRoot":"","sources":["../../src/utils/runtime-connection.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,CAAC,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC;QACpD,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,MAAM,EAAE,OAAO,CAAC;CACjB;AAQD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9D;AA2CD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,sBAAsB,GACxC,mBAAmB,CAgBrB;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAMhF;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAG3F;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,UAAU,EAAE,iBAAiB,KAAK,iBAAiB,GAC3D,iBAAiB,GAAG,IAAI,CAM1B;AAOD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CA+CA"}

package/dist/utils/runtime-connection.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runtimeConnectionPath = runtimeConnectionPath;
+exports.collectRuntimeRepoMetadata = collectRuntimeRepoMetadata;
+exports.loadRuntimeConnection = loadRuntimeConnection;
+exports.saveRuntimeConnection = saveRuntimeConnection;
+exports.updateRuntimeConnection = updateRuntimeConnection;
+exports.triggerRuntimeAutoSync = triggerRuntimeAutoSync;
+const child_process_1 = require("child_process");
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const gitignore_1 = require("./gitignore");
+const CONNECTION_FILE = 'connection.json';
+function connectionDir(repoRoot) {
+    return (0, path_1.join)(repoRoot, '.neurcode');
+}
+function runtimeConnectionPath(repoRoot) {
+    return (0, path_1.join)(connectionDir(repoRoot), CONNECTION_FILE);
+}
+function readJsonFile(path) {
+    try {
+        if (!(0, fs_1.existsSync)(path))
+            return null;
+        return JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function sha256(input) {
+    return (0, crypto_1.createHash)('sha256').update(input).digest('hex').slice(0, 32);
+}
+function gitValue(repoRoot, args) {
+    try {
+        const value = (0, child_process_1.execFileSync)('git', args, {
+            cwd: repoRoot,
+            stdio: ['ignore', 'pipe', 'ignore'],
+            encoding: 'utf8',
+        }).trim();
+        return value || null;
+    }
+    catch {
+        return null;
+    }
+}
+function ensureConnectionDir(repoRoot) {
+    const dir = connectionDir(repoRoot);
+    if (!(0, fs_1.existsSync)(dir)) {
+        (0, fs_1.mkdirSync)(dir, { recursive: true });
+    }
+    (0, gitignore_1.ensureNeurcodeInGitignore)(repoRoot);
+}
+function runtimeSafeProfileFreshness(signal) {
+    return {
+        ...signal,
+        profilePath: '.neurcode/profile.json',
+    };
+}
+function collectRuntimeRepoMetadata(repoRoot, profileFreshness) {
+    const profile = readJsonFile((0, path_1.join)(repoRoot, '.neurcode', 'profile.json'));
+    const remote = gitValue(repoRoot, ['config', '--get', 'remote.origin.url']);
+    const repoName = typeof profile?.repo?.name === 'string' && profile.repo.name.trim()
+        ? profile.repo.name.trim()
+        : (0, path_1.basename)(repoRoot);
+    return {
+        name: repoName,
+        rootHash: sha256(repoRoot),
+        remoteHash: remote ? sha256(remote) : undefined,
+        profileHash: typeof profile?.profileHash === 'string' ? profile.profileHash : undefined,
+        topologyHash: typeof profile?.topology?.hash === 'string' ? profile.topology.hash : undefined,
+        ...(profileFreshness ? { profileFreshness: runtimeSafeProfileFreshness(profileFreshness) } : {}),
+        source: 'local',
+    };
+}
+function loadRuntimeConnection(repoRoot) {
+    const data = readJsonFile(runtimeConnectionPath(repoRoot));
+    if (!data || data.schemaVersion !== 1)
+        return null;
+    if (typeof data.apiUrl !== 'string' || typeof data.organizationId !== 'string')
+        return null;
+    if (!data.repo || typeof data.repo !== 'object')
+        return null;
+    return data;
+}
+function saveRuntimeConnection(repoRoot, connection) {
+    ensureConnectionDir(repoRoot);
+    (0, fs_1.writeFileSync)(runtimeConnectionPath(repoRoot), JSON.stringify(connection, null, 2) + '\n', 'utf8');
+}
+function updateRuntimeConnection(repoRoot, update) {
+    const current = loadRuntimeConnection(repoRoot);
+    if (!current)
+        return null;
+    const next = update(current);
+    saveRuntimeConnection(repoRoot, next);
+    return next;
+}
+function envFlag(value) {
+    if (!value)
+        return false;
+    return ['1', 'true', 'yes', 'on'].includes(value.trim().toLowerCase());
+}
+function triggerRuntimeAutoSync(repoRoot) {
+    const connection = loadRuntimeConnection(repoRoot);
+    if (!connection)
+        return { started: false, reason: 'not connected' };
+    if (!connection.autoSync?.enabled)
+        return { started: false, reason: 'disabled' };
+    if (envFlag(process.env.NEURCODE_DISABLE_AUTO_SYNC))
+        return { started: false, reason: 'disabled by env' };
+    if (envFlag(process.env.NEURCODE_AUTO_SYNC_CHILD))
+        return { started: false, reason: 'already in sync child' };
+    const cliEntry = process.argv[1];
+    if (!cliEntry)
+        return { started: false, reason: 'missing cli entrypoint' };
+    updateRuntimeConnection(repoRoot, (current) => ({
+        ...current,
+        autoSync: {
+            ...current.autoSync,
+            enabled: current.autoSync?.enabled !== false,
+            lastQueuedAt: new Date().toISOString(),
+            lastStatus: 'queued',
+            lastError: undefined,
+        },
+    }));
+    if (envFlag(process.env.NEURCODE_AUTO_SYNC_DRY_RUN)) {
+        return { started: true, reason: 'dry run' };
+    }
+    const child = (0, child_process_1.spawn)(process.execPath, [
+        cliEntry,
+        'sync',
+        '--runtime',
+        '--dir',
+        repoRoot,
+        '--json',
+    ], {
+        cwd: repoRoot,
+        detached: true,
+        stdio: 'ignore',
+        env: {
+            ...process.env,
+            NEURCODE_AUTO_SYNC_CHILD: '1',
+        },
+    });
+    child.unref();
+    return { started: true };
+}
+//# sourceMappingURL=runtime-connection.js.map

package/dist/utils/runtime-connection.js.map

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

package/dist/utils/runtime-evidence.d.ts

@@ -0,0 +1,68 @@
+import { type GovernanceSession } from '@neurcode-ai/governance-runtime';
+export interface LocalGovernanceSessionRecord {
+    session: GovernanceSession;
+    path: string;
+    startedAt: string | null;
+    blockCount: number;
+    warnCount: number;
+    okCount: number;
+    approvalCount: number;
+}
+export interface RuntimeEvidenceReport {
+    repoRoot: string;
+    generatedAt: string;
+    since: string | null;
+    profile: {
+        status: string;
+        profilePath: string;
+        reasons: string[];
+    };
+    summary: {
+        sessions: number;
+        activeSessions: number;
+        finishedSessions: number;
+        totalChecks: number;
+        blockedEdits: number;
+        warnedSensitiveEdits: number;
+        allowedWithAdvisories: number;
+        allowedEdits: number;
+        approvalsGranted: number;
+    };
+    topBlockedPaths: Array<{
+        path: string;
+        count: number;
+    }>;
+    topOwners: Array<{
+        owner: string;
+        count: number;
+    }>;
+    approvalRequiredBoundariesTouched: Array<{
+        boundary: string;
+        count: number;
+    }>;
+    sessions: Array<{
+        sessionId: string;
+        status: GovernanceSession['status'];
+        goal: string;
+        scopeMode: GovernanceSession['contract']['scopeMode'];
+        blockCount: number;
+        warnCount: number;
+        okCount: number;
+        approvalCount: number;
+        approvedPaths: string[];
+        replayHash?: string;
+        recordPath: string;
+    }>;
+}
+export declare function parseSinceDuration(input?: string): {
+    cutoffMs: number | null;
+    label: string | null;
+};
+export declare function listRuntimeSessions(repoRoot: string, options?: {
+    since?: string;
+}): LocalGovernanceSessionRecord[];
+export declare function buildRuntimeEvidenceReport(repoRoot: string, options?: {
+    since?: string;
+}): RuntimeEvidenceReport;
+export declare function renderRuntimeEvidenceMarkdown(report: RuntimeEvidenceReport): string;
+//# sourceMappingURL=runtime-evidence.d.ts.map

package/dist/utils/runtime-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-evidence.d.ts","sourceRoot":"","sources":["../../src/utils/runtime-evidence.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,iBAAiB,EAEvB,MAAM,iCAAiC,CAAC;AAGzC,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,qBAAqB,EAAE,MAAM,CAAC;QAC9B,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,eAAe,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,iCAAiC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,QAAQ,EAAE,KAAK,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC;QACtD,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ;AAyED,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAgBpG;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,4BAA4B,EAAE,CA+BhC;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,qBAAqB,CAsEvB;AASD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CA4CnF"}