mikrojs 0.0.0 → 0.0.8

package/dist/cli/lib/session.js

@@ -0,0 +1,490 @@
+/**
+ * ReplSession — transport-agnostic protocol session.
+ *
+ * Usage:
+ *   const session = connectRepl(transport)
+ *   session.messages$.subscribe(event => ...)
+ *   session.eval('1+1')
+ *   await session.deploy(files, envVars)
+ *   session.close()
+ */
+import { createHash } from 'node:crypto';
+import { decode as decodeCbor } from 'cbor2';
+import { catchError, concat, filter, finalize, first, firstValueFrom, from, ignoreElements, map, merge, mergeMap, of, share, shareReplay, switchMap, tap, timeout, timer, } from 'rxjs';
+import { checkFirmwareCompat } from './firmwareCompat.js';
+import { buildCompleteCommand, buildConfigDeleteCommand, buildConfigListCommand, buildConfigSetCommand, buildDeployAbortCommand, buildDeployChecksumCommand, buildDeployDoneCommand, buildDeployEraseCommand, buildDeployKeepCommand, buildDeployPutChunkCommand, buildDeployPutCommand, buildDirectiveCommand, buildEvalCommand, buildExitCommand, buildHelloCommand, buildRestartCommand, buildRuntimePauseCommand, buildRuntimeResumeCommand, FrameParser, frameToMessage, parseCompletions, } from './protocol.js';
+function isResponseEvent(event) {
+    return (event.type === 'ok' ||
+        event.type === 'err' ||
+        event.type === 'checksum_result' ||
+        event.type === 'config_entries');
+}
+// ── Checksums manifest ─────────────────────────────────────────────
+const CHECKSUMS_PATH = '/app/.checksums';
+function buildChecksumsManifest(hashes) {
+    const lines = [];
+    for (const [name, hash] of hashes) {
+        lines.push(`${hash.toString('hex')}  ${name}\n`);
+    }
+    return Buffer.from(lines.join(''));
+}
+// ── connectRepl ────────────────────────────────────────────────────
+/** Window for MSG_READY after CMD_RESTART. A healthy reboot is <1s, but
+ * CMD_RESTART itself only gets serviced when the device's JS thread
+ * yields — and apps doing display/modem work can block it for several
+ * seconds. 10s accommodates both without hanging forever on a wedged
+ * device. Callers can override via `DeployOptions.timeout`. */
+const READY_TIMEOUT_MS = 10_000;
+const RESPONSE_TIMEOUT_MS = 30_000;
+/** How often awaitReady$ re-sends CMD_HELLO while waiting for MSG_READY.
+ * The device replies immediately, so a single HELLO normally suffices.
+ * Polling exists to cover (a) the post-restart window where the transport
+ * is down or the device is mid-reboot and (b) connections established
+ * before the device's protocol mode is up. */
+const HELLO_POLL_INTERVAL_MS = 250;
+/** Timeout for protocol commands whose on-device work is near-instant
+ * (pause, resume) but whose handler is interleaved with JS. The budget
+ * isn't for the command itself — it's for the longest plausible
+ * blocking JS native call (display SPI, flash write, etc.) that can
+ * delay the next handler tick. */
+const JS_YIELD_TIMEOUT_MS = 10_000;
+/** Body bytes per CMD_DEPLOY_PUT_CHUNK frame. Sized so a single TLV frame
+ * (5-byte header + body) stays well below the device's USJ RX ring with
+ * room for the next command's header to land alongside it. Larger chunks
+ * trade per-chunk round-trip cost against the risk of overrun on devices
+ * with smaller rings — 2 KB is the sweet spot for both the ESP32 USJ peripheral
+ * (RX 4 KB) and any plausible UART path. */
+const PUT_CHUNK_SIZE = 2048;
+function formatTimeoutError(context, timeoutMs) {
+    return new Error(`${context}: device did not respond within ${timeoutMs}ms — it may be unplugged, wedged in a long JS operation, or (outside dev mode) in deep sleep`);
+}
+export function connectRepl(transport, _connectOptions = {}) {
+    const frameParser = new FrameParser();
+    let sub;
+    // Buffer for raw (non-protocol) bytes so we only emit complete lines.
+    let rawLineBuf = '';
+    // Core observable: transport bytes → parsed ReplEvents (shared/hot).
+    // Emits a 'disconnect' event when the transport completes, then completes.
+    const messages$ = concat(transport.data.pipe(mergeMap((chunk) => {
+        const { frames, raw } = frameParser.feed(Buffer.from(chunk));
+        const events = [];
+        if (raw) {
+            rawLineBuf += raw.toString('utf-8');
+            // Emit only complete lines; keep the trailing partial for later
+            const lastNewline = rawLineBuf.lastIndexOf('\n');
+            if (lastNewline !== -1) {
+                const complete = rawLineBuf.slice(0, lastNewline).trim();
+                rawLineBuf = rawLineBuf.slice(lastNewline + 1);
+                if (complete)
+                    events.push({ type: 'raw', text: complete });
+            }
+        }
+        for (const frame of frames) {
+            const event = frameToEvent(frame);
+            if (event)
+                events.push(event);
+        }
+        return events;
+    }), finalize(() => {
+        frameParser.flush();
+        rawLineBuf = '';
+    })), [{ type: 'disconnect' }]).pipe(share());
+    // Keep the pipeline alive (shared observables need at least one subscriber)
+    sub = messages$.subscribe();
+    // ready$: emits each time the device sends MSG_READY (after boot or restart).
+    // Tagged with a sequence number AND arrival timestamp so awaitReady$ can
+    // distinguish a genuinely post-restart ready from one that pre-dates the
+    // reboot. After `session.restart()`, two failure modes need filtering:
+    //   1. The previously-cached MSG_READY replayed by shareReplay (caught by
+    //      sequence number — restart() snapshots the current seq).
+    //   2. A pre-restart MSG_READY that was already in the OS read buffer or
+    //      otherwise in flight when restart() ran, so it arrives shortly
+    //      *after* the seq snapshot but is still from the pre-reboot device
+    //      state. The sequence check passes for these, but the timestamp
+    //      doesn't: a real post-reboot MSG_READY arrives at least one boot
+    //      cycle (~500 ms) later. We require a 1 s blackout to be safe.
+    // Both conditions together prevent deploy from sending CMD_RUNTIME_PAUSE
+    // while the device is still rebooting (which lands during the USB-CDC
+    // re-enumeration window and gets dropped).
+    let readySeq = 0;
+    let lastSeenRestartSeq = -1;
+    let lastRestartAt = 0;
+    const POST_RESTART_BLACKOUT_MS = 1000;
+    const readyWithMeta$ = messages$.pipe(filter((e) => e.type === 'ready'), map((e) => ({ event: e, seq: ++readySeq, arrivedAt: Date.now() })), shareReplay(1));
+    // Eagerly subscribe so shareReplay captures ready events
+    sub.add(readyWithMeta$.subscribe());
+    const ready$ = readyWithMeta$.pipe(map(({ event }) => event));
+    // Response stream: OK, ERR, CHECKSUM_RESULT, CONFIG_ENTRIES
+    const responses$ = messages$.pipe(filter(isResponseEvent));
+    /** Send a command and wait for the next response event. Wraps any
+     * timeout with a message naming the step, so a user seeing a
+     * generic rxjs TimeoutError gets context instead. */
+    async function sendAndWait(frame, context, timeoutMs = RESPONSE_TIMEOUT_MS) {
+        const response = firstValueFrom(responses$.pipe(first(), timeout(timeoutMs)));
+        await transport.write(frame);
+        try {
+            return await response;
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'TimeoutError') {
+                throw formatTimeoutError(context, timeoutMs);
+            }
+            throw err;
+        }
+    }
+    /** Send a command and expect MSG_OK. Throws on MSG_ERR or timeout.
+     *  Returns the OK payload so callers can inspect extra bytes (e.g. the
+     *  changed/existed flag returned by CONFIG_SET / CONFIG_DELETE). */
+    async function sendExpectOk(frame, context, timeoutMs) {
+        const resp = await sendAndWait(frame, context, timeoutMs);
+        if (resp.type === 'err') {
+            throw new Error(`${context}: ${resp.message}`);
+        }
+        if (resp.type !== 'ok') {
+            throw new Error(`${context}: unexpected response type '${resp.type}'`);
+        }
+        return resp.payload;
+    }
+    /** Stream a file to the device as one CMD_DEPLOY_PUT (begin) followed by
+     *  one or more CMD_DEPLOY_PUT_CHUNK frames. Each frame awaits MSG_OK
+     *  before the next is sent so the device's RX ring can never overrun
+     *  regardless of file size. Empty files are valid: BEGIN with size=0
+     *  closes the file immediately and no chunks are sent. */
+    async function streamPutFile(path, data) {
+        await sendExpectOk(buildDeployPutCommand(path, data.length), `deploy put '${path}'`);
+        for (let offset = 0; offset < data.length; offset += PUT_CHUNK_SIZE) {
+            const chunk = data.subarray(offset, offset + PUT_CHUNK_SIZE);
+            await sendExpectOk(buildDeployPutChunkCommand(chunk), `deploy put chunk '${path}' @${offset}`);
+        }
+    }
+    /**
+     * Wait for device to be ready. Emits the ReadyEvent, then completes.
+     * Errors if the device firmware version is incompatible.
+     */
+    function awaitReady$(timeoutMs = READY_TIMEOUT_MS) {
+        const checkVersion = (event) => {
+            const compat = checkFirmwareCompat(event.version);
+            if (!compat.compatible) {
+                const got = compat.deviceVersion ?? 'unknown';
+                throw new Error(`Device firmware (v${got}) is incompatible with this CLI (requires ${compat.requiredRange}). Reflash with \`npm run flash\`.`);
+            }
+        };
+        const mapTimeout = (context, ms) => catchError((err) => {
+            if (err instanceof Error && err.name === 'TimeoutError') {
+                throw formatTimeoutError(context, ms);
+            }
+            throw err;
+        });
+        // The device only sends MSG_READY in response to CMD_HELLO, so poll
+        // HELLO at a steady interval until a ready arrives. The first tick fires
+        // immediately. Best-effort writes: during the post-restart USB-CDC
+        // re-enumeration window the transport may reject — swallow and retry on
+        // the next tick.
+        const hello$ = timer(0, HELLO_POLL_INTERVAL_MS).pipe(tap(() => {
+            transport.write(buildHelloCommand()).catch(() => { });
+        }), ignoreElements());
+        // Wait for a ready event whose sequence number is newer than the one
+        // captured at the most recent `session.restart()` call. This skips any
+        // cached pre-restart ready that shareReplay would otherwise replay, so
+        // we don't proceed to send commands while the device is still in the
+        // middle of rebooting.
+        const ready$ = readyWithMeta$.pipe(filter(({ seq, arrivedAt }) => seq > lastSeenRestartSeq && arrivedAt >= lastRestartAt + POST_RESTART_BLACKOUT_MS), map(({ event }) => event));
+        return merge(hello$, ready$).pipe(first(), timeout(timeoutMs), mapTimeout('waiting for device ready', timeoutMs), tap(checkVersion));
+    }
+    /** Promise version for config operations */
+    async function awaitReady() {
+        await firstValueFrom(awaitReady$());
+    }
+    // ── Deploy ─────────────────────────────────────────────────────
+    function deploy(options) {
+        const readyTimeoutMs = options.timeout ?? READY_TIMEOUT_MS;
+        return concat(of({ type: 'connecting' }), awaitReady$(readyTimeoutMs).pipe(switchMap(() => from(deployAfterReady(options)))));
+    }
+    async function* deployAfterReady(options) {
+        const { files, envVars = [], force = false, erase = false, restart: shouldRestart = true, alwaysRestart = false, } = options;
+        // Freeze the device's JS runtime so user code can't interleave log
+        // output (raw or MSG_LOG) with deploy traffic during the checksum and
+        // upload phases. The device already pauses internally on the first
+        // deploy command, but that leaves a brief window before the first
+        // command arrives; sending PAUSE explicitly up front closes it.
+        // A reboot implicitly resumes; otherwise we send RESUME in the finally
+        // block. `didRestart` (not `shouldRestart`) drives that decision because
+        // the no-op/abort branch skips the restart even when shouldRestart=true.
+        await sendExpectOk(buildRuntimePauseCommand(), 'runtime pause', JS_YIELD_TIMEOUT_MS);
+        let didRestart = false;
+        try {
+            // Compute local hashes
+            const localHashes = new Map();
+            for (const file of files) {
+                localHashes.set(file.path, createHash('sha256').update(file.data).digest());
+            }
+            const filesToPut = [];
+            const filesToKeep = [];
+            // With erase, the checksum-based KEEP optimization is unsafe: erase wipes
+            // the live appDir before KEEP operations copy from it, so any file marked
+            // KEEP would silently drop out of the deploy. Force all files to PUT.
+            if (force || erase) {
+                filesToPut.push(...files);
+            }
+            else {
+                // Checksum-based incremental deploy
+                let checksumSupported = true;
+                for (let i = 0; i < files.length; i++) {
+                    const file = files[i];
+                    yield { type: 'checking', file: file.path, index: i, total: files.length };
+                    if (!checksumSupported) {
+                        filesToPut.push(file);
+                        continue;
+                    }
+                    const hash = localHashes.get(file.path);
+                    const resp = await sendAndWait(buildDeployChecksumCommand(file.path, hash), `deploy checksum '${file.path}'`);
+                    if (resp.type === 'err') {
+                        checksumSupported = false;
+                        filesToPut.push(file);
+                        filesToKeep.length = 0;
+                        continue;
+                    }
+                    if (resp.type === 'checksum_result' && resp.match) {
+                        filesToKeep.push(file.path);
+                    }
+                    else {
+                        filesToPut.push(file);
+                    }
+                }
+            }
+            // Env vars: diff against current device state so we only mutate
+            // actual differences. Firmware reports per-entry changed/existed bits,
+            // giving the CLI a definitive "did anything change" signal without
+            // any local caching.
+            const envChanged = [];
+            const envRemoved = [];
+            if (envVars.length > 0) {
+                const tooLong = envVars.filter((v) => Buffer.byteLength(v.key, 'utf-8') > 15);
+                if (tooLong.length > 0) {
+                    throw new Error(`Env key(s) exceed NVS 15-char limit: ${tooLong.map((v) => v.key).join(', ')}`);
+                }
+                const deviceEntries = await config.list();
+                const desiredKeys = new Set(envVars.map((v) => v.key));
+                for (const v of envVars) {
+                    const payload = await sendExpectOk(buildConfigSetCommand(v.key, v.value, v.secret), `config set '${v.key}'`);
+                    if (payload.length > 0 && payload[0] === 1)
+                        envChanged.push(v.key);
+                }
+                for (const entry of deviceEntries) {
+                    if (desiredKeys.has(entry.key))
+                        continue;
+                    const payload = await sendExpectOk(buildConfigDeleteCommand(entry.key), `config delete '${entry.key}'`);
+                    if (payload.length > 0 && payload[0] === 1)
+                        envRemoved.push(entry.key);
+                }
+            }
+            const envActuallyChanged = envChanged.length > 0 || envRemoved.length > 0;
+            const hasChanges = filesToPut.length > 0 || envActuallyChanged || erase;
+            // Nothing changed: abort. Restart anyway when the caller asked for
+            // it via alwaysRestart (mikro test wants a fresh runtime per run
+            // even when files+env are unchanged, so the supervisor re-picks up
+            // the manifest from a clean boot).
+            if (!hasChanges) {
+                await sendExpectOk(buildDeployAbortCommand(), 'deploy abort');
+                if (shouldRestart && alwaysRestart) {
+                    yield { type: 'restarting' };
+                    lastSeenRestartSeq = readySeq;
+                    lastRestartAt = Date.now();
+                    await transport.write(buildRestartCommand());
+                    didRestart = true;
+                }
+                yield { type: 'complete', deployed: false, stats: { put: 0, kept: filesToKeep.length } };
+                return;
+            }
+            if (envActuallyChanged) {
+                yield { type: 'env_changed', changed: envChanged, removed: envRemoved };
+            }
+            // Erase
+            if (erase) {
+                await sendExpectOk(buildDeployEraseCommand(), 'deploy erase');
+            }
+            // KEEP unchanged files
+            for (const filePath of filesToKeep) {
+                await sendExpectOk(buildDeployKeepCommand(filePath), `deploy keep '${filePath}'`);
+            }
+            // PUT changed/new files
+            for (let i = 0; i < filesToPut.length; i++) {
+                const file = filesToPut[i];
+                yield { type: 'uploading', file: file.path, index: i, total: filesToPut.length };
+                await streamPutFile(file.path, file.data);
+            }
+            // PUT checksums manifest — but only if we actually have files to track.
+            // Otherwise an empty-files + erase deploy would write a stub .checksums
+            // file back into /app and defeat the erase.
+            if (filesToPut.length > 0 || filesToKeep.length > 0) {
+                const manifest = buildChecksumsManifest(localHashes);
+                await streamPutFile(CHECKSUMS_PATH, manifest);
+            }
+            // Finalize
+            await sendExpectOk(buildDeployDoneCommand(), 'deploy done');
+            if (shouldRestart) {
+                yield { type: 'restarting' };
+                lastSeenRestartSeq = readySeq;
+                lastRestartAt = Date.now();
+                await transport.write(buildRestartCommand());
+                didRestart = true;
+            }
+            yield {
+                type: 'complete',
+                deployed: true,
+                stats: { put: filesToPut.length, kept: filesToKeep.length },
+            };
+        }
+        finally {
+            // If we didn't actually restart (no-op abort, thrown error, or
+            // shouldRestart=false), the runtime is still paused on the device.
+            // Resume it so the user's app keeps running. Best-effort: a dropped
+            // transport leaves the session_end hook to resume anyway.
+            if (!didRestart) {
+                try {
+                    await sendExpectOk(buildRuntimeResumeCommand(), 'runtime resume', JS_YIELD_TIMEOUT_MS);
+                }
+                catch {
+                    // Transport likely gone; session_end on device will resume.
+                }
+            }
+        }
+    }
+    // ── Erase app ──────────────────────────────────────────────────
+    /** Erase the deployed app without going through the full deploy flow.
+     * Sends CMD_DEPLOY_ERASE + CMD_DEPLOY_DONE directly, so the device wipes
+     * /appfs/app and the DONE handler's stamp_checksums_manifest() silently
+     * no-ops because /appfs/app no longer exists. Nothing gets staged or
+     * written back. Optionally restarts the device afterwards. */
+    async function eraseApp(options = {}) {
+        const { restart: shouldRestart = true } = options;
+        await awaitReady();
+        await sendExpectOk(buildDeployEraseCommand(), 'deploy erase');
+        await sendExpectOk(buildDeployDoneCommand(), 'deploy done');
+        if (shouldRestart) {
+            lastSeenRestartSeq = readySeq;
+            lastRestartAt = Date.now();
+            await transport.write(buildRestartCommand());
+        }
+    }
+    // ── Config ─────────────────────────────────────────────────────
+    const config = {
+        async list() {
+            await awaitReady();
+            const resp = await sendAndWait(buildConfigListCommand(), 'config list');
+            if (resp.type === 'err')
+                throw new Error(`config list: ${resp.message}`);
+            if (resp.type === 'config_entries')
+                return resp.entries;
+            throw new Error(`config list: unexpected response type '${resp.type}'`);
+        },
+        async set(key, value, secret) {
+            await awaitReady();
+            await sendExpectOk(buildConfigSetCommand(key, value, secret), `config set '${key}'`);
+        },
+        async delete(key) {
+            await awaitReady();
+            await sendExpectOk(buildConfigDeleteCommand(key), `config delete '${key}'`);
+        },
+    };
+    // ── Public API ─────────────────────────────────────────────────
+    return {
+        messages$,
+        ready$,
+        awaitReady$,
+        eval(code) {
+            void transport.write(buildEvalCommand(code));
+        },
+        directive(name) {
+            void transport.write(buildDirectiveCommand(name));
+        },
+        complete(partial) {
+            void transport.write(buildCompleteCommand(partial));
+        },
+        exit() {
+            void transport.write(buildExitCommand());
+        },
+        deploy,
+        eraseApp,
+        config,
+        restart() {
+            // Mark the current ready cache as stale so the next awaitReady$
+            // skips it and waits for a fresh post-restart MSG_READY.
+            lastSeenRestartSeq = readySeq;
+            lastRestartAt = Date.now();
+            void transport.write(buildRestartCommand());
+        },
+        close() {
+            sub?.unsubscribe();
+            sub = undefined;
+            frameParser.flush();
+        },
+    };
+}
+// ── Frame → Event mapping ──────────────────────────────────────────
+function frameToEvent(frame) {
+    const msg = frameToMessage(frame);
+    if (!msg)
+        return null;
+    switch (msg.type) {
+        case 'ready': {
+            let chip = null;
+            let id = null;
+            let version = null;
+            try {
+                const info = decodeCbor(msg.payload);
+                chip = info.chip ?? null;
+                id = info.id ?? null;
+                version = info.v ?? null;
+            }
+            catch {
+                // ignore
+            }
+            return { type: 'ready', chip, id, version };
+        }
+        case 'log':
+        case 'warn':
+        case 'error':
+        case 'info':
+        case 'debug':
+        case 'result':
+        case 'eval_error':
+            return { type: msg.type, text: msg.payload.toString('utf-8') };
+        case 'completions': {
+            const result = parseCompletions(msg.payload);
+            return result ? { type: 'completions', result } : null;
+        }
+        case 'prompt':
+            return { type: 'prompt', timing: msg.payload.toString('utf-8') };
+        case 'ok':
+            return { type: 'ok', payload: msg.payload };
+        case 'err':
+            return { type: 'err', message: msg.payload.toString('utf-8') };
+        case 'checksum_result':
+            return { type: 'checksum_result', match: msg.payload.length > 0 && msg.payload[0] === 1 };
+        case 'config_entries': {
+            let entries = [];
+            try {
+                entries = decodeCbor(msg.payload);
+            }
+            catch {
+                // ignore
+            }
+            return { type: 'config_entries', entries };
+        }
+        case 'test': {
+            try {
+                const data = JSON.parse(msg.payload.toString('utf-8'));
+                return { type: 'test', data };
+            }
+            catch {
+                return null;
+            }
+        }
+        case 'manifest_done':
+            return { type: 'manifest_done' };
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/cli/lib/session.js.map

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

package/dist/cli/lib/simConfig.d.ts

@@ -0,0 +1,15 @@
+import type { MikroJSConfig } from '../../_exports/index.js';
+export interface ResolvedSimConfig {
+    memLimit: number;
+    fsLimit: number;
+    fsRoot: string;
+    /** Resolved fs_read_max in bytes. Undefined means "use runtime default". */
+    fsReadMax: number | undefined;
+}
+export declare function resolveSimConfig(config: MikroJSConfig | null): ResolvedSimConfig;
+/**
+ * Convenience: walk up from `startDir` (or cwd) looking for `mikro.config.ts`,
+ * then resolve the sim section with defaults filled in.
+ */
+export declare function loadSimConfig(startDir?: string): Promise<ResolvedSimConfig>;
+//# sourceMappingURL=simConfig.d.ts.map

package/dist/cli/lib/simConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simConfig.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/simConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,yBAAyB,CAAA;AAK1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;CAC9B;AAKD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,iBAAiB,CAShF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAGjF"}

package/dist/cli/lib/simConfig.js

@@ -0,0 +1,25 @@
+import * as pathlib from 'node:path';
+import { loadMikroConfig } from './loadMikroConfig.js';
+import { parseSize } from './parseSize.js';
+import { getMikroDir } from './projectRoot.js';
+const DEFAULT_MEM_LIMIT = 300 * 1024;
+const DEFAULT_FS_LIMIT = 1024 * 1024;
+export function resolveSimConfig(config) {
+    const sim = config?.sim ?? {};
+    return {
+        memLimit: sim.memLimit !== undefined ? parseSize(sim.memLimit) : DEFAULT_MEM_LIMIT,
+        fsLimit: sim.fsLimit !== undefined ? parseSize(sim.fsLimit) : DEFAULT_FS_LIMIT,
+        fsRoot: sim.fsRoot ?? pathlib.join(getMikroDir(), 'sim-fs'),
+        // fsReadMax is a top-level option (applies on device and sim alike).
+        fsReadMax: config?.fsReadMax !== undefined ? parseSize(config.fsReadMax) : undefined,
+    };
+}
+/**
+ * Convenience: walk up from `startDir` (or cwd) looking for `mikro.config.ts`,
+ * then resolve the sim section with defaults filled in.
+ */
+export async function loadSimConfig(startDir) {
+    const config = await loadMikroConfig(startDir ?? process.cwd());
+    return resolveSimConfig(config);
+}
+//# sourceMappingURL=simConfig.js.map

package/dist/cli/lib/simConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simConfig.js","sourceRoot":"","sources":["../../../src/cli/lib/simConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,WAAW,CAAA;AAGpC,OAAO,EAAC,eAAe,EAAC,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAA;AACxC,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAA;AAU5C,MAAM,iBAAiB,GAAG,GAAG,GAAG,IAAI,CAAA;AACpC,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAA;AAEpC,MAAM,UAAU,gBAAgB,CAAC,MAA4B;IAC3D,MAAM,GAAG,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,CAAA;IAC7B,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,iBAAiB;QAClF,OAAO,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,gBAAgB;QAC9E,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC;QAC3D,qEAAqE;QACrE,SAAS,EAAE,MAAM,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;KACrF,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAiB;IACnD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IAC/D,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAA;AACjC,CAAC"}

package/dist/cli/lib/simPid.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Pid file management for the simulator.
+ *
+ * One sim process at a time per project. Long-lived commands (`mikro sim dev`,
+ * `mikro sim repl`) claim the pid file and kill any predecessor. Short-lived
+ * commands (`mikro sim deploy`, `mikro sim test`, etc.) check the pid file
+ * and refuse to run if a sim is already alive — they would race on sim-fs
+ * writes or yank files out from under the running process.
+ */
+export declare function isAlive(pid: number): boolean;
+export declare function readPid(mikroDir: string): number | null;
+export declare function clearPid(mikroDir: string): void;
+export declare class SimAlreadyRunningError extends Error {
+    pid: number;
+    constructor(pid: number);
+}
+/**
+ * Refuse to proceed if a sim is already running. Used by short-lived commands
+ * (deploy, test, env, profile, clean, reset).
+ */
+export declare function checkPid(mikroDir: string): void;
+/**
+ * Claim the pid file for this process. If a predecessor is alive, kill it
+ * first (SIGTERM, then SIGKILL after a short grace period). Registers exit
+ * cleanup to remove the file on normal termination.
+ *
+ * Used by long-lived commands (dev, repl).
+ */
+export declare function claimPid(mikroDir: string): Promise<void>;
+//# sourceMappingURL=simPid.d.ts.map

package/dist/cli/lib/simPid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simPid.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/simPid.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ5C;AAED,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBvD;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAO/C;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,GAAG,EAAE,MAAM,CAAA;gBACC,GAAG,EAAE,MAAM;CAOxB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAG/C;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkC9D"}