@kindgi/cli 0.1.4 → 0.1.5-rc.0

package/dist/dev/log-view.js

@@ -0,0 +1,233 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * How `kindgi dev` shows logs. The runtime container and the pack service
+ * write `@kindgi/log` records as JSON; `kindgi dev` reads them and prints
+ * them for a person, each tagged with where it came from:
+ *
+ *   [runtime] 14:02:11.123 INFO  [http] GET /v1/runs 200 12ms requestId=…
+ *   [pack] 14:02:11.130 INFO  [pack] tool acme.lookup ok 12ms runId=…
+ *
+ * Levels are set where the records are written (`KINDGI_LOG_LEVEL` and
+ * `KINDGI_LOG_LEVELS` for the runtime, the pack service and the indexer),
+ * and checked again here for a source that ignores them.
+ * `--log-format=json` writes the records as they came, one per line on
+ * stdout, for `| jq`; everything else stays on stderr. `--quiet` keeps
+ * errors only. A line that isn't a record (pack code's own output, an
+ * older runtime's) is shown as it is.
+ */
+import { LOG_LEVELS, SEVERITY, formatPretty, levelEnabled, levelFor, parseLogLevel, parseLogLevels, } from '@kindgi/log';
+/** Before the flags are read: everything shown, plain. */
+export const DEFAULT_DEV_LOG_VIEW = {
+    level: 'info',
+    levels: {},
+    format: 'pretty',
+    color: false,
+    quiet: false,
+};
+/** The log flags from the command line, or what's wrong with one. */
+export function parseDevLogFlags(options) {
+    let level;
+    if (typeof options.level === 'string') {
+        level = parseLogLevel(options.level);
+        if (level === undefined) {
+            return {
+                kind: 'error',
+                message: `--log-level must be one of ${LOG_LEVELS.join(', ')}, got "${options.level}".`,
+            };
+        }
+    }
+    const levels = {};
+    const entries = typeof options.log === 'string' ? [options.log] : Array.isArray(options.log) ? options.log : [];
+    for (const entry of entries) {
+        const parsed = parseLogLevels(entry);
+        if (parsed.kind === 'err')
+            return { kind: 'error', message: `--log: ${parsed.message}.` };
+        Object.assign(levels, parsed.levels);
+    }
+    const format = typeof options.format === 'string' ? options.format.trim().toLowerCase() : 'pretty';
+    if (format !== 'pretty' && format !== 'json') {
+        return {
+            kind: 'error',
+            message: `--log-format must be pretty or json, got "${String(options.format)}".`,
+        };
+    }
+    return {
+        kind: 'ok',
+        value: { ...(level !== undefined && { level }), levels, format, quiet: options.quiet },
+    };
+}
+/**
+ * The session's view: the flags first, then `KINDGI_LOG_LEVEL` and
+ * `KINDGI_LOG_LEVELS` (the shell's, then the env files'), then `info`.
+ * `--quiet` is `error` unless `--log-level` says otherwise.
+ */
+export function resolveDevLogView(flags, input) {
+    const setting = (name) => {
+        const value = input.env[name] ?? input.files[name];
+        return value === undefined || value.trim() === '' ? undefined : value;
+    };
+    let level = flags.level;
+    let levels = {};
+    if (flags.quiet) {
+        level ??= 'error';
+    }
+    else {
+        const rawLevel = setting('KINDGI_LOG_LEVEL');
+        if (level === undefined && rawLevel !== undefined) {
+            level = parseLogLevel(rawLevel);
+            if (level === undefined) {
+                return {
+                    kind: 'error',
+                    message: `KINDGI_LOG_LEVEL must be one of ${LOG_LEVELS.join(', ')}, got "${rawLevel}".`,
+                };
+            }
+        }
+        const rawLevels = setting('KINDGI_LOG_LEVELS');
+        if (rawLevels !== undefined) {
+            const parsed = parseLogLevels(rawLevels);
+            if (parsed.kind === 'err') {
+                return { kind: 'error', message: `KINDGI_LOG_LEVELS: ${parsed.message}.` };
+            }
+            levels = parsed.levels;
+        }
+    }
+    const color = flags.format === 'pretty' && input.isTTY && (input.env.NO_COLOR ?? '') === '';
+    return {
+        kind: 'ok',
+        value: {
+            level: level ?? 'info',
+            levels: { ...levels, ...flags.levels },
+            format: flags.format,
+            color,
+            quiet: flags.quiet,
+        },
+    };
+}
+/** The levels a source gets, so it writes only what's shown. */
+export function sourceLogLevels(view) {
+    const levels = Object.entries(view.levels)
+        .map(([subsystem, level]) => `${subsystem}=${level}`)
+        .join(',');
+    return {
+        KINDGI_LOG_LEVEL: view.level,
+        ...(levels !== '' && { KINDGI_LOG_LEVELS: levels }),
+    };
+}
+/**
+ * The levels the runtime gets: the view's, with its `boot` record kept
+ * (`boot` at info at least). In JSON the runtime writes its banner as that
+ * record, and `kindgi dev` waits for it to know the runtime serves, so a
+ * higher level (`--quiet`, `--log-level=warn`) would leave it waiting.
+ * Whether the banner is shown is still the view's.
+ */
+export function runtimeLogLevels(view) {
+    return shows(view, 'info', 'boot')
+        ? sourceLogLevels(view)
+        : sourceLogLevels({ ...view, levels: { ...view.levels, boot: 'info' } });
+}
+/**
+ * The settings a source `kindgi dev` reads gets: the levels shown, as
+ * records (the pack service and the indexer; the runtime container adds
+ * the format itself, since a runtime you run writes to your terminal).
+ */
+export function sourceLogEnv(view) {
+    return { KINDGI_LOG_FORMAT: 'json', ...sourceLogLevels(view) };
+}
+/** A line as a record, when it is one (the five fixed fields, a known level). */
+export function parseRecord(line) {
+    if (!line.startsWith('{'))
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
+        return undefined;
+    const r = parsed;
+    return typeof r.time === 'string' &&
+        typeof r.level === 'string' &&
+        LOG_LEVELS.includes(r.level) &&
+        typeof r.subsystem === 'string' &&
+        typeof r.message === 'string'
+        ? r
+        : undefined;
+}
+/**
+ * The runtime's banner, when the record carries it: in JSON the runtime
+ * writes its boot lines as one `boot` record with them as `lines`.
+ */
+function bootLines(record) {
+    const lines = record.lines;
+    return record.subsystem === 'boot' &&
+        Array.isArray(lines) &&
+        lines.every((l) => typeof l === 'string')
+        ? lines
+        : undefined;
+}
+/**
+ * A line as text a person reads, for checks on what a source said and
+ * for a failure's last lines: a record pretty (the banner as its lines),
+ * anything else as it is.
+ */
+export function textLines(line) {
+    const record = parseRecord(line);
+    if (record === undefined)
+        return [line];
+    return bootLines(record) ?? formatPretty(record).split('\n');
+}
+/** Whether the view shows a record at `level` from `subsystem`. */
+export function shows(view, level, subsystem) {
+    return levelEnabled(level, levelFor(subsystem, view.levels, view.level));
+}
+/** A record, as `kindgi dev` shows it: `undefined` when its level is filtered out. */
+export function showRecord(source, record, raw, view) {
+    if (!shows(view, record.level, record.subsystem))
+        return undefined;
+    if (view.format === 'json')
+        return { stream: 'stdout', lines: [raw] };
+    const text = bootLines(record) ?? formatPretty(record, { color: view.color }).split('\n');
+    return { stream: 'stderr', lines: text.map((l) => `[${source}] ${l}`) };
+}
+/**
+ * A line that isn't a record, as `kindgi dev` shows it: tagged, on
+ * stderr. `--quiet` keeps only what a source wrote on stderr.
+ */
+export function showText(source, line, view, stream) {
+    if (view.quiet && stream !== 'stderr')
+        return undefined;
+    return { stream: 'stderr', lines: [`[${source}] ${line}`] };
+}
+/** A line a source wrote, as `kindgi dev` shows it, or `undefined` to leave it out. */
+export function showLine(source, line, view, stream = 'stdout') {
+    const record = parseRecord(line);
+    return record === undefined
+        ? showText(source, line, view, stream)
+        : showRecord(source, record, line, view);
+}
+/**
+ * What pack code printed while the indexer loaded it: shown at `debug`
+ * (subsystem `pack.index`), where it used to be dropped. A record it
+ * wrote is shown as any record.
+ */
+export function showIndexerLine(line, view, now = () => new Date()) {
+    const record = parseRecord(line);
+    if (record !== undefined)
+        return showRecord('pack', record, line, view);
+    if (!shows(view, 'debug', 'pack.index'))
+        return undefined;
+    if (view.format === 'json')
+        return { stream: 'stderr', lines: [`[pack] ${line}`] };
+    const shown = {
+        time: now().toISOString(),
+        level: 'debug',
+        severity: SEVERITY.debug,
+        subsystem: 'pack.index',
+        message: line,
+    };
+    return { stream: 'stderr', lines: [`[pack] ${formatPretty(shown, { color: view.color })}`] };
+}
+//# sourceMappingURL=log-view.js.map

package/dist/dev/log-view.js.map

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

package/dist/dev/pack-code.d.ts

@@ -1,11 +1,52 @@
 import type { PackLanguage } from '@kindgi/handler-runtime';
-/** The pack's code: its language, and for Python the interpreter (an argv prefix). */
+/**
+ * The pack's code: its language, and how to run it — for Python the
+ * interpreter (an argv prefix), for Java the JDK and the build.
+ */
 export type PackCode = {
     readonly language: 'node';
 } | {
     readonly language: 'python';
     readonly python: readonly [string, ...string[]];
-};
+} | JvmPackCode;
+/** A JVM pack's code: Java's (built by Maven) or Scala's (built by sbt). */
+export type JvmPackCode = JavaPackCode | ScalaPackCode;
+/** Whether the pack's code runs on the JVM: kindgi-pack indexes and serves it. */
+export declare function isJvmPackCode(code: PackCode | undefined): code is JvmPackCode;
+/** What every JVM pack's code has: the JDK that runs it, and where its build's files go. */
+interface JvmRuntime {
+    /** The JDK's `java`: `<javaHome>/bin/java`, or `java` on `PATH`. */
+    readonly java: string;
+    /** The JDK's home, passed on as `JAVA_HOME` (the build tool's and the launcher's JDK); absent: `java` on `PATH`. */
+    readonly javaHome?: string;
+    /** Where the build's files go (`devJvmDir`): the classpath `@argfile`, the launcher. */
+    readonly workDir: string;
+}
+/** A Scala pack's code: the JDK that runs it, the sbt that builds it, where the build's files go. */
+export interface ScalaPackCode extends JvmRuntime {
+    readonly language: 'scala';
+    /** sbt, as an argv prefix: `dev.sbt`, else `sbt` on `PATH`. Builds go through its server (`--client`). */
+    readonly sbt: readonly [string, ...string[]];
+    /** `SBT_OPTS` from the host, for sbt only (a machine's own proxy or memory settings). */
+    readonly sbtEnv?: Readonly<Record<string, string>>;
+}
+/** A Java pack's code: the JDK that runs it, the Maven that builds it, where the build's files go. */
+export interface JavaPackCode extends JvmRuntime {
+    readonly language: 'java';
+    /** Maven, as an argv prefix: `dev.maven`, else the pack's wrapper (`sh mvnw`), else `mvn`. */
+    readonly maven: readonly [string, ...string[]];
+    /**
+     * `MAVEN_ARGS` and `MAVEN_OPTS` from the host, for Maven only (a machine's
+     * own `-s settings.xml`, a proxy): never in the pack's environment.
+     */
+    readonly mavenEnv?: Readonly<Record<string, string>>;
+}
+/** The `@argfile` passing a JVM pack's classpath to `java` (written by its builder). */
+export declare function javaArgsFile(code: JvmPackCode): string;
+/** The launcher (`kindgi-pack-java`) extracted from the pack's kindgi-pack jar. */
+export declare function javaLauncher(code: JvmPackCode): string;
+/** The environment a JVM pack's children run with: the pack's, plus its JDK as `JAVA_HOME`. */
+export declare function javaEnv(code: JvmPackCode, env: Readonly<Record<string, string>>): Readonly<Record<string, string>>;
 export declare const NODE_PACK_CODE: PackCode;
 type Outcome<T> = {
     readonly kind: 'ok';
@@ -23,8 +64,31 @@ type Outcome<T> = {
  *   3. `python3` on `PATH`.
  */
 export declare function resolvePackPython(packDir: string, config: Readonly<Record<string, unknown>> | undefined): Promise<Outcome<readonly [string, ...string[]]>>;
-/** The pack code for a language, with the interpreter resolved for Python. */
-export declare function resolvePackCode(language: PackLanguage, packDir: string, config: Readonly<Record<string, unknown>> | undefined): Promise<Outcome<PackCode>>;
+/**
+ * The JDK and the Maven that run and build a Java pack:
+ *
+ *   - the JDK: `dev.javaHome` in the config, else `JAVA_HOME`, else `java`
+ *     on `PATH`;
+ *   - Maven: `dev.maven` (an argv, such as `["mvn", "-s", "settings.xml"]`),
+ *     else the pack's wrapper (`mvnw`, run with `sh`), else `mvn` on `PATH`.
+ *
+ * A Java pack's service starts through a POSIX shell script (the launcher
+ * keeps its token out of the JVM's environment): on Windows, `kindgi dev`
+ * runs it under WSL.
+ */
+export declare function resolvePackJava(packDir: string, config: Readonly<Record<string, unknown>> | undefined, hostEnv: Readonly<Record<string, string | undefined>>, platform?: NodeJS.Platform): Promise<Outcome<JavaPackCode>>;
+/**
+ * The JDK and the sbt that run and build a Scala pack:
+ *
+ *   - the JDK, as for a Java pack: `dev.javaHome`, else `JAVA_HOME`, else
+ *     `java` on `PATH`;
+ *   - sbt: `dev.sbt` (an argv, such as `["sbt", "-Dsbt.override.build.repos=true"]`),
+ *     else `sbt` on `PATH`. Builds go through its server (`sbt --client`),
+ *     so a save compiles without starting a JVM.
+ */
+export declare function resolvePackScala(packDir: string, config: Readonly<Record<string, unknown>> | undefined, hostEnv: Readonly<Record<string, string | undefined>>, platform?: NodeJS.Platform): Promise<Outcome<ScalaPackCode>>;
+/** The pack code for a language, with the interpreter or the JDK resolved. */
+export declare function resolvePackCode(language: PackLanguage, packDir: string, config: Readonly<Record<string, unknown>> | undefined, hostEnv?: Readonly<Record<string, string | undefined>>): Promise<Outcome<PackCode>>;
 /**
  * Check the pack's Python can run pack code (`import kindgi.pack`), with the
  * pack's environment and from the pack's directory — so a missing
@@ -32,5 +96,16 @@ export declare function resolvePackCode(language: PackLanguage, packDir: string,
  * failure.
  */
 export declare function checkPackPython(python: readonly [string, ...string[]], env: Readonly<Record<string, string>>, packDir?: string): Promise<Outcome<string>>;
+/** The oldest JDK a JVM pack runs on (kindgi-pack's baseline). */
+export declare const MIN_JAVA_MAJOR = 17;
+/**
+ * Check a JVM pack's JDK (17 or later) and its build tool (Maven or sbt)
+ * start, with the pack's environment — so a missing JDK or build tool is one
+ * clear line at boot instead of a build failure. Whether the pack has
+ * kindgi-pack shows at its first build.
+ */
+export declare function checkPackJvm(code: JvmPackCode, env: Readonly<Record<string, string>>, packDir?: string): Promise<Outcome<string>>;
+/** `17.0.6` → 17; `1.8.0_392` → 8. */
+export declare function javaMajor(version: string): number | undefined;
 export {};
 //# sourceMappingURL=pack-code.d.ts.map

package/dist/dev/pack-code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pack-code.d.ts","sourceRoot":"","sources":["../../src/dev/pack-code.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,sFAAsF;AACtF,MAAM,MAAM,QAAQ,GAChB;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC;AAErF,eAAO,MAAM,cAAc,EAAE,QAA+B,CAAC;AAE7D,KAAK,OAAO,CAAC,CAAC,IACV;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC1C;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GACpD,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,CA+BlD;AAED,8EAA8E;AAC9E,wBAAsB,eAAe,CACnC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GACpD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAK5B;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EACtC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACrC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAyD1B"}
+{"version":3,"file":"pack-code.d.ts","sourceRoot":"","sources":["../../src/dev/pack-code.ts"],"names":[],"mappings":"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"}

package/dist/dev/pack-code.js

@@ -8,13 +8,35 @@
  *             Node pack service (`@kindgi/handler-runtime`).
  *   - python: no bundling, `python -m kindgi.pack index` and
  *             `python -m kindgi.pack serve` with the pack's own interpreter.
+ *   - java:   Maven compiles the pack (`java-builder.ts`), then
+ *             `com.kindgi.pack.Main index` and `… serve` (through the
+ *             launcher, `kindgi-pack-java`) with the pack's JDK.
+ *   - scala:  sbt compiles the pack through its server (`scala-builder.ts`),
+ *             then the same as Java: kindgi-pack indexes and serves it.
  *
- * Both run under the pack's environment (`devPackEnv`) and behind the same
+ * All run under the pack's environment (`devPackEnv`) and behind the same
  * supervisor and front, so the api-server never knows which it is.
  */
 import { spawn } from 'node:child_process';
 import { access, stat } from 'node:fs/promises';
 import { join } from 'node:path';
+import { devJvmDir } from './paths.js';
+/** Whether the pack's code runs on the JVM: kindgi-pack indexes and serves it. */
+export function isJvmPackCode(code) {
+    return code?.language === 'java' || code?.language === 'scala';
+}
+/** The `@argfile` passing a JVM pack's classpath to `java` (written by its builder). */
+export function javaArgsFile(code) {
+    return join(code.workDir, 'java.args');
+}
+/** The launcher (`kindgi-pack-java`) extracted from the pack's kindgi-pack jar. */
+export function javaLauncher(code) {
+    return join(code.workDir, 'kindgi-pack-java');
+}
+/** The environment a JVM pack's children run with: the pack's, plus its JDK as `JAVA_HOME`. */
+export function javaEnv(code, env) {
+    return code.javaHome === undefined ? env : { ...env, JAVA_HOME: code.javaHome };
+}
 export const NODE_PACK_CODE = { language: 'node' };
 /**
  * The interpreter that runs a Python pack:
@@ -53,10 +75,144 @@ export async function resolvePackPython(packDir, config) {
     }
     return { kind: 'ok', value: ['python3'] };
 }
-/** The pack code for a language, with the interpreter resolved for Python. */
-export async function resolvePackCode(language, packDir, config) {
+/**
+ * The JDK and the Maven that run and build a Java pack:
+ *
+ *   - the JDK: `dev.javaHome` in the config, else `JAVA_HOME`, else `java`
+ *     on `PATH`;
+ *   - Maven: `dev.maven` (an argv, such as `["mvn", "-s", "settings.xml"]`),
+ *     else the pack's wrapper (`mvnw`, run with `sh`), else `mvn` on `PATH`.
+ *
+ * A Java pack's service starts through a POSIX shell script (the launcher
+ * keeps its token out of the JVM's environment): on Windows, `kindgi dev`
+ * runs it under WSL.
+ */
+export async function resolvePackJava(packDir, config, hostEnv, platform = process.platform) {
+    const runtime = resolveJvmRuntime('java', packDir, config, hostEnv, platform);
+    if (runtime.kind === 'err')
+        return runtime;
+    const configuredMaven = devSettings(config).maven;
+    let maven;
+    if (configuredMaven !== undefined) {
+        const argv = commandArgv(configuredMaven);
+        if (argv === undefined) {
+            return {
+                kind: 'err',
+                message: '`dev.maven` must be a command or a non-empty command list (e.g. ["mvn", "-s", "settings.xml"]).',
+            };
+        }
+        maven = argv;
+    }
+    else if (await isFile(join(packDir, 'mvnw'))) {
+        maven = ['sh', join(packDir, 'mvnw')];
+    }
+    else {
+        maven = ['mvn'];
+    }
+    const mavenEnv = {};
+    for (const name of ['MAVEN_ARGS', 'MAVEN_OPTS']) {
+        const value = hostEnv[name];
+        if (value !== undefined && value !== '')
+            mavenEnv[name] = value;
+    }
+    return {
+        kind: 'ok',
+        value: {
+            language: 'java',
+            ...runtime.value,
+            maven,
+            ...(Object.keys(mavenEnv).length > 0 && { mavenEnv }),
+        },
+    };
+}
+/**
+ * The JDK and the sbt that run and build a Scala pack:
+ *
+ *   - the JDK, as for a Java pack: `dev.javaHome`, else `JAVA_HOME`, else
+ *     `java` on `PATH`;
+ *   - sbt: `dev.sbt` (an argv, such as `["sbt", "-Dsbt.override.build.repos=true"]`),
+ *     else `sbt` on `PATH`. Builds go through its server (`sbt --client`),
+ *     so a save compiles without starting a JVM.
+ */
+export async function resolvePackScala(packDir, config, hostEnv, platform = process.platform) {
+    const runtime = resolveJvmRuntime('scala', packDir, config, hostEnv, platform);
+    if (runtime.kind === 'err')
+        return runtime;
+    const configuredSbt = devSettings(config).sbt;
+    let sbt = ['sbt'];
+    if (configuredSbt !== undefined) {
+        const argv = commandArgv(configuredSbt);
+        if (argv === undefined) {
+            return {
+                kind: 'err',
+                message: '`dev.sbt` must be a command or a non-empty command list (e.g. ["sbt", "-mem", "2048"]).',
+            };
+        }
+        sbt = argv;
+    }
+    const sbtOpts = hostEnv.SBT_OPTS;
+    return {
+        kind: 'ok',
+        value: {
+            language: 'scala',
+            ...runtime.value,
+            sbt,
+            ...(sbtOpts !== undefined && sbtOpts !== '' && { sbtEnv: { SBT_OPTS: sbtOpts } }),
+        },
+    };
+}
+/** A config's `dev` table, or an empty one. */
+function devSettings(config) {
+    const dev = config?.dev;
+    return dev !== null && typeof dev === 'object' ? dev : {};
+}
+/** A configured command (a string, or a non-empty list of non-empty strings) as an argv; undefined when it's neither. */
+function commandArgv(configured) {
+    const argv = typeof configured === 'string' ? [configured] : configured;
+    return Array.isArray(argv) &&
+        argv.length > 0 &&
+        argv.every((part) => typeof part === 'string' && part !== '')
+        ? argv
+        : undefined;
+}
+/**
+ * The JDK every JVM pack runs on: `dev.javaHome`, else `JAVA_HOME`, else
+ * `java` on `PATH`. A JVM pack's service starts through a POSIX shell script
+ * (the launcher keeps its token out of the JVM's environment): on Windows,
+ * `kindgi dev` runs it under WSL.
+ */
+function resolveJvmRuntime(language, packDir, config, hostEnv, platform) {
+    const name = language === 'java' ? 'Java' : 'Scala';
+    if (platform === 'win32') {
+        return {
+            kind: 'err',
+            message: `a ${name} pack's service starts through a POSIX shell script (kindgi-pack-java), so on Windows run kindgi dev under WSL.`,
+        };
+    }
+    const configuredHome = devSettings(config).javaHome;
+    if (configuredHome !== undefined &&
+        (typeof configuredHome !== 'string' || configuredHome === '')) {
+        return { kind: 'err', message: '`dev.javaHome` must be the path of a JDK (17 or later).' };
+    }
+    const javaHome = configuredHome ??
+        (hostEnv.JAVA_HOME !== undefined && hostEnv.JAVA_HOME !== '' ? hostEnv.JAVA_HOME : undefined);
+    return {
+        kind: 'ok',
+        value: {
+            java: javaHome === undefined ? 'java' : join(javaHome, 'bin', 'java'),
+            ...(javaHome !== undefined && { javaHome }),
+            workDir: devJvmDir(packDir, language),
+        },
+    };
+}
+/** The pack code for a language, with the interpreter or the JDK resolved. */
+export async function resolvePackCode(language, packDir, config, hostEnv = process.env) {
     if (language === 'node')
         return { kind: 'ok', value: NODE_PACK_CODE };
+    if (language === 'java')
+        return resolvePackJava(packDir, config, hostEnv);
+    if (language === 'scala')
+        return resolvePackScala(packDir, config, hostEnv);
     const python = await resolvePackPython(packDir, config);
     if (python.kind === 'err')
         return python;
@@ -118,6 +274,109 @@ export async function checkPackPython(python, env, packDir) {
         value: `Python ${pythonVersion ?? '?'} · kindgi ${kindgiVersion ?? '?'} (${shown})`,
     };
 }
+/** The oldest JDK a JVM pack runs on (kindgi-pack's baseline). */
+export const MIN_JAVA_MAJOR = 17;
+/**
+ * Check a JVM pack's JDK (17 or later) and its build tool (Maven or sbt)
+ * start, with the pack's environment — so a missing JDK or build tool is one
+ * clear line at boot instead of a build failure. Whether the pack has
+ * kindgi-pack shows at its first build.
+ */
+export async function checkPackJvm(code, env, packDir) {
+    const childEnv = javaEnv(code, env);
+    const jdk = await checkJdk(code, childEnv, packDir);
+    if (jdk.kind === 'err')
+        return jdk;
+    const tool = code.language === 'scala'
+        ? await checkTool(code.sbt, ['--script-version'], { ...childEnv, ...code.sbtEnv }, packDir, {
+            name: 'sbt',
+            version: /(\d+\.\d+\.\d+\S*)/,
+            setting: 'dev.sbt',
+            install: 'Install sbt 1.10 or later (https://www.scala-sbt.org/download),',
+        })
+        : await checkTool(code.maven, ['--version'], { ...childEnv, ...code.mavenEnv }, packDir, {
+            name: 'Maven',
+            version: /Apache Maven (\S+)/,
+            setting: 'dev.maven',
+            install: 'Add the Maven wrapper to the pack (mvn wrapper:wrapper), install Maven 3.9 or later,',
+        });
+    if (tool.kind === 'err')
+        return tool;
+    return {
+        kind: 'ok',
+        value: `Java ${jdk.value} · ${tool.value} (${code.javaHome ?? code.java}; ${(code.language === 'scala' ? code.sbt : code.maven).join(' ')})`,
+    };
+}
+/** The pack's JDK starts and is 17 or later: its version. */
+async function checkJdk(code, env, packDir) {
+    const java = await run(code.java, ['-version'], env, packDir);
+    if (java.spawnError !== undefined) {
+        return {
+            kind: 'err',
+            message: [
+                `the pack's JDK (${code.java}) did not start: ${java.spawnError}`,
+                `    Install a JDK ${MIN_JAVA_MAJOR} or later (e.g. Eclipse Temurin), and set JAVA_HOME to it,`,
+                '    or point `dev.javaHome` in kindgi.config.json at one.',
+            ].join('\n'),
+        };
+    }
+    const version = /version "([^"]+)"/.exec(`${java.stderr}\n${java.stdout}`)?.[1];
+    const major = version === undefined ? undefined : javaMajor(version);
+    if (version === undefined || major === undefined || major < MIN_JAVA_MAJOR) {
+        return {
+            kind: 'err',
+            message: [
+                `the pack's JDK (${code.java}) is ${version ?? 'of an unknown version'}; a ${code.language === 'java' ? 'Java' : 'Scala'} pack needs ${MIN_JAVA_MAJOR} or later.`,
+                '    Set JAVA_HOME to a newer JDK, or point `dev.javaHome` in kindgi.config.json at one.',
+            ].join('\n'),
+        };
+    }
+    return { kind: 'ok', value: version };
+}
+/** The pack's build tool runs: its name and version (`Maven 3.9.9`, `sbt 1.12.15`). */
+async function checkTool(argv, versionArgs, env, packDir, about) {
+    const [program, ...prefix] = argv;
+    const result = await run(program, [...prefix, ...versionArgs], env, packDir);
+    if (result.spawnError !== undefined || result.code !== 0) {
+        const detail = result.spawnError ?? (result.stderr.trim() || result.stdout.trim()).split('\n').pop();
+        return {
+            kind: 'err',
+            message: [
+                `the pack's ${about.name} (${argv.join(' ')}) did not run: ${detail ?? ''}`,
+                `    ${about.install}`,
+                `    or point \`${about.setting}\` in kindgi.config.json at one.`,
+            ].join('\n'),
+        };
+    }
+    return { kind: 'ok', value: `${about.name} ${about.version.exec(result.stdout)?.[1] ?? '?'}` };
+}
+/** `17.0.6` → 17; `1.8.0_392` → 8. */
+export function javaMajor(version) {
+    const parts = version.split(/[.+_-]/);
+    const first = Number(parts[0]);
+    if (!Number.isInteger(first))
+        return undefined;
+    return first === 1 ? Number(parts[1]) : first;
+}
+function run(program, args, env, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn(program, [...args], {
+            env,
+            ...(cwd !== undefined && { cwd }),
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let out = '';
+        let err = '';
+        child.stdout.on('data', (chunk) => {
+            out += chunk.toString('utf8');
+        });
+        child.stderr.on('data', (chunk) => {
+            err += chunk.toString('utf8');
+        });
+        child.once('error', (cause) => resolve({ code: null, stdout: out, stderr: err, spawnError: cause.message }));
+        child.once('close', (exit) => resolve({ code: exit, stdout: out, stderr: err }));
+    });
+}
 async function isFile(path) {
     try {
         return (await stat(path)).isFile();