mimetic-cli 0.1.4 → 0.1.5

package/dist/lab-app-runner.js

@@ -0,0 +1,403 @@
+export const LAB_APP_RUNNER_PLAN_SCHEMA = "mimetic.lab-app-runner-plan.v1";
+const DEFAULT_PORTS = {
+    generic: 3000,
+    next: 3000,
+    vite: 5173
+};
+const RUNNABLE_SCRIPT_NAMES = ["dev", "start", "serve", "preview"];
+const SAFE_SCRIPT_NAME_PATTERN = /^[A-Za-z0-9:_-]+$/;
+export function buildLabAppRunnerPlan(metadata) {
+    const packageManager = detectPackageManager(metadata);
+    const scripts = collectStringMap(metadata.packageJson?.scripts, metadata.scripts);
+    const dependencies = collectStringMap(metadata.packageJson?.dependencies, metadata.dependencies);
+    const devDependencies = collectStringMap(metadata.packageJson?.devDependencies, metadata.devDependencies);
+    const install = buildInstallPlan(packageManager, metadata);
+    const candidate = selectScriptCandidate({ dependencies, devDependencies, scripts });
+    const warnings = [];
+    if (!candidate) {
+        warnings.push("No runnable app script was detected; desktop and mobile app surfaces were not planned.");
+        const shell = renderLabAppRunnerShell({
+            install,
+            packageManager
+        });
+        return {
+            schema: LAB_APP_RUNNER_PLAN_SCHEMA,
+            ok: false,
+            framework: "none",
+            install,
+            packageManager,
+            shell,
+            surfaces: [],
+            warnings
+        };
+    }
+    const port = selectPort(metadata.preferredPort, candidate.rawCommand, DEFAULT_PORTS[candidate.framework]);
+    const url = `http://127.0.0.1:${port}`;
+    const devServer = {
+        command: buildStartCommand(packageManager, candidate, candidate.rawCommand),
+        framework: candidate.framework,
+        port,
+        reason: candidate.reason,
+        scriptName: candidate.name,
+        url
+    };
+    const readiness = {
+        command: `wait_for_http "$APP_URL" ${readinessTimeoutMs(metadata)} ${readinessIntervalMs(metadata)}`,
+        intervalMs: readinessIntervalMs(metadata),
+        timeoutMs: readinessTimeoutMs(metadata),
+        url
+    };
+    const surfaces = buildSurfaces(url);
+    const shell = renderLabAppRunnerShell({
+        devServer,
+        install,
+        packageManager,
+        readiness,
+        surfaces
+    });
+    return {
+        schema: LAB_APP_RUNNER_PLAN_SCHEMA,
+        ok: true,
+        devServer,
+        framework: candidate.framework,
+        install,
+        packageManager,
+        readiness,
+        shell,
+        surfaces,
+        warnings
+    };
+}
+export function renderLabAppRunnerShell(args) {
+    const commands = [
+        ...installCommands(args.install),
+        ...(args.devServer ? [args.devServer.command] : []),
+        ...(args.readiness ? [args.readiness.command] : []),
+        ...(args.surfaces ?? []).map((surface) => surface.command)
+    ];
+    return {
+        commands,
+        script: [
+            "#!/usr/bin/env bash",
+            "set -Eeuo pipefail",
+            "export MIMETIC_PUBLIC_SAFE=1",
+            `APP_PORT="\${APP_PORT:-${args.devServer?.port ?? DEFAULT_PORTS.generic}}"`,
+            "APP_HOST=\"${APP_HOST:-0.0.0.0}\"",
+            "APP_URL=\"${APP_URL:-http://127.0.0.1:${APP_PORT}}\"",
+            "APP_RUNNER_LOG=\"${APP_RUNNER_LOG:-mimetic-app-runner.log}\"",
+            "",
+            renderWaitFunction(),
+            "",
+            renderOpenFunction(),
+            "",
+            ...renderInstallShell(args.install),
+            "",
+            ...(args.devServer && args.readiness && args.surfaces
+                ? [
+                    "echo \"== starting app server ==\"",
+                    `${args.devServer.command} > "$APP_RUNNER_LOG" 2>&1 &`,
+                    "APP_RUNNER_PID=$!",
+                    args.readiness.command,
+                    ...args.surfaces.map((surface) => surface.command),
+                    "wait \"$APP_RUNNER_PID\""
+                ]
+                : [
+                    "echo \"No runnable app script detected; skipping app surface launch.\"",
+                    "exit 2"
+                ])
+        ].join("\n")
+    };
+}
+function detectPackageManager(metadata) {
+    const hint = firstNonEmpty(metadata.packageManager, metadata.packageJson?.packageManager);
+    const lockfiles = new Set((metadata.lockfiles ?? []).map((lockfile) => lockfile.trim()));
+    if (hint?.startsWith("pnpm@") || lockfiles.has("pnpm-lock.yaml"))
+        return "pnpm";
+    if (hint?.startsWith("yarn@") || lockfiles.has("yarn.lock"))
+        return "yarn";
+    if (hint?.startsWith("bun@") || lockfiles.has("bun.lock") || lockfiles.has("bun.lockb"))
+        return "bun";
+    return "npm";
+}
+function buildInstallPlan(packageManager, metadata) {
+    const command = installCommand(packageManager, metadata.lockfiles ?? []);
+    if (metadata.hasNodeModules === true) {
+        return {
+            command,
+            mode: "skip",
+            reason: "node_modules is already present."
+        };
+    }
+    if (metadata.hasNodeModules === false) {
+        return {
+            command,
+            mode: "run",
+            reason: "node_modules is missing."
+        };
+    }
+    return {
+        command,
+        mode: "when-missing",
+        reason: "Install only if node_modules is absent at bootstrap time."
+    };
+}
+function installCommand(packageManager, lockfiles) {
+    const locks = new Set(lockfiles);
+    switch (packageManager) {
+        case "pnpm":
+            return locks.has("pnpm-lock.yaml")
+                ? "pnpm install --frozen-lockfile --ignore-scripts"
+                : "pnpm install --ignore-scripts";
+        case "yarn":
+            return locks.has("yarn.lock")
+                ? "yarn install --frozen-lockfile --ignore-scripts"
+                : "yarn install --ignore-scripts";
+        case "bun":
+            return locks.has("bun.lock") || locks.has("bun.lockb")
+                ? "bun install --frozen-lockfile"
+                : "bun install";
+        case "npm":
+            return locks.has("package-lock.json") || locks.has("npm-shrinkwrap.json")
+                ? "npm ci --ignore-scripts --no-audit --no-fund"
+                : "npm install --ignore-scripts --no-audit --no-fund";
+    }
+}
+function selectScriptCandidate(args) {
+    const allDependencies = { ...args.dependencies, ...args.devDependencies };
+    const scriptEntries = runnableScriptEntries(args.scripts);
+    const nextByCommand = scriptEntries.find((entry) => /\bnext\s+(dev|start)\b/.test(entry.command));
+    if (nextByCommand) {
+        return {
+            framework: "next",
+            name: nextByCommand.name,
+            rawCommand: nextByCommand.command,
+            reason: `Selected ${nextByCommand.name} because it matches Next.js app startup.`
+        };
+    }
+    const viteByCommand = scriptEntries.find((entry) => /\bvite(\s|$)/.test(entry.command));
+    if (viteByCommand) {
+        return {
+            framework: "vite",
+            name: viteByCommand.name,
+            rawCommand: viteByCommand.command,
+            reason: `Selected ${viteByCommand.name} because it matches Vite app startup.`
+        };
+    }
+    if (Object.prototype.hasOwnProperty.call(allDependencies, "next")) {
+        const script = scriptEntries.find((entry) => entry.name === "dev" || entry.name === "start") ?? scriptEntries[0];
+        if (script) {
+            return {
+                framework: "next",
+                name: script.name,
+                rawCommand: script.command,
+                reason: `Selected ${script.name} because package metadata includes Next.js.`
+            };
+        }
+    }
+    if (Object.prototype.hasOwnProperty.call(allDependencies, "vite")) {
+        const script = scriptEntries.find((entry) => entry.name === "dev" || entry.name === "start") ?? scriptEntries[0];
+        if (script) {
+            return {
+                framework: "vite",
+                name: script.name,
+                rawCommand: script.command,
+                reason: `Selected ${script.name} because package metadata includes Vite.`
+            };
+        }
+    }
+    const generic = scriptEntries.find((entry) => entry.name === "dev")
+        ?? scriptEntries.find((entry) => entry.name === "start")
+        ?? scriptEntries[0];
+    if (!generic) {
+        return null;
+    }
+    return {
+        framework: "generic",
+        name: generic.name,
+        rawCommand: generic.command,
+        reason: `Selected ${generic.name} because it is a common runnable app script.`
+    };
+}
+function runnableScriptEntries(scripts) {
+    const entries = [];
+    for (const name of RUNNABLE_SCRIPT_NAMES) {
+        const command = scripts[name]?.trim();
+        if (!command || !SAFE_SCRIPT_NAME_PATTERN.test(name)) {
+            continue;
+        }
+        entries.push({ command, name });
+    }
+    return entries;
+}
+function selectPort(preferredPort, rawCommand, defaultPort) {
+    if (isValidPort(preferredPort))
+        return preferredPort;
+    const scriptPort = extractPort(rawCommand);
+    if (scriptPort)
+        return scriptPort;
+    return defaultPort;
+}
+function extractPort(rawCommand) {
+    const matches = [
+        /(?:^|\s)(?:--port|-p)\s+([0-9]{2,5})(?:\s|$)/,
+        /(?:^|\s)PORT=([0-9]{2,5})(?:\s|$)/
+    ];
+    for (const pattern of matches) {
+        const value = pattern.exec(rawCommand)?.[1];
+        const port = value ? Number(value) : NaN;
+        if (isValidPort(port))
+            return port;
+    }
+    return null;
+}
+function buildStartCommand(packageManager, candidate, rawCommand) {
+    const runCommand = `${packageManager} run ${candidate.name}`;
+    const envPrefix = 'HOST="$APP_HOST" PORT="$APP_PORT"';
+    const extraArgs = frameworkArgs(candidate.framework, rawCommand);
+    return `${envPrefix} ${runCommand}${extraArgs.length > 0 ? ` ${scriptArgumentSeparator(packageManager)}${extraArgs.join(" ")}` : ""}`;
+}
+function scriptArgumentSeparator(packageManager) {
+    return packageManager === "pnpm" ? "" : "-- ";
+}
+function frameworkArgs(framework, rawCommand) {
+    if (framework === "generic") {
+        return [];
+    }
+    const args = [];
+    if (!hasHost(rawCommand)) {
+        args.push(framework === "next" ? "--hostname" : "--host", '"$APP_HOST"');
+    }
+    if (!hasPort(rawCommand)) {
+        args.push("--port", '"$APP_PORT"');
+    }
+    return args;
+}
+function hasHost(rawCommand) {
+    return /(?:^|\s)(?:--host|--hostname|-H)(?:\s|=)/.test(rawCommand) || /(?:^|\s)HOST=/.test(rawCommand);
+}
+function hasPort(rawCommand) {
+    return /(?:^|\s)(?:--port|-p)(?:\s|=)/.test(rawCommand) || /(?:^|\s)PORT=/.test(rawCommand);
+}
+function buildSurfaces(url) {
+    return [
+        {
+            command: 'open_lab_surface "$APP_URL" desktop 1440 960',
+            id: "desktop",
+            label: "Desktop app surface",
+            url,
+            viewport: {
+                deviceScaleFactor: 1,
+                height: 960,
+                isMobile: false,
+                width: 1440
+            }
+        },
+        {
+            command: 'open_lab_surface "$APP_URL" mobile 390 844',
+            id: "mobile",
+            label: "Mobile app surface",
+            url,
+            viewport: {
+                deviceScaleFactor: 2,
+                height: 844,
+                isMobile: true,
+                width: 390
+            }
+        }
+    ];
+}
+function installCommands(install) {
+    if (install.mode === "skip")
+        return [];
+    return [install.command];
+}
+function renderInstallShell(install) {
+    switch (install.mode) {
+        case "skip":
+            return ["echo \"== dependencies already present; skipping install ==\""];
+        case "run":
+            return [
+                "echo \"== installing dependencies ==\"",
+                install.command
+            ];
+        case "when-missing":
+            return [
+                "if [ ! -d node_modules ]; then",
+                "  echo \"== installing dependencies ==\"",
+                `  ${install.command}`,
+                "else",
+                "  echo \"== dependencies already present; skipping install ==\"",
+                "fi"
+            ];
+    }
+}
+function renderWaitFunction() {
+    return `wait_for_http() {
+  local url="$1"
+  local timeout_ms="$2"
+  local interval_ms="$3"
+  node - "$url" "$timeout_ms" "$interval_ms" <<'NODE'
+const [url, timeoutArg, intervalArg] = process.argv.slice(2);
+const timeoutMs = Number(timeoutArg);
+const intervalMs = Number(intervalArg);
+const startedAt = Date.now();
+
+async function probe() {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), Math.min(intervalMs, 5_000));
+  try {
+    const response = await fetch(url, { signal: controller.signal });
+    return response.status < 500;
+  } catch {
+    return false;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+while (Date.now() - startedAt <= timeoutMs) {
+  if (await probe()) process.exit(0);
+  await new Promise((resolve) => setTimeout(resolve, intervalMs));
+}
+console.error("Timed out waiting for HTTP readiness.");
+process.exit(1);
+NODE
+}`;
+}
+function renderOpenFunction() {
+    return `open_lab_surface() {
+  local url="$1"
+  local profile="$2"
+  local width="$3"
+  local height="$4"
+  if command -v google-chrome >/dev/null 2>&1; then
+    nohup google-chrome --no-first-run --no-default-browser-check --disable-default-apps --user-data-dir=".mimetic-lab-\${profile}-chrome" --window-size="\${width},\${height}" "$url" >/dev/null 2>&1 &
+  elif command -v firefox >/dev/null 2>&1; then
+    nohup firefox --width "$width" --height "$height" "$url" >/dev/null 2>&1 &
+  else
+    echo "browser_open=skipped surface=$profile url=$url"
+  fi
+}`;
+}
+function readinessTimeoutMs(metadata) {
+    return positiveInt(metadata.readinessTimeoutMs, 120_000);
+}
+function readinessIntervalMs(metadata) {
+    return positiveInt(metadata.readinessIntervalMs, 1_000);
+}
+function positiveInt(value, fallback) {
+    return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : fallback;
+}
+function isValidPort(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 1 && value <= 65_535;
+}
+function collectStringMap(first, second) {
+    return {
+        ...(first ?? {}),
+        ...(second ?? {})
+    };
+}
+function firstNonEmpty(...values) {
+    return values.find((value) => value !== undefined && value.trim().length > 0);
+}
+//# sourceMappingURL=lab-app-runner.js.map

package/dist/lab-app-runner.js.map

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

package/dist/labs.d.ts

@@ -0,0 +1,67 @@
+export declare const LAB_MANIFEST_SCHEMA = "mimetic.lab.v1";
+export declare const LAB_LIST_SCHEMA = "mimetic.lab-list.v1";
+export declare const LAB_INSPECT_SCHEMA = "mimetic.lab-inspect.v1";
+export type LabKind = "synthetic" | "oss-meta" | "oss-smoke";
+export type LabOrigin = "committed" | "ignored" | "explicit";
+export interface LabManifest {
+    schema: typeof LAB_MANIFEST_SCHEMA;
+    id: string;
+    kind: LabKind;
+    title?: string;
+    description?: string;
+    sims?: number;
+    count?: number;
+    limit?: number;
+    repos?: string[];
+    defaults?: {
+        dryRun?: boolean;
+        open?: boolean;
+        redactRepos?: boolean;
+    };
+}
+export interface ResolvedLabManifest {
+    manifest: LabManifest;
+    origin: LabOrigin;
+    path: string;
+    warnings: string[];
+}
+export interface LabResolveFailure {
+    ok: false;
+    cwd: string;
+    lab: string;
+    error: {
+        code: "MIMETIC_LAB_NOT_FOUND" | "MIMETIC_LAB_INVALID";
+        message: string;
+    };
+    warnings: string[];
+}
+export type LabResolveResult = ({
+    ok: true;
+} & ResolvedLabManifest) | LabResolveFailure;
+export interface LabListResult {
+    schema: typeof LAB_LIST_SCHEMA;
+    ok: true;
+    cwd: string;
+    labs: Array<{
+        id: string;
+        kind: LabKind;
+        origin: LabOrigin;
+        path: string;
+        title?: string;
+    }>;
+    warnings: string[];
+}
+export interface LabInspectResult {
+    schema: typeof LAB_INSPECT_SCHEMA;
+    ok: boolean;
+    cwd: string;
+    lab: string;
+    manifest?: LabManifest;
+    origin?: LabOrigin;
+    path?: string;
+    error?: LabResolveFailure["error"];
+    warnings: string[];
+}
+export declare function resolveLabManifest(cwd: string, lab: string): Promise<LabResolveResult>;
+export declare function listLabManifests(cwd: string): Promise<LabListResult>;
+export declare function inspectLabManifest(cwd: string, lab: string): Promise<LabInspectResult>;