@phreshos/cli 0.1.6 → 0.1.7

package/README.md

@@ -41,6 +41,7 @@ System.
 phresh system install
 phresh system uninstall
 phresh system status
+phresh system version
 phresh system start
 phresh system stop
 phresh system enable
@@ -59,9 +60,9 @@ It never reads a source checkout and never requires Bun or TypeScript.
 The System runs under `launchd` on macOS and `systemd --user` on Linux. The
 native manager owns it after the CLI exits and restarts a failed active
 service. `start` and `stop` change current execution only; `enable` and
-`disable` change automatic startup only. `status` reads installation,
-registration, startup, process, and local-intake readiness without changing
-any of them.
+`disable` change automatic startup only. `status` reports the installed version,
+service readiness, and automatic startup without changing them; `version`
+reports only the installed System release.
 
 Installation files and persistent System state have separate homes. Removing
 the System unregisters its service and removes its release files while keeping

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { Command, Option } from "commander";
 import metadata from "../package.json" with { type: "json" };
-import { PromptCancelled } from "./prompts.js";
+import { PromptCancelled, ReportedFailure } from "./prompts.js";
 import create from "./create.js";
 import install from "./install.js";
 import launch from "./launch.js";
@@ -17,7 +17,11 @@ const program = new Command()
     .description("Create Programs and manage PhreshOS")
     .version(version, "-v, --version")
     .showHelpAfterError()
-    .showSuggestionAfterError();
+    .showSuggestionAfterError()
+    .configureOutput({
+    writeOut: value => process.stdout.write(spaced(value)),
+    writeErr: value => process.stderr.write(spaced(value))
+});
 program.addHelpText("after", "\nRun phresh <command> --help for detailed command guidance.\n");
 describe(program.command("create")
     .description("create a new Program project")
@@ -119,11 +123,18 @@ try {
 catch (error) {
     if (error instanceof PromptCancelled)
         process.exitCode = 0;
+    else if (error instanceof ReportedFailure)
+        process.exitCode = 1;
     else {
         console.error(`\n  phresh: ${error instanceof Error ? error.message : String(error)}\n`);
         process.exitCode = 1;
     }
 }
+function spaced(value) {
+    if (value.endsWith("\n\n"))
+        return value;
+    return value.endsWith("\n") ? `${value}\n` : `${value}\n\n`;
+}
 function attached(name, summary, detail, mode) {
     describe(program.command(name)
         .description(summary)

package/dist/create.js

@@ -60,6 +60,7 @@ export default async function create(options = {}, directory = process.cwd()) {
     console.log(bold(`\n${bundled.development ? "Run Development Program" : "Run Program"}`));
     console.log(accent(script));
     console.log(bold("\nYou can now open the project and start building your Program"));
+    console.log("");
 }
 function template() {
     const candidates = [

package/dist/prompts.js

@@ -1,9 +1,12 @@
 import { cancel, confirm, intro, isCancel, log, outro, select, spinner, text } from "@clack/prompts";
 import colors from "picocolors";
-import { column, heading, line } from "./style.js";
+import { caution, column, ending, line, section } from "./style.js";
 /** Signals an ordinary interactive cancellation rather than an operation failure. */
 export class PromptCancelled extends Error {
 }
+/** An unsuccessful command whose complete explanation has already been shown. */
+export class ReportedFailure extends Error {
+}
 /**
  * One interaction language shared by commands that can ask questions.
  *
@@ -16,26 +19,32 @@ export default function prompts() {
         if (interactive)
             intro(`${colors.bold(title)}${context ? ` ${colors.dim(`· ${context}`)}` : ""}`);
         else
-            heading(title, context);
+            section(title, context);
     }
     function finish(message) {
         if (interactive)
             outro(colors.bold(message));
         else
-            heading(message);
+            ending(message);
     }
     function detail(label, value, source) {
         if (interactive)
-            log.message(`${colors.dim(column(label))}${value}${source ? `  ${colors.dim(source)}` : ""}`);
+            log.message(`${colors.dim(column(label))}${value}${source ? `  ${colors.dim(source)}` : ""}`, { spacing: 0 });
         else
             line(label, value, source);
     }
     function message(value = "") {
         if (interactive)
-            log.message(value);
+            log.message(value, { spacing: 0 });
         else
             console.log(value ? `  ${value}` : "");
     }
+    function warning(value) {
+        if (interactive)
+            log.warning(value, { spacing: 0 });
+        else
+            line("warning", caution(value));
+    }
     async function progress(message, completed, work) {
         if (!interactive)
             return await work();
@@ -55,7 +64,7 @@ export default function prompts() {
     async function ask(explanation, question, fallback) {
         if (!interactive)
             throw new Error(`${question} Supply the corresponding option when no terminal is attached`);
-        log.message(colors.dim(explanation));
+        log.message(colors.dim(explanation), { spacing: 0 });
         const value = await text({
             message: question,
             placeholder: fallback,
@@ -68,7 +77,7 @@ export default function prompts() {
     async function yes(explanation, question, fallback) {
         if (!interactive)
             throw new Error(`${question} Supply the corresponding option when no terminal is attached`);
-        log.message(colors.dim(explanation));
+        log.message(colors.dim(explanation), { spacing: 0 });
         const value = await confirm({ message: question, initialValue: fallback });
         if (isCancel(value))
             stop();
@@ -77,7 +86,7 @@ export default function prompts() {
     async function choose(explanation, question, values, fallback) {
         if (!interactive)
             throw new Error(`${question} Supply the corresponding option when no terminal is attached`);
-        log.message(colors.dim(explanation));
+        log.message(colors.dim(explanation), { spacing: 0 });
         const value = await select({
             message: question,
             options: values.map(value => ({ value, label: value })),
@@ -97,6 +106,7 @@ export default function prompts() {
         finish,
         detail,
         message,
+        warning,
         progress,
         ask,
         yes,

package/dist/style.js

@@ -3,6 +3,9 @@ import colors from "picocolors";
 export const dim = colors.dim;
 export const bold = colors.bold;
 export const accent = colors.cyan;
+export const positive = colors.green;
+export const caution = colors.yellow;
+export const negative = colors.red;
 // A label, what it says, and where that came from. The label is quiet
 // and the value is not, because the value is the thing being reported.
 //
@@ -17,6 +20,13 @@ export function column(label) {
 }
 export function heading(title, note) {
     console.log("");
+    section(title, note);
+    console.log("");
+}
+export function section(title, note) {
     console.log(`  ${bold(title)}${note ? `  ${dim("·")}  ${dim(note)}` : ""}`);
+}
+export function ending(message) {
+    console.log(`  ${bold(message)}`);
     console.log("");
 }

package/dist/system/command.js

@@ -1,5 +1,6 @@
 import SystemLifecycle from "./lifecycle.js";
-import prompts from "../prompts.js";
+import prompts, { ReportedFailure } from "../prompts.js";
+import { accent, caution, dim, negative, positive } from "../style.js";
 /** Attach the System lifecycle without mixing it with Program commands. */
 export default function systemCommands(program, provided) {
     let lifecycle = provided;
@@ -11,8 +12,7 @@ export default function systemCommands(program, provided) {
         const interaction = prompts();
         interaction.begin("Install System", "official stable release");
         const status = await interaction.progress("Installing PhreshOS", "PhreshOS installed", () => current().install());
-        report(interaction, status);
-        interaction.finish("System installed");
+        interaction.finish(`PhreshOS ${accent(status.installed?.version ?? "")} installed`);
     });
     system.command("uninstall")
         .description("remove the System installation and service")
@@ -24,37 +24,63 @@ export default function systemCommands(program, provided) {
         interaction.finish("System uninstalled");
     });
     system.command("status")
-        .description("show installation, service, and readiness state")
+        .description("show the System version and operating state")
         .action(async function () {
+        const status = await installed(current());
         const interaction = prompts();
         interaction.begin("System Status");
-        report(interaction, await current().status());
+        report(interaction, status);
+        interaction.finish(status.ready ? positive("System ready") : caution("System not ready"));
+    });
+    system.command("version")
+        .description("show the installed System version")
+        .action(async function () {
+        const status = await installed(current());
+        const interaction = prompts();
+        interaction.begin("System Version");
+        interaction.finish(`PhreshOS ${accent(status.installed.version)}`);
     });
-    action(system, "start", "start the background service", () => current().start());
-    action(system, "stop", "stop the background service", () => current().stop());
-    action(system, "enable", "enable automatic startup", () => current().enable());
-    action(system, "disable", "disable automatic startup", () => current().disable());
+    action(system, "start", "start the background service", current, lifecycle => lifecycle.start());
+    action(system, "stop", "stop the background service", current, lifecycle => lifecycle.stop());
+    action(system, "enable", "enable automatic startup", current, lifecycle => lifecycle.enable());
+    action(system, "disable", "disable automatic startup", current, lifecycle => lifecycle.disable());
     return system;
 }
-function action(system, name, description, work) {
+function action(system, name, description, current, work) {
     system.command(name)
         .description(description)
         .action(async function () {
+        const lifecycle = current();
+        await installed(lifecycle);
         const interaction = prompts();
         interaction.begin(`System ${title(name)}`);
-        const status = await interaction.progress(`${title(name)}ing PhreshOS`, `PhreshOS ${past(name)}`, work);
-        report(interaction, status);
+        await interaction.progress(`${title(name)}ing PhreshOS`, `PhreshOS ${past(name)}`, () => work(lifecycle));
         interaction.finish(`System ${past(name)}`);
     });
 }
 function report(interaction, status) {
-    interaction.detail("installation", status.installed ? `installed · ${status.installed.version}` : "not installed");
-    interaction.detail("service", status.registered ? "registered" : "not registered");
-    interaction.detail("startup", status.enabled ? "enabled" : "disabled");
-    interaction.detail("process", status.running ? `running${status.pid ? ` · ${status.pid}` : ""}` : "stopped");
-    interaction.detail("intake", status.ready ? `ready · ${status.intake}` : "not ready");
-    interaction.detail("files", status.root);
-    interaction.detail("log", status.log);
+    interaction.detail("version", accent(status.installed?.version ?? "unknown"));
+    interaction.detail("service", service(status));
+    interaction.detail("startup", status.enabled ? positive("enabled") : dim("disabled"));
+}
+async function installed(lifecycle) {
+    const status = await lifecycle.status();
+    if (status.installed)
+        return { ...status, installed: status.installed };
+    const interaction = prompts();
+    interaction.begin("PhreshOS System");
+    interaction.warning("PhreshOS System is not installed");
+    interaction.finish(`${dim("Install it with")} ${accent("phresh system install")}`);
+    throw new ReportedFailure();
+}
+function service(status) {
+    if (status.ready)
+        return positive("ready");
+    if (status.running)
+        return caution("starting");
+    if (status.registered)
+        return caution("stopped");
+    return negative("not registered");
 }
 function title(value) {
     return `${value[0]?.toUpperCase()}${value.slice(1)}`;

package/dist/system/lifecycle.js

@@ -4,6 +4,7 @@ import { intakeReady, waitForIntake } from "./readiness.js";
 import systemPaths from "./paths.js";
 import systemService from "./service/index.js";
 import nodeExecutable from "./node.js";
+import { existsSync } from "node:fs";
 import { join } from "node:path";
 /** Coordinates acquisition, immutable files, and the native service as one transaction. */
 export default class SystemLifecycle {
@@ -123,7 +124,8 @@ export default class SystemLifecycle {
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
-            throw new Error(`${message}. Service log: ${installation.paths.log}`, { cause: error });
+            const log = existsSync(installation.paths.log) ? `. Service log: ${installation.paths.log}` : "";
+            throw new Error(`${message}${log}`, { cause: error });
         }
     }
     async activate(prepared, previous, state) {

package/dist/system/service/linux.js

@@ -79,11 +79,11 @@ Description=PhreshOS System
 [Service]
 Type=simple
 ExecStart=${quote(definition.executable)} ${quote(definition.entry)}
-WorkingDirectory=${quote(definition.directory)}
+WorkingDirectory=${setting(definition.directory)}
 Restart=on-failure
 RestartSec=2
-StandardOutput=append:${quote(definition.output)}
-StandardError=append:${quote(definition.output)}
+StandardOutput=append:${setting(definition.output)}
+StandardError=append:${setting(definition.output)}
 
 [Install]
 WantedBy=default.target
@@ -92,3 +92,8 @@ WantedBy=default.target
 function quote(value) {
     return JSON.stringify(value);
 }
+function setting(value) {
+    if (value.includes("\n") || value.includes("\r"))
+        throw new Error("A systemd service path cannot contain a line break");
+    return value.replaceAll("%", "%%");
+}

package/dist/template/package.json

@@ -16,7 +16,7 @@
         "react-dom": "^19.2.8"
     },
     "devDependencies": {
-        "@phreshos/cli": "^0.1.6",
+        "@phreshos/cli": "^0.1.7",
         "@types/node": "^26.2.0",
         "@types/react": "^19.2.18",
         "@types/react-dom": "^19.2.4",

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@phreshos/cli",
     "type": "module",
-    "version": "0.1.6",
+    "version": "0.1.7",
     "description": "The Phresh command-line interface for Program projects and system management.",
     "engines": {
         "node": ">=20.10"
@@ -13,6 +13,7 @@
         "test": "node --run compile && node --test tests/*.test.mjs",
         "verify": "node --run build && node --run test && node scripts/verify-package.mjs",
         "verify:system-release": "node --run compile && node scripts/verify-system-release.mjs",
+        "verify:linux-service": "node --run compile && node scripts/verify-linux-service.mjs",
         "verify:macos-service": "node --run compile && node scripts/verify-macos-service.mjs",
         "prepack": "node --run build"
     },