mikrojs 0.0.0 → 0.0.8

package/dist/cli/commands/sim/env.js

@@ -0,0 +1,204 @@
+/* eslint-disable no-console */
+import { command, constant, message, optional } from '@optique/core';
+import { object as objectConstruct, or as orConstruct } from '@optique/core/constructs';
+import { argument, flag } from '@optique/core/primitives';
+import { string } from '@optique/core/valueparser';
+import { agentError, agentResult, isAgentMode } from '../../lib/agent.js';
+import { openSim } from '../../lib/openSim.js';
+import { SimAlreadyRunningError } from '../../lib/simPid.js';
+const jsonFlag = optional(flag('--json', { description: message `Output as JSON` }));
+const agentFlag = optional(flag('--agent', { description: message `Output as JSON (agent mode)` }));
+const listArgs = command('list', objectConstruct({
+    envSubcommand: constant('list'),
+    json: jsonFlag,
+    agent: agentFlag,
+}));
+const getArgs = command('get', objectConstruct({
+    envSubcommand: constant('get'),
+    key: argument(string({ metavar: 'KEY' })),
+    json: jsonFlag,
+    agent: agentFlag,
+}));
+const setArgs = command('set', objectConstruct({
+    envSubcommand: constant('set'),
+    secret: optional(flag('--secret', {
+        description: message `Mark value as a secret (write-only, never displayed)`,
+    })),
+    key: argument(string({ metavar: 'KEY' })),
+    value: optional(argument(string({ metavar: 'VALUE' }))),
+    json: jsonFlag,
+    agent: agentFlag,
+}));
+const deleteArgs = command('delete', objectConstruct({
+    envSubcommand: constant('delete'),
+    key: argument(string({ metavar: 'KEY' })),
+    json: jsonFlag,
+    agent: agentFlag,
+}));
+export const args = command('env', objectConstruct({
+    subcommand: constant('env'),
+    envSub: orConstruct(listArgs, getArgs, setArgs, deleteArgs),
+}), { description: message `Manage environment variables stored in the simulator` });
+async function withSimSession(fn) {
+    const { session, transport } = await openSim();
+    try {
+        return await fn(session);
+    }
+    finally {
+        session.close();
+        transport.close();
+    }
+}
+export async function run(config) {
+    const sub = config.envSub;
+    const jsonOutput = sub.json === true || isAgentMode(sub.agent);
+    try {
+        switch (sub.envSubcommand) {
+            case 'list': {
+                await withSimSession(async (session) => {
+                    const entries = await session.config.list();
+                    if (jsonOutput) {
+                        agentResult('sim env list', entries.map((e) => ({
+                            key: e.key,
+                            value: e.secret ? undefined : e.value,
+                            secret: e.secret,
+                        })), [
+                            { command: 'mikro sim env set <KEY> <VALUE>', description: 'Set an env variable' },
+                            { command: 'mikro sim env delete <KEY>', description: 'Delete an env variable' },
+                        ]);
+                        return;
+                    }
+                    if (entries.length === 0) {
+                        console.log('No env variables configured');
+                        return;
+                    }
+                    const envEntries = entries.filter((e) => !e.secret);
+                    const secretEntries = entries.filter((e) => e.secret);
+                    if (envEntries.length > 0) {
+                        const maxKeyLen = Math.max(...envEntries.map((e) => e.key.length));
+                        for (const e of envEntries)
+                            console.log(`${e.key.padEnd(maxKeyLen)}  ${e.value}`);
+                    }
+                    for (const e of secretEntries)
+                        console.log(`${e.key}  ********`);
+                });
+                break;
+            }
+            case 'get': {
+                await withSimSession(async (session) => {
+                    const entries = await session.config.list();
+                    const entry = entries.find((e) => e.key === sub.key);
+                    if (!entry) {
+                        if (jsonOutput) {
+                            agentError('sim env get', `Not found: ${sub.key}`, {
+                                fix: 'Run mikro sim env list to see available keys',
+                            });
+                        }
+                        else {
+                            console.error(`Not found: ${sub.key}`);
+                        }
+                        process.exit(1);
+                    }
+                    if (jsonOutput) {
+                        agentResult('sim env get', {
+                            key: entry.key,
+                            value: entry.secret ? undefined : entry.value,
+                            secret: entry.secret,
+                        });
+                    }
+                    else if (entry.secret) {
+                        console.log('********');
+                    }
+                    else {
+                        console.log(entry.value);
+                    }
+                });
+                break;
+            }
+            case 'set': {
+                const { key, secret: isSecret } = sub;
+                if (Buffer.byteLength(key, 'utf-8') > 15) {
+                    if (jsonOutput) {
+                        agentError('sim env set', `Key "${key}" exceeds NVS 15-char limit`, {
+                            fix: 'Use a key with 15 or fewer characters',
+                        });
+                    }
+                    else {
+                        console.error(`Error: key "${key}" exceeds NVS 15-char limit`);
+                    }
+                    process.exit(1);
+                }
+                if (!sub.value) {
+                    if (jsonOutput) {
+                        agentError('sim env set', 'Missing VALUE', {
+                            fix: 'Provide a value: mikro sim env set <KEY> <VALUE>',
+                        });
+                    }
+                    else {
+                        console.error('Error: missing VALUE');
+                    }
+                    process.exit(1);
+                }
+                await withSimSession(async (session) => {
+                    await session.config.set(key, sub.value, isSecret === true);
+                    if (jsonOutput) {
+                        agentResult('sim env set', { key }, [
+                            { command: 'mikro sim env list', description: 'List all env variables' },
+                        ]);
+                    }
+                    else if (isSecret) {
+                        console.log(`Set secret ${key}`);
+                    }
+                    else {
+                        console.log(`Set ${key}=${sub.value}`);
+                    }
+                });
+                break;
+            }
+            case 'delete': {
+                const { key } = sub;
+                await withSimSession(async (session) => {
+                    const entries = await session.config.list();
+                    const entry = entries.find((e) => e.key === key);
+                    if (!entry) {
+                        if (jsonOutput) {
+                            agentError('sim env delete', `Not found: ${key}`, {
+                                fix: 'Run mikro sim env list to see available keys',
+                            });
+                        }
+                        else {
+                            console.error(`Not found: ${key}`);
+                        }
+                        process.exit(1);
+                    }
+                    await session.config.delete(key);
+                    if (jsonOutput) {
+                        agentResult('sim env delete', { key }, [
+                            { command: 'mikro sim env list', description: 'List all env variables' },
+                        ]);
+                    }
+                    else {
+                        console.log(`Deleted ${key}`);
+                    }
+                });
+                break;
+            }
+        }
+    }
+    catch (err) {
+        if (err instanceof SimAlreadyRunningError) {
+            if (jsonOutput) {
+                agentError('sim env', err.message, {
+                    fix: 'Stop the running sim (Ctrl-C in that terminal), then retry.',
+                });
+            }
+            else {
+                console.error(`Error: ${err.message}`);
+            }
+            process.exit(1);
+        }
+        throw err;
+    }
+    process.exit(0);
+}
+//# sourceMappingURL=env.js.map

package/dist/cli/commands/sim/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../../src/cli/commands/sim/env.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAC,MAAM,eAAe,CAAA;AAClE,OAAO,EAAC,MAAM,IAAI,eAAe,EAAE,EAAE,IAAI,WAAW,EAAC,MAAM,0BAA0B,CAAA;AAErF,OAAO,EAAC,QAAQ,EAAE,IAAI,EAAC,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAC,MAAM,EAAC,MAAM,2BAA2B,CAAA;AAEhD,OAAO,EAAC,UAAU,EAAE,WAAW,EAAE,WAAW,EAAC,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAC,OAAO,EAAC,MAAM,sBAAsB,CAAA;AAE5C,OAAO,EAAC,sBAAsB,EAAC,MAAM,qBAAqB,CAAA;AAE1D,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAC,WAAW,EAAE,OAAO,CAAA,gBAAgB,EAAC,CAAC,CAAC,CAAA;AACjF,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,EAAC,WAAW,EAAE,OAAO,CAAA,6BAA6B,EAAC,CAAC,CAAC,CAAA;AAEhG,MAAM,QAAQ,GAAG,OAAO,CACtB,MAAM,EACN,eAAe,CAAC;IACd,aAAa,EAAE,QAAQ,CAAC,MAAe,CAAC;IACxC,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,SAAS;CACjB,CAAC,CACH,CAAA;AAED,MAAM,OAAO,GAAG,OAAO,CACrB,KAAK,EACL,eAAe,CAAC;IACd,aAAa,EAAE,QAAQ,CAAC,KAAc,CAAC;IACvC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC,CAAC;IACvC,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,SAAS;CACjB,CAAC,CACH,CAAA;AAED,MAAM,OAAO,GAAG,OAAO,CACrB,KAAK,EACL,eAAe,CAAC;IACd,aAAa,EAAE,QAAQ,CAAC,KAAc,CAAC;IACvC,MAAM,EAAE,QAAQ,CACd,IAAI,CAAC,UAAU,EAAE;QACf,WAAW,EAAE,OAAO,CAAA,sDAAsD;KAC3E,CAAC,CACH;IACD,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC,CAAC;IACvC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAC,OAAO,EAAE,OAAO,EAAC,CAAC,CAAC,CAAC;IACrD,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,SAAS;CACjB,CAAC,CACH,CAAA;AAED,MAAM,UAAU,GAAG,OAAO,CACxB,QAAQ,EACR,eAAe,CAAC;IACd,aAAa,EAAE,QAAQ,CAAC,QAAiB,CAAC;IAC1C,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC,CAAC;IACvC,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,SAAS;CACjB,CAAC,CACH,CAAA;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,OAAO,CACzB,KAAK,EACL,eAAe,CAAC;IACd,UAAU,EAAE,QAAQ,CAAC,KAAc,CAAC;IACpC,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC;CAC5D,CAAC,EACF,EAAC,WAAW,EAAE,OAAO,CAAA,sDAAsD,EAAC,CAC7E,CAAA;AAID,KAAK,UAAU,cAAc,CAAI,EAAwC;IACvE,MAAM,EAAC,OAAO,EAAE,SAAS,EAAC,GAAG,MAAM,OAAO,EAAE,CAAA;IAC5C,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,KAAK,EAAE,CAAA;QACf,SAAS,CAAC,KAAK,EAAE,CAAA;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,MAAwB;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAA;IACzB,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAE9D,IAAI,CAAC;QACH,QAAQ,GAAG,CAAC,aAAa,EAAE,CAAC;YAC1B,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;oBACrC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;oBAC3C,IAAI,UAAU,EAAE,CAAC;wBACf,WAAW,CACT,cAAc,EACd,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BAClB,GAAG,EAAE,CAAC,CAAC,GAAG;4BACV,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK;4BACrC,MAAM,EAAE,CAAC,CAAC,MAAM;yBACjB,CAAC,CAAC,EACH;4BACE,EAAC,OAAO,EAAE,iCAAiC,EAAE,WAAW,EAAE,qBAAqB,EAAC;4BAChF,EAAC,OAAO,EAAE,4BAA4B,EAAE,WAAW,EAAE,wBAAwB,EAAC;yBAC/E,CACF,CAAA;wBACD,OAAM;oBACR,CAAC;oBACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACzB,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAA;wBAC1C,OAAM;oBACR,CAAC;oBACD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;oBACnD,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;oBACrD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;wBAClE,KAAK,MAAM,CAAC,IAAI,UAAU;4BAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;oBACnF,CAAC;oBACD,KAAK,MAAM,CAAC,IAAI,aAAa;wBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC,CAAA;gBAClE,CAAC,CAAC,CAAA;gBACF,MAAK;YACP,CAAC;YACD,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;oBACrC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;oBAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAA;oBACpD,IAAI,CAAC,KAAK,EAAE,CAAC;wBACX,IAAI,UAAU,EAAE,CAAC;4BACf,UAAU,CAAC,aAAa,EAAE,cAAc,GAAG,CAAC,GAAG,EAAE,EAAE;gCACjD,GAAG,EAAE,8CAA8C;6BACpD,CAAC,CAAA;wBACJ,CAAC;6BAAM,CAAC;4BACN,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,GAAG,EAAE,CAAC,CAAA;wBACxC,CAAC;wBACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;oBACjB,CAAC;oBACD,IAAI,UAAU,EAAE,CAAC;wBACf,WAAW,CAAC,aAAa,EAAE;4BACzB,GAAG,EAAE,KAAK,CAAC,GAAG;4BACd,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK;4BAC7C,MAAM,EAAE,KAAK,CAAC,MAAM;yBACrB,CAAC,CAAA;oBACJ,CAAC;yBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;wBACxB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;oBACzB,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;oBAC1B,CAAC;gBACH,CAAC,CAAC,CAAA;gBACF,MAAK;YACP,CAAC;YACD,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,EAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAC,GAAG,GAAG,CAAA;gBACnC,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;oBACzC,IAAI,UAAU,EAAE,CAAC;wBACf,UAAU,CAAC,aAAa,EAAE,QAAQ,GAAG,6BAA6B,EAAE;4BAClE,GAAG,EAAE,uCAAuC;yBAC7C,CAAC,CAAA;oBACJ,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,KAAK,CAAC,eAAe,GAAG,6BAA6B,CAAC,CAAA;oBAChE,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;gBACjB,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;oBACf,IAAI,UAAU,EAAE,CAAC;wBACf,UAAU,CAAC,aAAa,EAAE,eAAe,EAAE;4BACzC,GAAG,EAAE,kDAAkD;yBACxD,CAAC,CAAA;oBACJ,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAA;oBACvC,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;gBACjB,CAAC;gBACD,MAAM,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;oBACrC,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAM,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAA;oBAC5D,IAAI,UAAU,EAAE,CAAC;wBACf,WAAW,CAAC,aAAa,EAAE,EAAC,GAAG,EAAC,EAAE;4BAChC,EAAC,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,wBAAwB,EAAC;yBACvE,CAAC,CAAA;oBACJ,CAAC;yBAAM,IAAI,QAAQ,EAAE,CAAC;wBACpB,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,EAAE,CAAC,CAAA;oBAClC,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC,CAAA;oBACxC,CAAC;gBACH,CAAC,CAAC,CAAA;gBACF,MAAK;YACP,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,EAAC,GAAG,EAAC,GAAG,GAAG,CAAA;gBACjB,MAAM,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;oBACrC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;oBAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAA;oBAChD,IAAI,CAAC,KAAK,EAAE,CAAC;wBACX,IAAI,UAAU,EAAE,CAAC;4BACf,UAAU,CAAC,gBAAgB,EAAE,cAAc,GAAG,EAAE,EAAE;gCAChD,GAAG,EAAE,8CAA8C;6BACpD,CAAC,CAAA;wBACJ,CAAC;6BAAM,CAAC;4BACN,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,EAAE,CAAC,CAAA;wBACpC,CAAC;wBACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;oBACjB,CAAC;oBACD,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;oBAChC,IAAI,UAAU,EAAE,CAAC;wBACf,WAAW,CAAC,gBAAgB,EAAE,EAAC,GAAG,EAAC,EAAE;4BACnC,EAAC,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,wBAAwB,EAAC;yBACvE,CAAC,CAAA;oBACJ,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,EAAE,CAAC,CAAA;oBAC/B,CAAC;gBACH,CAAC,CAAC,CAAA;gBACF,MAAK;YACP,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,sBAAsB,EAAE,CAAC;YAC1C,IAAI,UAAU,EAAE,CAAC;gBACf,UAAU,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,EAAE;oBACjC,GAAG,EAAE,6DAA6D;iBACnE,CAAC,CAAA;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;YACxC,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC"}

package/dist/cli/commands/sim/profile.d.ts

@@ -0,0 +1,67 @@
+export declare const args: import("@optique/core").Parser<"sync", {
+    readonly subcommand: "profile";
+    readonly entry: string | undefined;
+    readonly memLimit: string | undefined;
+    readonly memoryBudget: number | undefined;
+    readonly chip: string | undefined;
+    readonly top: number | undefined;
+    readonly sort: string | undefined;
+    readonly minBytes: number | undefined;
+    readonly includeNative: true | undefined;
+    readonly includeBuiltins: true | undefined;
+    readonly onlyNative: true | undefined;
+    readonly onlyBuiltins: true | undefined;
+    readonly bundle: true | undefined;
+    readonly noBundle: true | undefined;
+    readonly noMinify: true | undefined;
+    readonly minifier: string | undefined;
+    readonly minifyLevel: string | undefined;
+    readonly json: true | undefined;
+    readonly env: string | undefined;
+    readonly noEnvFile: true | undefined;
+}, ["matched", string] | ["parsing", {
+    readonly subcommand: "profile";
+    readonly entry: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly memLimit: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly memoryBudget: [import("@optique/core").ValueParserResult<number> | undefined] | undefined;
+    readonly chip: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly top: [import("@optique/core").ValueParserResult<number> | undefined] | undefined;
+    readonly sort: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly minBytes: [import("@optique/core").ValueParserResult<number> | undefined] | undefined;
+    readonly includeNative: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly includeBuiltins: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly onlyNative: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly onlyBuiltins: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly bundle: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly noBundle: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly noMinify: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly minifier: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly minifyLevel: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly json: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+    readonly env: [import("@optique/core").ValueParserResult<string> | undefined] | undefined;
+    readonly noEnvFile: [import("@optique/core").ValueParserResult<true> | undefined] | undefined;
+}] | undefined>;
+interface RunConfig {
+    entry?: string;
+    memLimit?: string;
+    memoryBudget?: number;
+    chip?: string;
+    top?: number;
+    sort?: string;
+    minBytes?: number;
+    includeNative?: boolean;
+    includeBuiltins?: boolean;
+    onlyNative?: boolean;
+    onlyBuiltins?: boolean;
+    bundle?: boolean;
+    noBundle?: boolean;
+    noMinify?: boolean;
+    minifier?: string;
+    minifyLevel?: string;
+    json?: boolean;
+    env?: string;
+    noEnvFile?: boolean;
+}
+export declare function run(config: RunConfig): Promise<void>;
+export {};
+//# sourceMappingURL=profile.d.ts.map

package/dist/cli/commands/sim/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/sim/profile.ts"],"names":[],"mappings":"AA4BA,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAyFhB,CAAA;AAeD,UAAU,SAAS;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,wBAAsB,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAY1D"}

package/dist/cli/commands/sim/profile.js

@@ -0,0 +1,356 @@
+/* eslint-disable no-console */
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import * as pathlib from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { command, constant, message, optional } from '@optique/core';
+import { object } from '@optique/core/constructs';
+import { argument, flag, option } from '@optique/core/primitives';
+import { integer, string } from '@optique/core/valueparser';
+import { path } from '@optique/run';
+import { lastValueFrom } from 'rxjs';
+import { build } from '../../lib/build.js';
+import { connectSim } from '../../lib/connectSim.js';
+import { collectFiles, loadEnvFiles } from '../../lib/deploy.js';
+import { parseMinifier, parseMinifyLevel } from '../../lib/parseMinifier.js';
+import { parseSize } from '../../lib/parseSize.js';
+import { getMikroDir, resolveProjectRoot } from '../../lib/projectRoot.js';
+import { resolveEntry } from '../../lib/resolveEntry.js';
+import { loadSimConfig } from '../../lib/simConfig.js';
+import { checkPid, SimAlreadyRunningError } from '../../lib/simPid.js';
+// Profile mode measures, not enforces. Default to 32 MB so apps larger than
+// the device-realistic ceiling can still be profiled. Override with --mem-limit.
+const DEFAULT_PROFILE_MEM_LIMIT_BYTES = 32 * 1024 * 1024;
+export const args = command('profile', object({
+    subcommand: constant('profile'),
+    entry: optional(argument(path({ metavar: 'ENTRY', mustExist: true, type: 'file' }))),
+    memLimit: optional(option('--mem-limit', string({ metavar: 'BYTES' }), {
+        description: message `QuickJS heap ceiling for the profile run (default: 32M). Supports K/M/G suffixes.`,
+    })),
+    memoryBudget: optional(option('--memory-budget', integer({ metavar: 'KB' }), {
+        description: message `Memory budget in KB for highlighting rows over budget`,
+    })),
+    chip: optional(option('--chip', string({ metavar: 'NAME' }), {
+        description: message `Chip preset for --memory-budget (e.g. esp32c6)`,
+    })),
+    top: optional(option('--top', integer({ metavar: 'N' }), {
+        description: message `Show only the N largest modules`,
+    })),
+    sort: optional(option('--sort', string({ metavar: 'KEY' }), {
+        description: message `Sort by "size" (default) or "order"`,
+    })),
+    minBytes: optional(option('--min-bytes', integer({ metavar: 'N' }), {
+        description: message `Hide modules smaller than N bytes`,
+    })),
+    includeNative: optional(flag('--include-native', {
+        description: message `Include native:* runtime modules in the output (excluded by default)`,
+    })),
+    includeBuiltins: optional(flag('--include-builtins', {
+        description: message `Include mikrojs/* built-in modules in the output (excluded by default)`,
+    })),
+    onlyNative: optional(flag('--only-native', {
+        description: message `Show only native:* modules (whitelist; overrides --include-*)`,
+    })),
+    onlyBuiltins: optional(flag('--only-builtins', {
+        description: message `Show only mikrojs/* built-ins (whitelist; overrides --include-*)`,
+    })),
+    bundle: optional(flag('--bundle', {
+        description: message `Enable bundling even if mikro.config.ts disables it`,
+    })),
+    noBundle: optional(flag('--no-bundle', {
+        description: message `Disable bundling even if mikro.config.ts enables it`,
+    })),
+    noMinify: optional(flag('--no-minify', { description: message `Skip minification` })),
+    minifier: optional(option('--minifier', string({ metavar: 'NAME' }), {
+        description: message `Minifier: esbuild, terser, or swc (default: esbuild)`,
+    })),
+    minifyLevel: optional(option('--minify-level', string({ metavar: 'LEVEL' }), {
+        description: message `Minify level: default or max`,
+    })),
+    json: optional(flag('--json', { description: message `Output as JSON` })),
+    env: optional(option('--env', string({ metavar: 'FILE' }), {
+        description: message `Path to .env file with environment variables`,
+    })),
+    noEnvFile: optional(flag('--no-env-file', {
+        description: message `Skip auto-loading of .env and .env.development from the project root`,
+    })),
+}), { description: message `Profile per-module QuickJS heap usage in the simulator` });
+const CHIP_BUDGETS_KB = {
+    esp32: 200,
+    esp32c3: 180,
+    esp32c6: 240,
+    esp32s3: 260,
+};
+export async function run(config) {
+    try {
+        await runImpl(config);
+    }
+    catch (err) {
+        if (err instanceof SimAlreadyRunningError) {
+            console.error(`Error: ${err.message}`);
+            process.exit(1);
+        }
+        console.error(`mikro sim profile failed: ${err instanceof Error ? err.message : String(err)}`);
+        if (err instanceof Error && err.stack)
+            console.error(err.stack);
+        process.exit(1);
+    }
+}
+async function runImpl(config) {
+    const mikroDir = getMikroDir();
+    checkPid(mikroDir);
+    const entry = resolveEntry(config.entry);
+    const buildDir = pathlib.join(getMikroDir(), 'build');
+    const log = (msg) => console.error(msg);
+    const minify = !config.noMinify;
+    const minifier = parseMinifier(config.minifier);
+    const minifyLevel = parseMinifyLevel(config.minifyLevel);
+    log(`Building ${entry}…`);
+    const bundle = config.noBundle === true ? false : config.bundle === true ? true : undefined;
+    await lastValueFrom(build(entry, buildDir, { minify, bytecode: true, minifier, minifyLevel, bundle }), { defaultValue: undefined });
+    const files = await collectFiles(buildDir);
+    log(`Built ${files.length} file(s)`);
+    const envVars = [
+        { key: 'MIKRO_ENV', value: 'development', secret: false },
+        ...(await loadEnvFiles({
+            cwd: resolveProjectRoot(),
+            mode: 'development',
+            envFile: config.env,
+            noEnvFile: config.noEnvFile === true,
+        })),
+    ];
+    const sim = await loadSimConfig(pathlib.dirname(entry));
+    // Wipe any previously-deployed app from sim-fs before connecting. The first
+    // simProcess spawned by connectSim calls bootRuntime() on startup, which
+    // evaluates whatever was previously staged in sim-fs/app. If the last run
+    // left a broken app there, that boot crashes and we never get to deploy the
+    // fresh build. Since profile is a one-shot transient operation, blowing
+    // away the prior state is always the right thing.
+    const appDir = pathlib.join(sim.fsRoot, 'app');
+    if (existsSync(appDir))
+        rmSync(appDir, { force: true, recursive: true });
+    const profileMemLimit = config.memLimit
+        ? parseSize(config.memLimit)
+        : DEFAULT_PROFILE_MEM_LIMIT_BYTES;
+    log('Staging to simulator…');
+    const stage = connectSim(sim, { memLimitOverride: profileMemLimit });
+    try {
+        const last = await lastValueFrom(stage.session.deploy({ files, envVars, erase: true, restart: false }));
+        if (last.type !== 'complete')
+            throw new Error('Deploy did not complete');
+    }
+    finally {
+        stage.session.close();
+        stage.transport.close();
+    }
+    const tmpDir = tmpdir();
+    mkdirSync(tmpDir, { recursive: true });
+    const profilePath = pathlib.join(tmpDir, `mikro-profile-${process.pid}.json`);
+    try {
+        log('Profiling…');
+        await runProfileSubprocess(sim.fsRoot, profileMemLimit, profilePath);
+        const { entries, baseline } = readProfile(profilePath);
+        if (entries.length === 0) {
+            log('Warning: profile is empty. No modules were loaded during boot.');
+        }
+        renderProfile(entries, {
+            baseline,
+            memoryBudgetKB: resolveBudget(config.memoryBudget, config.chip),
+            chipName: config.chip,
+            top: config.top,
+            sort: config.sort ?? 'size',
+            minBytes: config.minBytes ?? 0,
+            includeNative: config.includeNative === true,
+            includeBuiltins: config.includeBuiltins === true,
+            onlyNative: config.onlyNative === true,
+            onlyBuiltins: config.onlyBuiltins === true,
+            json: config.json === true,
+        });
+    }
+    finally {
+        try {
+            rmSync(profilePath, { force: true });
+        }
+        catch {
+            // best-effort cleanup
+        }
+    }
+}
+function resolveBudget(explicit, chip) {
+    if (explicit !== undefined)
+        return explicit;
+    if (chip !== undefined) {
+        const preset = CHIP_BUDGETS_KB[chip];
+        if (preset === undefined) {
+            console.error(`Unknown chip '${chip}'. Known: ${Object.keys(CHIP_BUDGETS_KB).join(', ')}. ` +
+                `Use --memory-budget to set an explicit value.`);
+            process.exit(1);
+        }
+        return preset;
+    }
+    return null;
+}
+function runProfileSubprocess(fsRoot, memLimitBytes, profilePath) {
+    return new Promise((resolve, reject) => {
+        const entryPath = fileURLToPath(new URL('../../../simulator/simProcess.js', import.meta.url));
+        const childArgs = [
+            entryPath,
+            '--fs-root',
+            fsRoot,
+            '--mem-limit',
+            String(memLimitBytes),
+            '--profile-output',
+            profilePath,
+        ];
+        const stdoutChunks = [];
+        const child = spawn(process.execPath, childArgs, { stdio: ['ignore', 'pipe', 'inherit'] });
+        child.stdout?.on('data', (chunk) => stdoutChunks.push(chunk));
+        child.on('error', reject);
+        child.on('exit', (code, signal) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            const stdoutPreview = Buffer.concat(stdoutChunks).toString('utf-8').slice(0, 500);
+            const tail = stdoutPreview ? `\nsimProcess stdout: ${stdoutPreview}` : '';
+            reject(new Error(`simProcess exited with code=${code} signal=${signal ?? 'none'}\n` +
+                `  node ${childArgs.join(' ')}${tail}`));
+        });
+    });
+}
+function readProfile(profilePath) {
+    if (!existsSync(profilePath)) {
+        throw new Error(`simProcess did not write profile to ${profilePath}. ` +
+            `This usually means bootRuntime failed or no app was deployed.`);
+    }
+    const raw = readFileSync(profilePath, 'utf-8');
+    const parsed = JSON.parse(raw);
+    return { entries: parsed.entries, baseline: parsed.baseline ?? 0 };
+}
+function classifyEntry(name) {
+    if (name.startsWith('native:'))
+        return 'native';
+    if (name.startsWith('mikrojs/'))
+        return 'builtin';
+    return 'user';
+}
+function renderProfile(entries, opts) {
+    // Whitelist mode: if any --only-* flag is set, only those kinds are shown
+    // and --include-* is ignored. Otherwise we hide runtime kinds by default
+    // and the user opts in via --include-*.
+    const whitelistMode = opts.onlyNative || opts.onlyBuiltins;
+    const showNative = whitelistMode ? opts.onlyNative : opts.includeNative;
+    const showBuiltins = whitelistMode ? opts.onlyBuiltins : opts.includeBuiltins;
+    const showUser = !whitelistMode;
+    const nativeEntries = entries.filter((e) => classifyEntry(e.name) === 'native');
+    const builtinEntries = entries.filter((e) => classifyEntry(e.name) === 'builtin');
+    const userEntries = entries.filter((e) => classifyEntry(e.name) === 'user');
+    const visibleEntries = entries.filter((e) => {
+        const kind = classifyEntry(e.name);
+        if (kind === 'native')
+            return showNative;
+        if (kind === 'builtin')
+            return showBuiltins;
+        return showUser;
+    });
+    const filtered = visibleEntries.filter((e) => e.deltaBytes >= opts.minBytes);
+    const sorted = opts.sort === 'order'
+        ? [...filtered].sort((a, b) => a.order - b.order)
+        : [...filtered].sort((a, b) => b.deltaBytes - a.deltaBytes);
+    const displayed = opts.top !== undefined ? sorted.slice(0, opts.top) : sorted;
+    const visibleTotalBytes = visibleEntries.reduce((sum, e) => sum + e.deltaBytes, 0);
+    const nativeTotalBytes = nativeEntries.reduce((sum, e) => sum + e.deltaBytes, 0);
+    const builtinTotalBytes = builtinEntries.reduce((sum, e) => sum + e.deltaBytes, 0);
+    const userTotalBytes = userEntries.reduce((sum, e) => sum + e.deltaBytes, 0);
+    // In whitelist mode, users asked for a specific view — don't add noise
+    // about what's hidden. In default mode, surface runtime cost explicitly
+    // so it's clear why the number is lower than expected.
+    const hiddenNative = !whitelistMode && !showNative && nativeEntries.length > 0;
+    const hiddenBuiltins = !whitelistMode && !showBuiltins && builtinEntries.length > 0;
+    const hiddenUser = whitelistMode && userEntries.length > 0;
+    const baselineKB = opts.baseline / 1024;
+    const allModuleTotalBytes = entries.reduce((sum, e) => sum + e.deltaBytes, 0);
+    const grandTotalKB = (opts.baseline + allModuleTotalBytes) / 1024;
+    if (opts.json) {
+        console.log(JSON.stringify({
+            baseline: opts.baseline,
+            moduleCount: visibleEntries.length,
+            totalBytes: visibleTotalBytes,
+            grandTotalBytes: opts.baseline + allModuleTotalBytes,
+            budgetBytes: opts.memoryBudgetKB !== null ? opts.memoryBudgetKB * 1024 : null,
+            entries: displayed,
+            hidden: {
+                native: hiddenNative ? { count: nativeEntries.length, bytes: nativeTotalBytes } : null,
+                builtins: hiddenBuiltins
+                    ? { count: builtinEntries.length, bytes: builtinTotalBytes }
+                    : null,
+                user: hiddenUser ? { count: userEntries.length, bytes: userTotalBytes } : null,
+            },
+        }, null, 2));
+        return;
+    }
+    const totalKB = visibleTotalBytes / 1024;
+    const budgetBytes = opts.memoryBudgetKB !== null ? opts.memoryBudgetKB * 1024 : null;
+    console.log(`QuickJS baseline: ${baselineKB.toFixed(1)} KB (runtime + context + intrinsics)`);
+    const header = `Module profile — ${visibleEntries.length} modules, ${totalKB.toFixed(1)} KB load cost, ${grandTotalKB.toFixed(1)} KB total`;
+    console.log(header);
+    console.log(dim(`  Load cost only; linking + evaluation overhead not included`));
+    if (hiddenNative) {
+        const kb = nativeTotalBytes / 1024;
+        console.log(dim(`  ${nativeEntries.length} native:* module(s) hidden (${kb.toFixed(1)} KB). Pass --include-native to show.`));
+    }
+    if (hiddenBuiltins) {
+        const kb = builtinTotalBytes / 1024;
+        console.log(dim(`  ${builtinEntries.length} mikrojs/* module(s) hidden (${kb.toFixed(1)} KB). Pass --include-builtins to show.`));
+    }
+    if (hiddenUser) {
+        const kb = userTotalBytes / 1024;
+        console.log(dim(`  ${userEntries.length} user module(s) hidden (${kb.toFixed(1)} KB) by --only-*.`));
+    }
+    if (budgetBytes !== null) {
+        const pct = (visibleTotalBytes / budgetBytes) * 100;
+        const budgetLabel = opts.chipName
+            ? `${opts.memoryBudgetKB} KB (${opts.chipName})`
+            : `${opts.memoryBudgetKB} KB`;
+        const footer = `Budget: ${budgetLabel}, used ${totalKB.toFixed(1)} KB (${pct.toFixed(0)}%)`;
+        console.log(pct > 100 ? red(footer) : pct >= 80 ? yellow(footer) : footer);
+    }
+    console.log('');
+    const nameWidth = Math.min(Math.max(10, ...displayed.map((e) => e.name.length)), 60);
+    const sizeHeader = 'Size';
+    const cumHeader = 'Cumulative';
+    console.log(`  ${'Module'.padEnd(nameWidth)}  ${sizeHeader.padStart(8)}  ${cumHeader.padStart(12)}`);
+    let cumulative = 0;
+    for (const entry of displayed) {
+        cumulative += entry.deltaBytes;
+        const sizeCell = formatKB(entry.deltaBytes).padStart(8);
+        const cumCell = formatKB(cumulative).padStart(12);
+        const nameCell = truncate(entry.name, nameWidth).padEnd(nameWidth);
+        const row = `  ${nameCell}  ${sizeCell}  ${cumCell}`;
+        console.log(colorizeRow(row, entry.deltaBytes, cumulative, budgetBytes));
+    }
+}
+function formatKB(bytes) {
+    return `${(bytes / 1024).toFixed(1)} KB`;
+}
+function truncate(s, max) {
+    if (s.length <= max)
+        return s;
+    return s.slice(0, max - 1) + '…';
+}
+function colorizeRow(row, deltaBytes, cumulative, budgetBytes) {
+    if (budgetBytes === null)
+        return row;
+    if (deltaBytes > budgetBytes * 0.25)
+        return red(row);
+    if (cumulative > budgetBytes)
+        return red(row);
+    if (deltaBytes > Math.min(budgetBytes * 0.1, 10 * 1024))
+        return yellow(row);
+    return row;
+}
+const red = (s) => `\x1b[31m${s}\x1b[0m`;
+const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
+const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+//# sourceMappingURL=profile.js.map