@phreshos/cli 0.1.59 → 0.1.61

package/dist/commands/connection.js

@@ -18,7 +18,7 @@ export async function requireProgram(system, identity) {
 }
 export async function requireProcess(system, identity, programIdentity) {
     const process = programIdentity
-        ? await (await requireProgram(system, programIdentity)).process.find(identity)
+        ? await (await requireProgram(system, programIdentity)).findProcess(identity)
         : await system.process.find(identity);
     if (!process)
         throw new Error(`Unknown Process "${identity}"`);

package/dist/commands/process.js

@@ -21,7 +21,7 @@ export default function processCommands(root, connect) {
         examples: ["phresh process list", "phresh process list --program terminal --json"]
     }, async ({ options }) => connected(connect, async (system) => {
         const processes = options.program
-            ? await (await requireProgram(system, options.program)).process.list()
+            ? await (await requireProgram(system, options.program)).processes()
             : await system.process.list();
         const selected = page(processes, options.search, bounded(options.offset, "--offset", 0), bounded(options.limit, "--limit", 1, 100), current => `${current.identity}\n${current.name ?? ""}`);
         return { ...selected, data: await Promise.all(selected.data.map(processView)) };
@@ -45,7 +45,7 @@ export default function processCommands(root, connect) {
         examples: ["phresh process create --program terminal --server --client", "phresh process create --program terminal --name main --json"]
     }, async ({ options }) => connected(connect, async (system) => {
         const program = await requireProgram(system, options.program);
-        return await processView(await program.process.create(launch(options)));
+        return await processView(await program.createProcess(launch(options)));
     }));
     defineCommand(processes, {
         name: "findOrCreate",
@@ -57,7 +57,7 @@ export default function processCommands(root, connect) {
         examples: ["phresh process find-or-create --program terminal --name main --json"]
     }, async ({ options }) => connected(connect, async (system) => {
         const program = await requireProgram(system, options.program);
-        return await processView(await program.process.findOrCreate(launch(options, true)));
+        return await processView(await program.findOrCreateProcess(launch(options, true)));
     }));
     defineCommand(processes, {
         name: "exit",
@@ -82,14 +82,15 @@ export default function processCommands(root, connect) {
     }, async ({ options }) => connected(connect, async (system) => {
         if (options.process && options.event === "create")
             throw new Error("An individual Process does not emit create");
+        const timeout = options.timeout === undefined ? undefined : bounded(options.timeout, "--timeout", 1);
         const target = options.process
             ? await requireProcess(system, options.process, options.program)
             : options.program
-                ? (await requireProgram(system, options.program)).process
+                ? await requireProgram(system, options.program)
                 : system.process;
-        const message = await wait(target, options.event, options.timeout === undefined
-            ? undefined
-            : bounded(options.timeout, "--timeout", 1));
+        const message = options.program && !options.process
+            ? await wait(target, options.event === "create" ? "processCreate" : "processExit", timeout)
+            : await wait(target, options.event, timeout);
         return {
             scope: options.process ? `process:${options.process}` : options.program ? `program:${options.program}` : "process",
             event: options.event,

package/dist/commands/program.js

@@ -5,7 +5,7 @@ import { dataOutput, eventOutput, eventPresentation, pageOutput, programListPres
 import { connected, requireProgram } from "./connection.js";
 import { bounded, integer, page } from "./input.js";
 import { wait } from "./observation.js";
-import { programView } from "./projection.js";
+import { processView, programView } from "./projection.js";
 export default function programCommands(root, connect) {
     const programs = defineCommand(root, {
         name: "program",
@@ -60,13 +60,16 @@ export default function programCommands(root, connect) {
         requiresSystem: true,
         options: withJson(option("--event <event>", "Program lifecycle event", {
             mandatory: true,
-            choices: ["create", "forget", "install", "uninstall"]
-        }), option("--program <identity>", "scope forget or uninstall to one Program"), timeoutOption),
+            choices: ["create", "forget", "install", "uninstall", "processCreate", "processExit"]
+        }), option("--program <identity>", "observe events belonging to one Program"), timeoutOption),
         output: dataOutput(eventOutput("The observed Program event", value.any("Program state or uninstall result")), "One Program event", eventPresentation),
         examples: ["phresh program wait --event create", "phresh program wait --event uninstall --program terminal --json"]
     }, async ({ options }) => connected(connect, async (system) => {
-        if (options.program && options.event !== "forget" && options.event !== "uninstall") {
-            throw new Error("An individual Program emits only forget and uninstall");
+        if (options.program && (options.event === "create" || options.event === "install")) {
+            throw new Error(`An individual Program does not emit ${options.event}`);
+        }
+        if (!options.program && (options.event === "processCreate" || options.event === "processExit")) {
+            throw new Error(`${options.event} belongs to an individual Program`);
         }
         const target = options.program ? await requireProgram(system, options.program) : system.program;
         const message = await wait(target, options.event, timeout(options.timeout));
@@ -80,10 +83,16 @@ export default function programCommands(root, connect) {
 async function eventView(event, message, scoped) {
     if (event === "uninstall") {
         if (scoped)
-            return { program: await programView(scoped), purge: message === true };
+            return { program: await programView(scoped), purge: message.purge };
         const current = message;
         return { program: await programView(current.program), purge: current.purge };
     }
+    if (event === "processCreate")
+        return processView(message);
+    if (event === "processExit") {
+        const current = message;
+        return { process: await processView(current.process), status: current.status, code: current.code, signal: current.signal };
+    }
     if (scoped)
         return programView(scoped);
     return programView(message);

package/dist/contract/schema.js

@@ -15,7 +15,7 @@ export const value = Object.freeze({
         description
     }),
     array: (items, description) => ({ type: "array", items, description }),
-    object: (properties, required, description, additionalProperties = false) => ({ type: "object", properties, required, additionalProperties, description }),
+    object: (properties, required, description, additionalProperties = true) => ({ type: "object", properties, required, additionalProperties, description }),
     nullable: (schema) => ({ anyOf: [schema, { type: "null" }] })
 });
 /** Validate one emitted JSON value against its declared CLI output contract. */
@@ -57,8 +57,6 @@ export function assertValue(value, contract, path = "result") {
             const property = contract.properties?.[name];
             if (property)
                 assertValue(item, property, `${path}.${name}`);
-            else if (contract.additionalProperties === false)
-                throw new Error(`${path}.${name} is not declared by its CLI contract`);
             else if (typeof contract.additionalProperties === "object")
                 assertValue(item, contract.additionalProperties, `${path}.${name}`);
         }

package/dist/program-installation.js

@@ -18,7 +18,7 @@ export default async function installProgram(program, options = {}) {
         else
             installed = await system.program.forceCreate(program);
         if (options.run)
-            stopObserving = installed.process.subscribe("create", created => { process ??= created.identity; });
+            stopObserving = installed.subscribe("processCreate", created => { process ??= created.identity; });
         for await (const chunk of installed.install({ launch: options.run ? true : undefined, purge: options.purge }))
             writeProgramCommandOutput(chunk);
         installationFinished = true;

package/dist/template/package.json

@@ -1,7 +1,7 @@
 {
     "name": "phresh",
     "private": true,
-    "version": "0.1.36",
+    "version": "0.1.37",
     "description": "The official PhreshOS starter Program.",
     "type": "module",
     "scripts": {
@@ -14,15 +14,15 @@
         "starter"
     ],
     "dependencies": {
-        "@phreshos/client": "^0.1.42",
-        "@phreshos/core": "^0.1.48",
-        "@phreshos/react": "^0.1.24",
-        "@phreshos/server": "^0.1.46",
+        "@phreshos/client": "^0.1.43",
+        "@phreshos/core": "^0.1.49",
+        "@phreshos/react": "^0.1.25",
+        "@phreshos/server": "^0.1.47",
         "react": "^19.2.8",
         "react-dom": "^19.2.8"
     },
     "devDependencies": {
-        "@phreshos/cli": "^0.1.59",
+        "@phreshos/cli": "^0.1.61",
         "@types/node": "^26.4.0",
         "@types/react": "^19.2.18",
         "@types/react-dom": "^19.2.5",

package/dist/template/phresh.config.ts

@@ -4,7 +4,7 @@ export default defineConfig({
     identity: "phresh",
     name: "Phresh Program",
     description: "A minimal counter with direct Client and Server endpoints.",
-    version: "0.1.36",
+    version: "0.1.37",
     icon: "icon.png",
     categories: ["Development"],
     keywords: ["example", "counter", "client", "server"],

package/dist/template.json

@@ -1,6 +1,6 @@
 {
     "repository": "PhreshOS/phresh-program",
-    "version": "0.1.36",
-    "sha256": "f22ae33155bc70b8533834835acdc8d8857a631caa57f135aa4ba5eeeb9fc4d0",
+    "version": "0.1.37",
+    "sha256": "2cf505d4ee6be9a7659b5969d59f7ed68fe9a2e44e79bd7fe827e9e42423b003",
     "development": true
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@phreshos/cli",
   "type": "module",
-  "version": "0.1.59",
+  "version": "0.1.61",
   "description": "The Phresh command-line interface for Program projects and system management.",
   "engines": {
     "node": ">=20.10"
@@ -47,8 +47,8 @@
   "packageManager": "bun@1.3.14",
   "dependencies": {
     "@clack/prompts": "^1.7.0",
-    "@phreshos/core": "^0.1.48",
-    "@phreshos/node": "^0.1.22",
+    "@phreshos/core": "^0.1.52",
+    "@phreshos/node": "^0.1.24",
     "adm-zip": "^0.6.0",
     "cli-table3": "^0.6.5",
     "commander": "^15.0.0",