@phreshos/cli 0.1.15 → 0.1.16

package/dist/template/README.md

@@ -1,33 +1,26 @@
 # 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
-state.
+The minimal PhreshOS starter Program. Its Client talks directly to its Server;
+there is no MVC structure and no registered service.
 
 ```bash
 bun install
-bun phresh dev
+bun run dev
 ```
 
-Development starts the Server source and Vite Client together. For the
-production shape, build and attach the Program with:
-
-```bash
-bun phresh start
-```
-
-The structure keeps composition, representation, and authoritative behavior distinct:
+The complete authored source is intentionally small:
 
 ```text
 source/
 ├── client/
-│   ├── main.tsx   Client composition
-│   └── view/      React representation
+│   ├── app.tsx
+│   ├── index.html
+│   ├── main.tsx
+│   └── style.css
 └── server/
-    ├── main.ts    Server composition
-    ├── core/      authoritative counter
-    └── view/      endpoint adapter and service exposure
+    └── main.ts
 ```
 
-The Program declaration lives in `phresh.config.ts`. Its own service contract
-is exposed as the `counter` Server service and documented in `api-docs.md`.
+`app.tsx` owns the small React component. The two `main` files are direct
+endpoint entries: the Client renders the app and the Server owns the counter.
+Nothing registers or exposes a named service.

package/dist/template/package.json

@@ -1,7 +1,7 @@
 {
     "name": "phresh-program",
     "private": true,
-    "version": "0.1.6",
+    "version": "0.1.10",
     "description": "The official PhreshOS starter Program.",
     "type": "module",
     "scripts": {
@@ -14,15 +14,15 @@
         "starter"
     ],
     "dependencies": {
-        "@phreshos/client": "^0.1.9",
-        "@phreshos/core": "^0.1.6",
-        "@phreshos/react": "^0.1.5",
-        "@phreshos/server": "^0.1.7",
+        "@phreshos/client": "^0.1.11",
+        "@phreshos/core": "^0.1.7",
+        "@phreshos/react": "^0.1.6",
+        "@phreshos/server": "^0.1.9",
         "react": "^19.2.8",
         "react-dom": "^19.2.8"
     },
     "devDependencies": {
-        "@phreshos/cli": "^0.1.15",
+        "@phreshos/cli": "^0.1.16",
         "@types/node": "^26.2.0",
         "@types/react": "^19.2.18",
         "@types/react-dom": "^19.2.4",

package/dist/template/phresh.config.ts

@@ -1,102 +1,24 @@
 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({
-
-    // 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 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.6",
-
-    // One authored PNG. Installation gives it a canonical name and the system
-    // derives the standard hosted icon sizes from it.
+    description: "A minimal counter with direct Client and Server endpoints.",
+    version: "0.1.10",
     icon: "icon.png",
-
-    // 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: "vite-node scripts/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: {
-
-        // Production directory containing the Server artifact. The start
-        // command runs with this directory as its working directory.
         location: "dist/server",
         startCommand: "node main.js",
-
-        // 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",
-
-        // 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: {
-
-            // `phresh dev` runs this command from the project directory. The
-            // project directory becomes the development Server location, so
-            // source imports work without a production build.
             startCommand: "vite-node 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: {
-
-        // Production directory containing the browser application's
-        // `index.html` and all files reachable from it.
         location: "dist/client",
-
-        // 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 },
-
-        // 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 },
-
-        // `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: {
-
-            // 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 --config vite.client.ts"
         }

package/dist/template/scripts/build.ts

@@ -1,20 +1,10 @@
-import { externalDependencies } from "@/vite.config"
-import { writeFile } from "node:fs/promises"
-import packageConfig from "@/package.json"
+import { rm, writeFile } from "node:fs/promises"
 
 process.env.NODE_ENV = "production"
 
 const { build } = await import("vite")
 
-const dependencies: Partial<typeof packageConfig.dependencies> = {}
-
-for (const externalDependency of externalDependencies) {
-
-    dependencies[externalDependency] = packageConfig.dependencies[externalDependency]
-}
-
+await rm("dist", { recursive: true, force: true })
 await build({ configFile: "vite.config.ts", ssr: { noExternal: true } })
-
 await build({ configFile: "vite.client.ts" })
-
-await writeFile("dist/server/package.json", JSON.stringify({ type: "module", dependencies }))
+await writeFile("dist/server/package.json", JSON.stringify({ type: "module" }))

package/dist/template/source/client/{view/app.tsx → app.tsx}

@@ -1,36 +1,22 @@
+import { current } from "@phreshos/client"
 import { useSubscribe } from "@phreshos/react"
 import { useEffect, useState } from "react"
-import { current } from "@phreshos/client"
-
-function Counter() {
 
+export default function App() {
     const [count, setCount] = useState<number>()
 
     useSubscribe(current.server, "changed", setCount)
 
-    useEffect(function () {
-
+    useEffect(() => {
         current.server.ask<number>("read").then(setCount)
-
     }, [])
 
-    return <main className="counter-card">
-
-        <span className="label">Phresh Program</span>
-
+    return <main>
+        <span>PhreshOS</span>
         <h1>Server counter</h1>
-
-        <p>The value belongs to the Server and is shared with every Client representation.</p>
-
+        <p>The Client talks directly to its Process Server.</p>
         <button type="button" onClick={() => current.server.publish("increment")}>
-
-            count is {count ?? "…"}
-
+            Count is {count ?? "…"}
         </button>
-
     </main>
 }
-
-export default function App() {
-    return <Counter />
-}

package/dist/template/source/client/index.html

@@ -4,10 +4,10 @@
 <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Phresh Program</title>
     <script type="module" src="./main.tsx"></script>
 </head>
 
-<body>
-</body>
+<body></body>
 
-</html>
+</html>

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

@@ -1,6 +1,6 @@
-import client from "react-dom/client"
 import { StrictMode } from "react"
-import App from "./view/app"
+import client from "react-dom/client"
+import App from "./app"
 import "./style.css"
 
 const root = client.createRoot(document.body)

package/dist/template/source/client/style.css

@@ -1,38 +1,37 @@
 :root {
     color: #20242a;
-    background: #f3f4f6;
-    font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    background: transparent;
+    font-family: Inter, ui-sans-serif, system-ui, sans-serif;
     font-synthesis: none;
 }
 
-* { box-sizing: border-box; }
-
-html, body, #root { min-height: 100vh; display: grid; }
-
-body { margin: 0; }
+* {
+    box-sizing: border-box;
+}
 
-button { font: inherit; }
+html,
+body {
+    min-height: 100%;
+    background: transparent;
+}
 
-#root {
+body {
+    margin: 0;
     min-height: 100vh;
     display: grid;
     place-items: center;
     padding: 1.5rem;
 }
 
-.counter-card {
+main {
     width: min(26rem, 100%);
-    display: grid;
-    justify-items: start;
-    gap: 1rem;
     padding: 2rem;
     border: 1px solid #d8dce2;
     border-radius: 0.75rem;
     background: #ffffff;
-    margin: auto;
 }
 
-.label {
+span {
     color: #646b76;
     font-size: 0.72rem;
     font-weight: 700;
@@ -41,21 +40,19 @@ button { font: inherit; }
 }
 
 h1 {
-    margin: 0;
+    margin: 0.75rem 0;
     font-size: 2rem;
     line-height: 1.1;
-    letter-spacing: -0.04em;
 }
 
 p {
     margin: 0;
     color: #5f6670;
-    font-size: 0.95rem;
-    line-height: 1.55;
+    line-height: 1.5;
 }
 
-.counter-card button {
-    min-width: 9rem;
+button {
+    margin-top: 1.5rem;
     min-height: 2.75rem;
     padding: 0.65rem 1rem;
     border: 0;
@@ -63,19 +60,15 @@ p {
     color: #ffffff;
     background: #2563eb;
     cursor: pointer;
+    font: inherit;
     font-weight: 650;
 }
 
-.counter-card button:hover { background: #1d4ed8; }
-
-.counter-card button:active { background: #1e40af; }
-
-.counter-card button:focus-visible {
-    outline: 3px solid rgba(37, 99, 235, 0.25);
-    outline-offset: 2px;
+button:hover {
+    background: #1d4ed8;
 }
 
-.loading {
-    color: #646b76;
-    font-size: 0.9rem;
+button:focus-visible {
+    outline: 3px solid rgb(37 99 235 / 25%);
+    outline-offset: 2px;
 }

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

@@ -1,3 +1,10 @@
-import view from "./view/view"
+import { current } from "@phreshos/server"
 
-await view()
+let count = 0
+
+current.answer("read", () => count)
+
+current.subscribe("increment", () => {
+    count += 1
+    current.publish("changed", count)
+})

package/dist/template/tsconfig.json

@@ -12,17 +12,6 @@
         "types": [
             "@types/node",
             "vite/client"
-        ],
-        "paths": {
-            "@/*": [
-                "./*"
-            ],
-            "@server/*": [
-                "./source/server/*"
-            ],
-            "@client/*": [
-                "./source/client/*"
-            ]
-        }
+        ]
     }
 }

package/dist/template/vite.config.ts

@@ -1,20 +1,8 @@
-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: {
-        external: externalDependencies
-    },
     build: {
         ssr: true,
         emptyOutDir: true,

package/dist/template.json

@@ -1,6 +1,6 @@
 {
     "repository": "PhreshOS/phresh-program",
-    "version": "0.1.6",
-    "sha256": "a56227927522a550ef5dab3eb5127274e23ecd9c0dabb912f8b46f37990a9602",
+    "version": "0.1.10",
+    "sha256": "3a341bab1bd1b06929312b09a0c21d3a5f9ad6baf9b7bf8865324818fb49a65b",
     "development": true
 }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@phreshos/cli",
     "type": "module",
-    "version": "0.1.15",
+  "version": "0.1.16",
     "description": "The Phresh command-line interface for Program projects and system management.",
     "engines": {
         "node": ">=20.10"
@@ -49,7 +49,7 @@
     "packageManager": "bun@1.3.14",
     "dependencies": {
         "@clack/prompts": "^1.7.0",
-    "@phreshos/core": "^0.1.4",
+    "@phreshos/core": "^0.1.9",
         "adm-zip": "^0.6.0",
         "commander": "^15.0.0",
         "picocolors": "^1.1.1"

package/dist/template/api-docs.md

@@ -1,44 +0,0 @@
-# Counter API
-
-The `counter` Server service owns one number for the lifetime of its Process.
-
-| Name | Destination | Interaction | Payload | Answer |
-| --- | --- | --- | --- | --- |
-| `read` | Server | `ask()` | `undefined` | `number` |
-| `increment` | Server | `publish()` | `undefined` | None |
-| `changed` | Server | `subscribe()` | `number` | None |
-
-## Ask the Server: `read`
-
-`read` is a question addressed to this Process's Server. It answers with the
-current counter value.
-
-```ts
-const counter = host.service({
-  program: "phresh-program",
-  endpoint: "server",
-  name: "counter"
-})
-
-const count = await counter.channel.ask<number>("read")
-```
-
-## Publish to the Server: `increment`
-
-`increment` is a one-way event addressed to this Process's Server. It adds one
-to the counter and does not produce an answer.
-
-```ts
-counter.channel.publish("increment")
-```
-
-## Subscribe to the Server: `changed`
-
-After an increment, the Server emits `changed` with the new counter value.
-Anyone holding that Process's Server can subscribe to the event.
-
-```ts
-counter.channel.subscribe<number>("changed", count => {
-  // use the latest count
-})
-```

package/dist/template/source/server/core/counter.ts

@@ -1,13 +0,0 @@
-/** Owns the Program's authoritative counter state without knowing how it is exposed. */
-export default class Counter {
-  private value = 0
-
-  public read() {
-    return this.value
-  }
-
-  public increment() {
-    this.value += 1
-    return this.value
-  }
-}

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

@@ -1,16 +0,0 @@
-import { current } from "@phreshos/server"
-import docs from "@/api-docs.md?raw"
-import Counter from "@server/core/counter"
-
-const counter = new Counter()
-
-/** Exposes the counter core through this Server endpoint. */
-export default async function view() {
-  current.answer("read", () => counter.read())
-
-  current.subscribe("increment", () => {
-    current.publish("changed", counter.increment())
-  })
-
-  await current.enableService({ name: "counter", docs })
-}