@phreshos/cli 0.1.54 → 0.1.55

package/dist/install.js

@@ -15,8 +15,9 @@ import { prepareOfficialProgram } from "./program-release.js";
  * production Program is derived and sent. The command remains authoring
  * metadata and never becomes part of the installed Program.
  *
- * Installation remains distinct from execution unless `run` is explicitly
- * requested. A run created here belongs to the installed Program and
+ * The System applies the Program's startup declaration during installation.
+ * `run` explicitly requests an additional Process. A run created here belongs
+ * to the installed Program and
  * therefore outlives this command; `phresh start` and `phresh dev` remain
  * attached authoring runs whose lifetime is the terminal's.
  */

package/dist/system/lifecycle.js

@@ -203,7 +203,7 @@ export default class SystemLifecycle {
     }
 }
 async function provisionSetup() {
-    await installProgram({ name: "setup", run: true, announce: false });
+    await installProgram({ name: "setup", announce: false });
 }
 function definition(installation, executable) {
     return {

package/dist/template/README.md

@@ -45,6 +45,12 @@ bun run pack
 `verify` checks the source, builds both Endpoints, and validates the packaged
 Program shape.
 
+`check` performs static checks, `build` creates distributable output, and `test`
+runs Vitest assertions from `tests/`. Run `build` before testing built artifacts.
+`verify` runs `check`, `build`, and `test` in order. Operational tooling belongs
+in `scripts/`; tests and their fixtures belong in `tests/`. Verification uses
+the committed dependency graph without local package substitutions.
+
 ## Related repositories
 
 - [`@phreshos/cli`](https://github.com/PhreshOS/cli) bundles this repository for

package/dist/template/package.json

@@ -1,7 +1,7 @@
 {
     "name": "phresh",
     "private": true,
-    "version": "0.1.32",
+    "version": "0.1.33",
     "description": "The official PhreshOS starter Program.",
     "type": "module",
     "scripts": {
@@ -14,21 +14,22 @@
         "starter"
     ],
     "dependencies": {
-        "@phreshos/client": "^0.1.38",
-        "@phreshos/core": "^0.1.42",
-        "@phreshos/react": "^0.1.21",
-        "@phreshos/server": "^0.1.42",
+        "@phreshos/client": "^0.1.39",
+        "@phreshos/core": "^0.1.43",
+        "@phreshos/react": "^0.1.22",
+        "@phreshos/server": "^0.1.43",
         "react": "^19.2.8",
         "react-dom": "^19.2.8"
     },
     "devDependencies": {
-        "@phreshos/cli": "^0.1.54",
+        "@phreshos/cli": "^0.1.55",
         "@types/node": "^26.4.0",
         "@types/react": "^19.2.18",
         "@types/react-dom": "^19.2.5",
         "@vitejs/plugin-react": "^6.1.1",
         "typescript": "^7.0.2",
         "vite": "^8.2.2",
-        "vite-node": "^6.0.0"
+        "vite-node": "^6.0.0",
+        "vitest": "^4.1.10"
     }
 }

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.32",
+    version: "0.1.33",
     icon: "icon.png",
     categories: ["Development"],
     keywords: ["example", "counter", "client", "server"],

package/dist/template/tests/build.test.ts

@@ -0,0 +1,19 @@
+import assert from "node:assert/strict"
+import { readFileSync } from "node:fs"
+import config from "../phresh.config"
+import manifest from "../package.json" with { type: "json" }
+import { test } from "vitest"
+
+test("build contract", async () => {
+  assert.equal(config.identity, "phresh")
+  assert.equal(config.name, "Phresh Program")
+  assert.equal(config.version, manifest.version)
+  assert.equal(config.server?.location, "dist/server")
+  assert.equal(config.server?.entryFile, "main.js")
+  assert.equal(config.server?.development?.startCommand, "vite-node server/main.ts")
+  assert.equal(config.client?.location, "dist/client")
+  assert.deepEqual(config.client?.size, { width: 600, height: 500 })
+
+  assert(readFileSync("dist/client/index.html", "utf8").length > 0)
+  assert(readFileSync("dist/server/main.js", "utf8").length > 0)
+}, 120_000)

package/dist/template/tests/counter.test.ts

@@ -0,0 +1,24 @@
+import { expect, test, vi } from "vitest"
+
+const boundary = vi.hoisted(() => ({
+  answer: vi.fn(),
+  subscribe: vi.fn(),
+  publish: vi.fn()
+}))
+
+vi.mock("@phreshos/server", () => ({ context: boundary }))
+
+test("counter reads and published changes describe the same server state", async () => {
+  await import("../server/main")
+  expect(boundary.answer).toHaveBeenCalledWith("read", expect.any(Function))
+  expect(boundary.subscribe).toHaveBeenCalledWith("increment", expect.any(Function))
+  const read = boundary.answer.mock.calls[0]![1] as () => number
+  const increment = boundary.subscribe.mock.calls[0]![1] as () => void
+  expect(read()).toBe(0)
+  increment()
+  expect(read()).toBe(1)
+  expect(boundary.publish).toHaveBeenLastCalledWith("changed", 1)
+  increment()
+  expect(read()).toBe(2)
+  expect(boundary.publish).toHaveBeenLastCalledWith("changed", 2)
+})

package/dist/template/vitest.config.ts

@@ -0,0 +1,25 @@
+import { defineConfig } from "vitest/config"
+
+export default defineConfig({
+  test: {
+    pool: "forks",
+    maxWorkers: 2,
+    projects: [
+      {
+        extends: true,
+        test: {
+          name: "default",
+          include: [
+            "tests/**/*.test.{ts,tsx,mjs}"
+          ],
+          exclude: [
+            "tests/**/*.platform.test.*",
+            "tests/**/*.live.test.*"
+          ],
+          environment: "node",
+          testTimeout: 30000
+        }
+      }
+    ]
+  }
+})

package/dist/template.json

@@ -1,6 +1,6 @@
 {
     "repository": "PhreshOS/phresh-program",
-    "version": "0.1.32",
-    "sha256": "2644513c80b924eda546f257f853bbc03619c5b9bd2b510259d4f87ecd126f4a",
+    "version": "0.1.33",
+    "sha256": "1976ed8a044998c7bf4da403c66c4965e986425044a78cf648ec3cc6e715dd5b",
     "development": true
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@phreshos/cli",
   "type": "module",
-  "version": "0.1.54",
+  "version": "0.1.55",
   "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.43",
-    "@phreshos/node": "^0.1.18",
+    "@phreshos/core": "^0.1.44",
+    "@phreshos/node": "^0.1.19",
     "adm-zip": "^0.6.0",
     "cli-table3": "^0.6.5",
     "commander": "^15.0.0",