@phreshos/cli 0.1.4 → 0.1.6

package/dist/system/service/linux.js

@@ -0,0 +1,94 @@
+import { execute } from "../process.js";
+import { existsSync } from "node:fs";
+import { mkdir, rename, rm, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { randomUUID } from "node:crypto";
+const command = "systemctl";
+const unit = "phreshos.service";
+export default class LinuxSystemService {
+    run;
+    file;
+    constructor(userHome, run = execute) {
+        this.run = run;
+        this.file = join(userHome, ".config", "systemd", "user", unit);
+    }
+    async inspect() {
+        const registered = existsSync(this.file);
+        const active = await this.run(command, ["--user", "is-active", "--quiet", unit]);
+        const enabled = await this.run(command, ["--user", "is-enabled", "--quiet", unit]);
+        const pid = active.code === 0 ? await this.run(command, ["--user", "show", unit, "--property", "MainPID", "--value"]) : undefined;
+        const value = pid && /^[0-9]+$/.test(pid.stdout.trim()) ? Number(pid.stdout.trim()) : undefined;
+        return {
+            registered,
+            enabled: registered && enabled.code === 0,
+            running: registered && active.code === 0,
+            ...(value ? { pid: value } : {})
+        };
+    }
+    async register(definition) {
+        await this.stop();
+        await mkdir(dirname(this.file), { recursive: true });
+        await mkdir(dirname(definition.output), { recursive: true });
+        const temporary = `${this.file}.${randomUUID()}.tmp`;
+        try {
+            await writeFile(temporary, service(definition), { mode: 0o600 });
+            await rename(temporary, this.file);
+        }
+        finally {
+            await rm(temporary, { force: true });
+        }
+        await this.require(["--user", "daemon-reload"]);
+    }
+    async unregister() {
+        await this.stop();
+        await this.run(command, ["--user", "disable", unit]);
+        await rm(this.file, { force: true });
+        await this.require(["--user", "daemon-reload"]);
+        await this.run(command, ["--user", "reset-failed", unit]);
+    }
+    async start() {
+        if (!existsSync(this.file))
+            throw new Error("The PhreshOS System service is not registered");
+        await this.require(["--user", "start", unit]);
+    }
+    async stop() {
+        const state = await this.run(command, ["--user", "is-active", "--quiet", unit]);
+        if (state.code === 0)
+            await this.require(["--user", "stop", unit]);
+    }
+    async enable() {
+        if (!existsSync(this.file))
+            throw new Error("The PhreshOS System service is not registered");
+        await this.require(["--user", "enable", unit]);
+    }
+    async disable() {
+        if (!existsSync(this.file))
+            throw new Error("The PhreshOS System service is not registered");
+        await this.require(["--user", "disable", unit]);
+    }
+    async require(args) {
+        const result = await this.run(command, args);
+        if (result.code !== 0)
+            throw new Error(result.stderr.trim() || result.stdout.trim() || `${command} exited with code ${result.code}`);
+    }
+}
+function service(definition) {
+    return `[Unit]
+Description=PhreshOS System
+
+[Service]
+Type=simple
+ExecStart=${quote(definition.executable)} ${quote(definition.entry)}
+WorkingDirectory=${quote(definition.directory)}
+Restart=on-failure
+RestartSec=2
+StandardOutput=append:${quote(definition.output)}
+StandardError=append:${quote(definition.output)}
+
+[Install]
+WantedBy=default.target
+`;
+}
+function quote(value) {
+    return JSON.stringify(value);
+}

package/dist/system/service/macos.js

@@ -0,0 +1,123 @@
+import { execute } from "../process.js";
+import { existsSync } from "node:fs";
+import { mkdir, rename, rm, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { randomUUID } from "node:crypto";
+const command = "/bin/launchctl";
+const defaultLabel = "com.phreshos.system";
+export default class MacOSSystemService {
+    run;
+    label;
+    plist;
+    domain;
+    target;
+    constructor(userHome, run = execute, label = defaultLabel) {
+        this.run = run;
+        this.label = label;
+        const uid = process.getuid?.();
+        if (uid === undefined)
+            throw new Error("The current macOS user could not be identified");
+        this.plist = join(userHome, "Library", "LaunchAgents", `${this.label}.plist`);
+        this.domain = `gui/${uid}`;
+        this.target = `${this.domain}/${this.label}`;
+    }
+    async inspect() {
+        const registered = existsSync(this.plist);
+        const service = await this.run(command, ["print", this.target]);
+        const disabled = await this.run(command, ["print-disabled", this.domain]);
+        const explicitlyDisabled = new RegExp(`"${escapePattern(this.label)}"\\s*=>\\s*(?:true|disabled)`).test(disabled.stdout);
+        const pid = /\bpid\s*=\s*(\d+)/.exec(service.stdout)?.[1];
+        return {
+            registered,
+            enabled: registered && !explicitlyDisabled,
+            running: service.code === 0 && /\bstate\s*=\s*running\b/.test(service.stdout),
+            ...(pid ? { pid: Number(pid) } : {})
+        };
+    }
+    async register(definition) {
+        await this.stop();
+        await mkdir(dirname(this.plist), { recursive: true });
+        await mkdir(dirname(definition.output), { recursive: true });
+        const temporary = `${this.plist}.${randomUUID()}.tmp`;
+        try {
+            await writeFile(temporary, plist(this.label, definition), { mode: 0o600 });
+            await rename(temporary, this.plist);
+        }
+        finally {
+            await rm(temporary, { force: true });
+        }
+    }
+    async unregister() {
+        await this.stop();
+        await rm(this.plist, { force: true });
+    }
+    async start() {
+        if (!existsSync(this.plist))
+            throw new Error("The PhreshOS System service is not registered");
+        const state = await this.inspect();
+        if (state.running)
+            return;
+        const loaded = await this.run(command, ["print", this.target]);
+        if (loaded.code === 0)
+            await this.require(["kickstart", "-k", this.target]);
+        else
+            await this.require(["bootstrap", this.domain, this.plist]);
+    }
+    async stop() {
+        const loaded = await this.run(command, ["print", this.target]);
+        if (loaded.code === 0)
+            await this.require(["bootout", this.target]);
+    }
+    async enable() {
+        if (!existsSync(this.plist))
+            throw new Error("The PhreshOS System service is not registered");
+        await this.require(["enable", this.target]);
+    }
+    async disable() {
+        if (!existsSync(this.plist))
+            throw new Error("The PhreshOS System service is not registered");
+        await this.require(["disable", this.target]);
+    }
+    async require(args) {
+        const result = await this.run(command, args);
+        if (result.code !== 0)
+            throw new Error(result.stderr.trim() || result.stdout.trim() || `${command} exited with code ${result.code}`);
+    }
+}
+function plist(label, definition) {
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>${xml(label)}</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>${xml(definition.executable)}</string>
+        <string>${xml(definition.entry)}</string>
+    </array>
+    <key>WorkingDirectory</key>
+    <string>${xml(definition.directory)}</string>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <dict>
+        <key>SuccessfulExit</key>
+        <false/>
+    </dict>
+    <key>ThrottleInterval</key>
+    <integer>2</integer>
+    <key>StandardOutPath</key>
+    <string>${xml(definition.output)}</string>
+    <key>StandardErrorPath</key>
+    <string>${xml(definition.output)}</string>
+</dict>
+</plist>
+`;
+}
+function xml(value) {
+    return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
+}
+function escapePattern(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}

package/dist/template/README.md

@@ -1,4 +1,4 @@
-# Get Started
+# Phresh Program
 
 A small Counter built as a complete Program. Its Node.js Server owns the
 number, while its React Client reads and increments that same authoritative

package/dist/template/package.json

@@ -1,21 +1,22 @@
 {
-    "name": "get-started",
+    "name": "phresh-program",
     "private": true,
     "version": "0.1.0",
     "type": "module",
     "scripts": {
-        "phresh": "phresh"
+        "dev": "phresh dev",
+        "start": "phresh start"
     },
     "dependencies": {
-        "@phreshos/client": "^0.1.0",
-        "@phreshos/react": "^0.1.0",
-        "@phreshos/server": "^0.1.0",
-        "@phreshos/core": "^0.1.0",
+        "@phreshos/client": "^0.1.1",
+        "@phreshos/react": "^0.1.1",
+        "@phreshos/server": "^0.1.1",
+        "@phreshos/core": "^0.1.1",
         "react": "^19.2.8",
         "react-dom": "^19.2.8"
     },
     "devDependencies": {
-        "@phreshos/cli": "^0.1.4",
+        "@phreshos/cli": "^0.1.6",
         "@types/node": "^26.2.0",
         "@types/react": "^19.2.18",
         "@types/react-dom": "^19.2.4",

package/dist/template/phresh.config.ts

@@ -1,69 +1,109 @@
 import { defineConfig } from "@phreshos/core"
 
+/**
+ * This is the Program's authoring declaration, not a runtime configuration
+ * loaded by either endpoint. The Phresh CLI reads it and derives the concrete
+ * Program description needed for development, production, installation, or
+ * packaging.
+ *
+ * Production uses the built locations and commands declared below.
+ * Development replaces only each endpoint's location and start command with
+ * its `development` declaration. Packaging relocates the production files
+ * into the Program archive. Relative paths begin at this project directory.
+ */
 export default defineConfig({
 
-    // The stable, kebab-case address used by programs and the system.
-    identity: "get-started",
+    // Permanent public address of the Program. It is kebab-case because the
+    // system also uses it as the installed directory name. Unlike `name`, it
+    // is an identifier and must remain stable across releases.
+    identity: "phresh-program",
 
-    // Human-facing details shown by the desktop and development tools.
-    name: "Get Started",
+    // Human-facing metadata shown by the desktop and authoring tools. None of
+    // these values determines the Program's identity.
+    name: "Phresh Program",
     description: "A simple counter whose state lives on the Server.",
     version: "0.1.0",
 
-    // The official entry point for this Program's own API.
+    // Markdown entry point for the API owned by this Program. It documents the
+    // counter service contract; PhreshOS endpoint mechanics belong in PhreshOS
+    // documentation instead of being repeated here.
     apiDocs: "api-docs.md",
 
-    // A directory containing files named by size, such as 128x128.png.
-    icons: "icons",
+    // One authored PNG. Installation gives it a canonical name and the system
+    // derives the standard hosted icon sizes from it.
+    icon: "icon.png",
 
-    // Runs before production start, install, and pack; dev uses the
-    // development declarations below instead.
+    // Prepares both production endpoint directories. The CLI runs it from this
+    // project before `phresh start`, `phresh install`, and `phresh pack`.
+    // `phresh dev` does not build and uses the declarations below instead.
     buildCommand: "node --import tsx source/build.ts",
 
+    // A Process may run its Server and Client independently. This declaration
+    // says how the Server is prepared and started; it does not merge Server
+    // code into the browser Client.
     server: {
 
-        // The built server directory and the command run from within it.
+        // Production directory containing the Server artifact. The start
+        // command runs with this directory as its working directory.
         location: "dist/server",
         startCommand: "node main.js",
 
-        // Optional preparation performed once before the installed server
-        // first starts. This bundled example does not need it.
+        // An install command is optional and runs inside `location` when the
+        // Program is installed. This build bundles its Server dependencies, so
+        // the example does not need one.
         // installCommand: "npm install",
 
-        // A declared half starts by default. Set this to false when it
-        // should exist but only be included when explicitly requested.
+        // Declared endpoints start in a default Process unless `start` is
+        // false. A false value keeps the capability available for an explicit
+        // Process launch without starting it automatically.
         // start: false,
 
         development: {
 
-            // Development server commands run from the project root.
+            // `phresh dev` runs this command from the project directory. The
+            // project directory becomes the development Server location, so
+            // source imports and watch mode work without a production build.
             startCommand: "node --watch --import tsx source/server/main.ts"
         }
     },
 
+    // The Client declaration also defines the initial Window created for it.
+    // It contains presentation defaults only; live Window state belongs to
+    // each running Process.
     client: {
 
-        // The directory containing the built browser application.
+        // Production directory containing the browser application's
+        // `index.html` and all files reachable from it.
         location: "dist/client",
 
-        title: "Get Started",
+        // Initial Window values. The title defaults to the Program name when
+        // omitted. This example chooses a fixed initial size while leaving
+        // placement, layer, and minimized state to their system defaults.
+        title: "Phresh Program",
         size: { width: 600, height: 500 },
 
-        // Optional defaults for the window created with this client half.
-        // title: "Get Started",
-        // Fractions and percentages are relative to the Window's layer. Pixel
-        // offsets may be combined with them in one linear expression.
+        // Geometry accepts finite pixel numbers or linear values. Fractions
+        // and percentages are relative to the selected desktop layer, and a
+        // pixel offset may be combined with either form.
         // size: { width: "50% + 20", height: 440 },
         // position: { x: "1/2 + 10", y: 40 },
-        // layer: "window", // "under" and "over" are frameless desktop layers.
+
+        // `window` is the ordinary framed layer. `under` and `over` are
+        // structurally isolated, frameless desktop layers.
+        // layer: "window",
+
+        // The initial Window may also be declared to open minimized.
         // minimize: true,
 
         development: {
 
-            // The CLI starts this command, then waits for the URL before it
-            // launches the development Program.
+            // Development Clients are addressed by URL rather than a local
+            // artifact directory. The CLI starts this optional tool, waits for
+            // the URL to respond, and only then launches the Program. The dev
+            // server must allow the desktop origin through CORS; this project's
+            // Vite configuration does so.
             url: "http://localhost:5200/",
-            startCommand: "vite dev"
+            startCommand: "vite dev --config vite.client.ts"
         }
     }
 })

package/dist/template/source/build.ts

@@ -1,4 +1,4 @@
-import { externalDependencies } from "@/vite.config"
+import { externalDependencies } from "@/vite.server"
 import { writeFile } from "node:fs/promises"
 import packageConfig from "@/package.json"
 import { build } from "vite"
@@ -10,8 +10,8 @@ for (const externalDependency of externalDependencies) {
     dependencies[externalDependency] = packageConfig.dependencies[externalDependency]
 }
 
-await build({ build: { ssr: true } })
+await build({ configFile: "vite.server.ts" })
 
-await build()
+await build({ configFile: "vite.client.ts" })
 
 await writeFile("dist/server/package.json", JSON.stringify({ type: "module", dependencies }))

package/dist/template/source/client/app.tsx

@@ -1,4 +1,4 @@
-import { CurrentProvider, useSubscribe } from "@phreshos/react"
+import { useSubscribe } from "@phreshos/react"
 import { useEffect, useState } from "react"
 import { current } from "@phreshos/client"
 
@@ -16,7 +16,7 @@ function Counter() {
 
     return <main className="counter-card">
 
-        <span className="label">Get Started</span>
+        <span className="label">Phresh Program</span>
 
         <h1>Server counter</h1>
 
@@ -32,10 +32,5 @@ function Counter() {
 }
 
 export default function App() {
-
-    return <CurrentProvider waitServer fallback={<main className="loading">Connecting to the Server…</main>}>
-
-        <Counter />
-
-    </CurrentProvider>
+    return <Counter />
 }

package/dist/template/source/server/main.ts

@@ -6,7 +6,7 @@ let count = 0
 
 current.answer("read", () => count)
 
-current.subscribe("increment", function () {
+current.subscribe("increment", async function () {
 
     count += 1
 

package/dist/template/vite.client.ts

@@ -0,0 +1,22 @@
+import react from "@vitejs/plugin-react"
+import { defineConfig } from "vite"
+import { resolve } from "node:path"
+
+export default defineConfig({
+    root: "source/client",
+    plugins: [react()],
+    base: "./",
+    resolve: {
+        tsconfigPaths: true,
+        dedupe: ["react"]
+    },
+    server: {
+        cors: true,
+        port: 5200,
+        strictPort: true
+    },
+    build: {
+        emptyOutDir: true,
+        outDir: resolve(import.meta.dirname, "dist/client")
+    }
+})

package/dist/template/vite.server.ts

@@ -0,0 +1,27 @@
+import packageConfig from "./package.json" with { type: "json" }
+import { defineConfig } from "vite"
+import { resolve } from "node:path"
+
+export const externalDependencies: (keyof typeof packageConfig.dependencies)[] = [
+
+    // Add packages here that should NOT be bundled during server, Example: "sqlite3"
+]
+
+export default defineConfig({
+    root: "source/server",
+    resolve: {
+        tsconfigPaths: true
+    },
+    ssr: {
+        noExternal: true,
+        external: externalDependencies
+    },
+    build: {
+        ssr: true,
+        emptyOutDir: true,
+        outDir: resolve(import.meta.dirname, "dist/server"),
+        rolldownOptions: {
+            input: "main.ts"
+        }
+    }
+})

package/dist/template.json

@@ -0,0 +1,5 @@
+{
+    "repository": "PhreshOS/phresh-program",
+    "version": "0.1.0",
+    "development": true
+}

package/package.json

@@ -1,11 +1,19 @@
 {
     "name": "@phreshos/cli",
     "type": "module",
-    "version": "0.1.4",
+    "version": "0.1.6",
     "description": "The Phresh command-line interface for Program projects and system management.",
+    "engines": {
+        "node": ">=20.10"
+    },
     "scripts": {
+        "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
         "compile": "tsc --noEmit false --outDir dist --rootDir source --rewriteRelativeImportExtensions true --allowImportingTsExtensions true",
-        "build": "node --run compile && node dist/build-template.js",
+        "build": "node --run clean && node --run compile && node dist/build-template.js",
+        "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:macos-service": "node --run compile && node scripts/verify-macos-service.mjs",
         "prepack": "node --run build"
     },
     "bin": {
@@ -13,11 +21,35 @@
     },
     "files": [
         "dist",
+        "LICENSE",
         "README.md"
     ],
+    "author": "Zohayr SLILEH",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/PhreshOS/cli.git"
+    },
+    "bugs": {
+        "url": "https://github.com/PhreshOS/cli/issues"
+    },
+    "homepage": "https://github.com/PhreshOS/cli#readme",
+    "keywords": [
+        "phreshos",
+        "cli",
+        "program"
+    ],
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    },
+    "packageManager": "bun@1.3.14",
     "dependencies": {
-        "@phreshos/core": "^0.1.0",
-        "adm-zip": "^0.6.0"
+        "@clack/prompts": "^1.7.0",
+        "@phreshos/core": "^0.1.1",
+        "adm-zip": "^0.6.0",
+        "commander": "^15.0.0",
+        "picocolors": "^1.1.1"
     },
     "devDependencies": {
         "@types/adm-zip": "^0.5.8",

package/dist/questions.js

@@ -1,25 +0,0 @@
-import { bold, dim } from "./style.js";
-import { createInterface } from "node:readline/promises";
-/** One prompt language shared by every interactive command. */
-export default function questions() {
-    const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
-    const readline = interactive ? createInterface({ input: process.stdin, output: process.stdout }) : null;
-    async function ask(explanation, question, fallback) {
-        if (!readline)
-            throw new Error(`${question} Supply the corresponding option when no terminal is attached`);
-        const suffix = fallback === undefined ? "" : ` ${dim(`(${fallback})`)}`;
-        console.log(`  ${dim(explanation)}`);
-        const said = (await readline.question(`  ${bold(question)}${suffix} `)).trim();
-        console.log("");
-        return said || fallback || "";
-    }
-    async function yes(explanation, question, fallback) {
-        return (await ask(explanation, question, fallback ? "Y/n" : "y/N")).toLowerCase().startsWith("y");
-    }
-    return {
-        interactive,
-        ask,
-        yes,
-        close: () => readline?.close()
-    };
-}