@tianshu-ai/tianshu 0.3.0

package/packages/server/dist/setup/service.js

@@ -0,0 +1,345 @@
+// `tianshu start|stop|restart|status` — service lifecycle on
+// the host's process supervisor.
+//
+// macOS: backed by launchd via launchd.ts.
+// Linux / Windows: graceful "not implemented yet — here's the
+//   command you'd run by hand" message. The wizard's
+//   start-server.ts already has the same fallback for install;
+//   we keep parity here so users get a consistent experience.
+//
+// Why these as separate commands rather than baking them into
+// `tianshu setup --wizard`:
+//   - day 2 you want `tianshu restart` after editing config; you
+//     don't want to walk through the whole wizard
+//   - `tianshu status` is the cheap "is it up?" check; doctor
+//     does the deep version
+//   - keeps the wizard focused on first-time install
+//
+// Note: install (writing the plist + bootstrapping the first
+// time) lives in start-server.ts because it needs to interact
+// with port selection, .env writes, and the wizard's prompt UI.
+// `tianshu start` here only operates on an *already installed*
+// agent — if the plist doesn't exist, we tell the user to run
+// the wizard.
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import * as launchd from "./launchd.js";
+import { findRepoRoot } from "./repo-root.js";
+import { loadGlobalConfig } from "../core/config.js";
+const DEFAULT_SERVER_PORT = 3110;
+// 120 seconds. Cold-start the dev server has to: npm-build
+// plugin-sdk, build 4 plugins, sync builtin configs, run
+// dev-builtins migration, tsx watch + compile server src,
+// then plugins activate. Observed: 90-110s on M3 Ultra (faster)
+// and 60-90s on slower Intel macs. The previous 60s deadline
+// hit `timed out` regularly even though the server came up
+// 30s later. Match the wizard's deadline (start-server.ts) to
+// stay consistent.
+const HEALTH_DEADLINE_MS = 120_000;
+/**
+ * Resolve the server port the same way the wizard / network
+ * doctor does — env first, then global config, then default.
+ * Used by `tianshu status` to know where to probe health.
+ */
+function resolveServerPort(repoRoot) {
+    const env = Number.parseInt(process.env.PORT ?? "", 10);
+    if (Number.isFinite(env) && env > 0)
+        return env;
+    try {
+        const cfg = loadGlobalConfig();
+        if (cfg.server?.port)
+            return cfg.server.port;
+    }
+    catch {
+        // no global config yet
+    }
+    // We don't read .env here — the doctor's checkNetwork is the
+    // authoritative source for that, and it runs in a different
+    // process. For the CLI, env + global config + default is
+    // good enough.
+    void repoRoot;
+    return DEFAULT_SERVER_PORT;
+}
+/**
+ * `tianshu status` — print whether the service is installed,
+ * loaded, running, and responding to /api/health.
+ *
+ * Exit codes:
+ *   0 → installed AND loaded AND health OK
+ *   1 → installed but not loaded / not responding
+ *   2 → not installed
+ */
+export async function runStatus(opts = {}) {
+    if (os.platform() !== "darwin") {
+        console.log("tianshu status: service management isn't implemented on this OS yet.");
+        return 1;
+    }
+    const repoRoot = opts.repoRoot ?? findRepoRoot();
+    const label = launchd.resolveLabel(repoRoot);
+    const status = launchd.readStatus(label);
+    const port = resolveServerPort(repoRoot);
+    const health = status.loaded
+        ? await launchd.probeHealth(port)
+        : { ok: false, reason: "service not loaded" };
+    if (opts.json) {
+        console.log(JSON.stringify({
+            label,
+            plistPath: status.plistPath,
+            installed: status.installed,
+            loaded: status.loaded,
+            pid: status.pid,
+            lastExitStatus: status.lastExitStatus,
+            serverPort: port,
+            health,
+        }, null, 2));
+    }
+    else {
+        const lines = [];
+        lines.push(`label:        ${label}`);
+        lines.push(`plist:        ${status.plistPath}`);
+        lines.push(`installed:    ${status.installed ? "yes" : "no"}`);
+        lines.push(`loaded:       ${status.loaded ? "yes" : "no"}`);
+        if (status.pid !== null)
+            lines.push(`pid:          ${status.pid}`);
+        if (status.lastExitStatus !== null)
+            lines.push(`last exit:    ${status.lastExitStatus}`);
+        lines.push(`server port:  ${port}`);
+        if (health.ok) {
+            lines.push(`health:       ok (status=${health.status}, uptime=${health.uptimeSec ?? "?"}s, tenants=${health.tenants ?? "?"})`);
+        }
+        else {
+            lines.push(`health:       not responding (${health.reason ?? "?"})`);
+        }
+        if (!status.installed) {
+            lines.push("");
+            lines.push("Service isn't installed. Run `tianshu setup --wizard` to install.");
+        }
+        else if (!status.loaded) {
+            lines.push("");
+            lines.push("Service is installed but not loaded. Start it with:");
+            lines.push("  tianshu start");
+        }
+        console.log(lines.join("\n"));
+    }
+    if (!status.installed)
+        return 2;
+    if (!status.loaded || !health.ok)
+        return 1;
+    return 0;
+}
+/**
+ * `tianshu start` — bootstrap the launchd agent.
+ * No-op (with friendly message) if already loaded.
+ */
+export async function runStart(opts = {}) {
+    if (os.platform() !== "darwin") {
+        console.log("tianshu start: not implemented on this OS yet. Run `npm run dev` from the checkout.");
+        return 1;
+    }
+    const repoRoot = opts.repoRoot ?? findRepoRoot();
+    const label = launchd.resolveLabel(repoRoot);
+    const status = launchd.readStatus(label);
+    if (!status.installed) {
+        console.error(`Service '${label}' isn't installed (no plist at ${status.plistPath}).`);
+        console.error("Run `tianshu setup --wizard` to install.");
+        return 2;
+    }
+    if (status.loaded) {
+        console.log(`Service '${label}' is already loaded (pid ${status.pid ?? "?"}). ` +
+            "Use `tianshu restart` to bounce it.");
+        return 0;
+    }
+    const r = launchd.bootstrap(status.plistPath);
+    if (!r.ok) {
+        console.error(`launchctl bootstrap failed: ${r.stderr ?? "(unknown)"}`);
+        return 1;
+    }
+    console.log(`Loaded ${label}.`);
+    if (opts.wait !== false) {
+        const port = resolveServerPort(repoRoot);
+        const deadlineMs = opts.waitMs ?? HEALTH_DEADLINE_MS;
+        const ok = await waitWithProgress(port, deadlineMs);
+        if (!ok) {
+            console.error(`\nServer didn't respond within ${deadlineMs / 1000}s. Check logs:`);
+            console.error(`  tianshu logs --stream=err`);
+            console.error(`  tail -f ${launchd.logPathsFor(label).err}`);
+            return 1;
+        }
+    }
+    return 0;
+}
+/**
+ * Render "Waiting for /api/health on :3110... [12s elapsed]"
+ * with the elapsed counter overwriting itself each second.
+ * Users / agents watching the wait can see we're alive and how
+ * long they've waited — first-time installs commonly take
+ * 90+s, easy to think things wedged otherwise.
+ */
+async function waitWithProgress(port, deadlineMs) {
+    const prefix = `Waiting for /api/health on :${port}...`;
+    process.stdout.write(prefix);
+    let lastLine = prefix.length;
+    const ok = await launchd.waitForHealth(port, deadlineMs, (elapsedMs) => {
+        const elapsedSec = Math.floor(elapsedMs / 1000);
+        const totalSec = Math.floor(deadlineMs / 1000);
+        const next = ` ${elapsedSec}s / ${totalSec}s`;
+        // Carriage return + overwrite. Pad to last width to clear
+        // older digits if the new line is shorter.
+        process.stdout.write(`\r${prefix}${next}`);
+        lastLine = prefix.length + next.length;
+        void lastLine;
+    });
+    process.stdout.write(ok ? " up.\n" : " timed out.\n");
+    return ok;
+}
+/**
+ * `tianshu stop` — bootout the launchd agent. Plist stays put;
+ * use the wizard's uninstall path (TODO) to fully remove.
+ */
+export async function runStop(opts = {}) {
+    if (os.platform() !== "darwin") {
+        console.log("tianshu stop: not implemented on this OS yet. Stop your `npm run dev` process manually.");
+        return 1;
+    }
+    const repoRoot = opts.repoRoot ?? findRepoRoot();
+    const label = launchd.resolveLabel(repoRoot);
+    const status = launchd.readStatus(label);
+    if (!status.loaded) {
+        console.log(`Service '${label}' is not loaded — nothing to stop.`);
+        return 0;
+    }
+    const r = launchd.bootout(label);
+    if (!r.ok) {
+        console.error(`launchctl bootout failed: ${r.stderr ?? "(unknown)"}`);
+        return 1;
+    }
+    console.log(`Stopped ${label}.`);
+    return 0;
+}
+/**
+ * `tianshu restart` — `launchctl kickstart -k`. Faster than
+ * stop-then-start because it doesn't rebootstrap the plist.
+ */
+/**
+ * `tianshu logs` — print the launchd agent's stdout / stderr
+ * logs. Default: last 50 lines from both streams. With
+ * `--follow`, we exec `tail -f` so the user gets streaming
+ * output (and Ctrl-C falls through naturally).
+ *
+ * Why this command exists: when `tianshu start` says "Server
+ * didn't respond within 120s", the next thing both the user
+ * and a debugging agent want is the actual error from the
+ * failed boot. Without `tianshu logs`, you have to know the
+ * label *and* the convention that logs live in $TMPDIR. Now
+ * it's just `tianshu logs` (or `tianshu logs --follow`).
+ */
+export async function runLogs(opts = {}) {
+    if (os.platform() !== "darwin") {
+        console.log("tianshu logs: not implemented on this OS yet. Read the dev server's stdout directly.");
+        return 1;
+    }
+    const repoRoot = opts.repoRoot ?? findRepoRoot();
+    const label = launchd.resolveLabel(repoRoot);
+    const { out, err } = launchd.logPathsFor(label);
+    const stream = opts.stream ?? "both";
+    const lines = opts.lines ?? 50;
+    // Pick which files we care about, in print order.
+    const files = [];
+    if (stream === "both" || stream === "err")
+        files.push(err);
+    if (stream === "both" || stream === "out")
+        files.push(out);
+    // Friendly preflight — if neither file exists, give the user
+    // an actionable message rather than letting `tail` print
+    // "No such file". Most common reason: service was never
+    // installed on this machine.
+    const present = files.filter((f) => fs.existsSync(f));
+    if (present.length === 0) {
+        console.error(`No log files found for service '${label}'.`);
+        console.error(`  expected: ${err}`);
+        console.error(`            ${out}`);
+        const status = launchd.readStatus(label);
+        if (!status.installed) {
+            console.error("\nService isn't installed. Run `tianshu setup --wizard` first.");
+        }
+        else if (!status.loaded) {
+            console.error("\nService is installed but never started. Try `tianshu start`.");
+        }
+        else {
+            console.error("\nService is loaded but hasn't written any logs yet. Wait a few seconds and retry.");
+        }
+        return 1;
+    }
+    if (opts.follow) {
+        // Hand off to `tail -f`. We use spawn (not exec) so the
+        // user's Ctrl-C kills tail directly; `tail` then exits and
+        // we propagate its code. -F (capital) re-opens on rotation,
+        // which matters when KeepAlive bounces the agent and
+        // launchd truncates / replaces the log file.
+        return new Promise((resolve) => {
+            const args = ["-n", String(lines), "-F", ...present];
+            const child = spawn("tail", args, { stdio: "inherit" });
+            child.on("error", (e) => {
+                console.error(`tail failed: ${e.message}`);
+                resolve(1);
+            });
+            child.on("exit", (code) => resolve(code ?? 0));
+        });
+    }
+    // Non-follow: print the last N lines from each file with a
+    // header so the user can tell which stream they're reading.
+    for (const f of present) {
+        const label = f === err ? "stderr" : "stdout";
+        console.log(`==> ${label} (${f}) <==`);
+        console.log(tailFile(f, lines));
+        console.log("");
+    }
+    return 0;
+}
+function tailFile(filepath, n) {
+    try {
+        const body = fs.readFileSync(filepath, "utf8");
+        return body.split(/\r?\n/).slice(-n).join("\n");
+    }
+    catch (e) {
+        return `(unreadable: ${e.message})`;
+    }
+}
+export async function runRestart(opts = {}) {
+    if (os.platform() !== "darwin") {
+        console.log("tianshu restart: not implemented on this OS yet.");
+        return 1;
+    }
+    const repoRoot = opts.repoRoot ?? findRepoRoot();
+    const label = launchd.resolveLabel(repoRoot);
+    const status = launchd.readStatus(label);
+    if (!status.installed) {
+        console.error(`Service '${label}' isn't installed.`);
+        console.error("Run `tianshu setup --wizard` to install.");
+        return 2;
+    }
+    if (!status.loaded) {
+        // kickstart on a not-loaded service errors. Prefer the
+        // start path (which bootstraps).
+        return runStart(opts);
+    }
+    const r = launchd.kickstart(label);
+    if (!r.ok) {
+        console.error(`launchctl kickstart failed: ${r.stderr ?? "(unknown)"}`);
+        return 1;
+    }
+    console.log(`Restarted ${label}.`);
+    if (opts.wait !== false) {
+        const port = resolveServerPort(repoRoot);
+        const deadlineMs = opts.waitMs ?? HEALTH_DEADLINE_MS;
+        const ok = await waitWithProgress(port, deadlineMs);
+        if (!ok) {
+            console.error(`\nIf this is a fresh build the cold start can exceed ${deadlineMs / 1000}s.`);
+            console.error(`Check logs:  tianshu logs --stream=err`);
+            return 1;
+        }
+    }
+    return 0;
+}
+//# sourceMappingURL=service.js.map

package/packages/server/dist/setup/service.js.map

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

package/packages/server/dist/setup/start-server.d.ts

@@ -0,0 +1,23 @@
+interface StartServerOpts {
+    /** Repo root (used as cwd for `npm run dev`). Defaults to process.cwd(). */
+    repoRoot?: string;
+    /** Path to the .env file we write PORT / WEB_PORT into. */
+    envPath?: string;
+}
+/**
+ * Run the start-server step. Idempotent: bails out cleanly if
+ * the user says "no, I'll start it myself", and detects an
+ * existing launchd agent so re-running the wizard doesn't
+ * create duplicates.
+ */
+export interface StartServerResult {
+    /** http://localhost:<port> when the server is up, null when skipped. */
+    serverUrl: string | null;
+    /** Web UI URL (vite). null when skipped. */
+    webUrl: string | null;
+    /** True when the user accepted auto-start AND health-check passed. */
+    started: boolean;
+}
+export declare function runStartServer(opts?: StartServerOpts): Promise<StartServerResult>;
+export {};
+//# sourceMappingURL=start-server.d.ts.map

package/packages/server/dist/setup/start-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-server.d.ts","sourceRoot":"","sources":["../../src/setup/start-server.ts"],"names":[],"mappings":"AA4BA,UAAU,eAAe;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;CAClB;AAQD,wBAAsB,cAAc,CAClC,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAgM5B"}