A local-first multi-agent app development platform, built on PenguinHarness
/**
* `penguin server status` — this data root's server state and machine id, as one line of
* JSON.
*
* Machine-facing on purpose: a CONTROLLER runs it over ssh to ask a machine what it is doing,
* and JSON is what spares that controller a parser for a format nobody defined. It answers
* whether or not a server is running (the data root is the source, not a live process), which
* is what makes it usable as a status probe rather than only a health check.
* Docs: /docs/cli § "penguin server / penguin web".
*/
import path from "node:path";
import { boundaryEnv } from "@adelie/core";
import { readMachineStatus } from "@adelie/server/machine-status";
import type { Command } from "commander";
import type { Messages } from "../i18n.js";
import { resolveRootOption } from "../root-option.js";
/** Attaches the subcommand to the `penguin server` command (see registerServeCommands). */
export function registerStatusCommand(server: Command, t: Messages): void {
server
.command("status")
.description(t.serverStatus.desc)
.option("--root <dir>", t.common.root)
.action(async (opts: { root?: string }) => {
const root = resolveRootOption(opts.root);
// ADELIE_WEB_DB (or its pre-rename spelling) honored as everywhere else, or this reads an
// identity out of a database the live server never writes to.
const dbPath = boundaryEnv(process.env, "webDb") ?? path.join(root, "web.db");
process.stdout.write(JSON.stringify(await readMachineStatus(root, dbPath)) + "\n");
});
}