@phreshos/cli 0.1.14 → 0.1.16

package/README.md

@@ -78,10 +78,11 @@ Windows; neither becomes a network endpoint or introduces a bearer secret.
 
 `phresh create <directory>` creates a complete Server and Client Program from
 the maintained `PhreshOS/phresh-program` repository. The CLI build downloads
-one exact tagged source release, verifies its SHA-256 checksum, removes
-repository-only material, and bundles the resulting authoring project. The
-installed CLI therefore creates projects offline without reading a live branch
-or maintaining a second template by hand.
+the newest complete stable release, validates its source identity and version,
+removes repository-only material, and bundles that exact authoring project.
+The resolved source digest is recorded with the bundle. The installed CLI
+therefore creates projects offline without reading a live branch or maintaining
+a release pin or second template by hand.
 
 The directory name becomes the stable kebab-case Program identity. In a
 terminal, `create` asks for the directory when it is omitted, the readable

package/dist/template/README.md

@@ -1,28 +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 follows the endpoint boundaries directly:
+The complete authored source is intentionally small:
 
 ```text
 source/
-├── client/   React interface
-└── server/   authoritative counter and API
+├── client/
+│   ├── app.tsx
+│   ├── index.html
+│   ├── main.tsx
+│   └── style.css
+└── server/
+    └── main.ts
 ```
 
-The Program declaration lives in `phresh.config.ts`. Its own service contract
-is 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/gitignore

@@ -1,31 +1,19 @@
 # Logs
 logs
 *.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-pnpm-debug.log*
-lerna-debug.log*
 
 node_modules
 dist
-dist-ssr
 *.local
 
 # Made by `phresh pack` in the project root.
 /*.zip
 /*.zip.sha256
 
-# Editor directories and files
-.vscode/*
-!.vscode/extensions.json
+# Editor and machine residue.
+.vscode
 .idea
 .DS_Store
-*.suo
-*.ntvs*
-*.njsproj
-*.sln
-*.sw?
 
-# Made by the system the first time this program runs.
+# Made by the system the first time this Program runs.
 storage

package/dist/template/package.json

@@ -1,28 +1,34 @@
 {
     "name": "phresh-program",
     "private": true,
-    "version": "0.1.2",
+    "version": "0.1.10",
+    "description": "The official PhreshOS starter Program.",
     "type": "module",
     "scripts": {
         "dev": "phresh dev",
         "start": "phresh start"
     },
+    "keywords": [
+        "phreshos",
+        "program",
+        "starter"
+    ],
     "dependencies": {
-        "@phreshos/client": "^0.1.1",
-        "@phreshos/react": "^0.1.1",
-        "@phreshos/server": "^0.1.1",
-        "@phreshos/core": "^0.1.1",
+        "@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.14",
+        "@phreshos/cli": "^0.1.16",
         "@types/node": "^26.2.0",
         "@types/react": "^19.2.18",
         "@types/react-dom": "^19.2.4",
         "@vitejs/plugin-react": "^6.0.5",
-        "tsx": "^4.23.12",
         "typescript": "^7.0.2",
-        "vite": "^8.2.1"
+        "vite": "^8.2.1",
+        "vite-node": "^6.0.0"
     }
 }

package/dist/template/phresh.config.ts

@@ -1,107 +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.2",
-
-    // 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",
-
-    // 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: "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.
+    buildCommand: "vite-node scripts/build.ts",
     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 and watch mode work without a production build.
-            startCommand: "node --watch --import tsx source/server/main.ts"
+            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

@@ -0,0 +1,10 @@
+import { rm, writeFile } from "node:fs/promises"
+
+process.env.NODE_ENV = "production"
+
+const { build } = await import("vite")
+
+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" }))

package/dist/template/source/client/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,8 +1,8 @@
-import client from "react-dom/client"
 import { StrictMode } from "react"
+import client from "react-dom/client"
 import App from "./app"
 import "./style.css"
 
 const root = client.createRoot(document.body)
 
-root.render(<StrictMode><App /></StrictMode>)
+root.render(<StrictMode><App /></StrictMode>)

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,14 +1,10 @@
 import { current } from "@phreshos/server"
 
-// The Server owns the value. Every Client representation reads and changes
-// this same state instead of keeping an independent browser counter.
 let count = 0
 
 current.answer("read", () => count)
 
-current.subscribe("increment", async function () {
-
+current.subscribe("increment", () => {
     count += 1
-
     current.publish("changed", count)
 })

package/dist/template/tsconfig.json

@@ -9,16 +9,9 @@
         "jsx": "react-jsx",
         "strict": true,
         "noEmit": true,
-        "paths": {
-            "@/*": [
-                "./*"
-            ],
-            "@server/*": [
-                "./source/server/*"
-            ],
-            "@client/*": [
-                "./source/client/*"
-            ]
-        }
+        "types": [
+            "@types/node",
+            "vite/client"
+        ]
     }
 }

package/dist/template/vite.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from "vite"
+import { resolve } from "node:path"
+
+export default defineConfig({
+    root: "source/server",
+    build: {
+        ssr: true,
+        emptyOutDir: true,
+        outDir: resolve(import.meta.dirname, "dist/server"),
+        rolldownOptions: {
+            input: "main.ts"
+        }
+    }
+})

package/dist/template.json

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

package/package.json

@@ -1,17 +1,18 @@
 {
     "name": "@phreshos/cli",
     "type": "module",
-  "version": "0.1.14",
+  "version": "0.1.16",
     "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 })\"",
+        "check:scripts": "tsc --project tsconfig.scripts.json",
         "compile": "tsc --noEmit false --outDir dist --rootDir source --rewriteRelativeImportExtensions true --allowImportingTsExtensions true",
-        "build": "node --run clean && node --run compile && node dist/build-template.js",
+        "build": "node --run clean && node --run compile && vite-node scripts/build-template.ts",
         "test": "node --run compile && node --test tests/*.test.mjs",
-        "verify": "node --run build && node --run test && node scripts/verify-package.mjs",
+        "verify": "node --run check:scripts && 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",
@@ -48,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"
@@ -56,6 +57,7 @@
     "devDependencies": {
         "@types/adm-zip": "^0.5.8",
         "@types/node": "^25.9.5",
-        "typescript": "^6.0.3"
+        "typescript": "^6.0.3",
+        "vite-node": "^6.0.0"
     }
 }

package/dist/build-template.js

@@ -1,90 +0,0 @@
-import metadata from "../package.json" with { type: "json" };
-import { createHash } from "node:crypto";
-import { mkdirSync, rmSync, writeFileSync } from "node:fs";
-import { dirname, resolve, sep } from "node:path";
-import AdmZip from "adm-zip";
-import { readConfig } from "./project.js";
-const repository = "PhreshOS/phresh-program";
-const release = {
-    version: "0.1.2",
-    sha256: "dba5f1fd868c46501d5bd3463f4f8f0e098c7a231cb75794c01118689dc69339"
-};
-const archiveUrl = `https://github.com/${repository}/archive/refs/tags/v${release.version}.zip`;
-const output = resolve(import.meta.dirname, "template");
-const descriptionOutput = resolve(import.meta.dirname, "template.json");
-const excludedDirectories = new Set([".github", "dist", "node_modules", "scripts", "storage"]);
-const excludedRootFiles = new Set(["CONTRIBUTING.md", "LICENSE", "SECURITY.md"]);
-const excludedFiles = new Set([
-    ".DS_Store",
-    "bun.lock",
-    "bun.lockb",
-    "package-lock.json",
-    "pnpm-lock.yaml",
-    "yarn.lock"
-]);
-const response = await fetch(archiveUrl);
-if (!response.ok)
-    throw new Error(`Could not download ${repository} v${release.version}: ${response.status} ${response.statusText}`);
-const bytes = Buffer.from(await response.arrayBuffer());
-const digest = createHash("sha256").update(bytes).digest("hex");
-if (digest !== release.sha256)
-    throw new Error(`The ${repository} v${release.version} source archive failed integrity verification`);
-const archive = new AdmZip(bytes);
-const entries = archive.getEntries();
-const roots = new Set(entries.map(entry => entry.entryName.split("/")[0]).filter(Boolean));
-if (roots.size !== 1)
-    throw new Error(`The ${repository} v${release.version} source archive has an invalid root`);
-const root = [...roots][0];
-rmSync(output, { recursive: true, force: true });
-rmSync(descriptionOutput, { force: true });
-for (const entry of entries) {
-    if (entry.isDirectory || !entry.entryName.startsWith(`${root}/`))
-        continue;
-    const local = entry.entryName.slice(root.length + 1);
-    if (!included(local))
-        continue;
-    const target = local === ".gitignore" ? "gitignore" : local;
-    const path = resolve(output, target);
-    if (!path.startsWith(`${output}${sep}`))
-        throw new Error(`The ${repository} source archive contains an unsafe path: ${local}`);
-    mkdirSync(dirname(path), { recursive: true });
-    writeFileSync(path, entry.getData());
-}
-const manifestPath = resolve(output, "package.json");
-const manifestSource = archive.readFile(`${root}/package.json`);
-if (!manifestSource)
-    throw new Error(`The ${repository} v${release.version} source archive has no package.json`);
-const manifest = JSON.parse(manifestSource.toString("utf8"));
-manifest.scripts = select(manifest.scripts, ["dev", "start"]);
-manifest.devDependencies = {
-    ...manifest.devDependencies,
-    "@phreshos/cli": `^${metadata.version}`
-};
-delete manifest.author;
-delete manifest.license;
-delete manifest.repository;
-delete manifest.bugs;
-delete manifest.homepage;
-delete manifest.packageManager;
-writeFileSync(manifestPath, JSON.stringify(manifest, null, 4) + "\n");
-const config = await readConfig(output);
-if (config.identity !== "phresh-program" || config.name !== "Phresh Program")
-    throw new Error(`The ${repository} release is not Phresh Program`);
-writeFileSync(descriptionOutput, JSON.stringify({
-    repository,
-    version: release.version,
-    development: Boolean(config.server?.development || config.client?.development)
-}, null, 4) + "\n");
-function included(local) {
-    const parts = local.split("/");
-    if (parts.some(part => excludedDirectories.has(part)))
-        return false;
-    if (parts.length === 1 && excludedRootFiles.has(local))
-        return false;
-    if (excludedFiles.has(parts.at(-1)))
-        return false;
-    return !local.endsWith(".zip");
-}
-function select(source, names) {
-    return Object.fromEntries(names.flatMap(name => source?.[name] === undefined ? [] : [[name, source[name]]]));
-}

package/dist/template/api-docs.md

@@ -1,38 +0,0 @@
-# Counter API
-
-The Server 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 count = await process.server.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
-process.server.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
-process.server.subscribe<number>("changed", count => {
-  // use the latest count
-})
-```

package/dist/template/source/build.ts

@@ -1,17 +0,0 @@
-import { externalDependencies } from "@/vite.server"
-import { writeFile } from "node:fs/promises"
-import packageConfig from "@/package.json"
-import { build } from "vite"
-
-const dependencies: Partial<typeof packageConfig.dependencies> = {}
-
-for (const externalDependency of externalDependencies) {
-
-    dependencies[externalDependency] = packageConfig.dependencies[externalDependency]
-}
-
-await build({ configFile: "vite.server.ts" })
-
-await build({ configFile: "vite.client.ts" })
-
-await writeFile("dist/server/package.json", JSON.stringify({ type: "module", dependencies }))

package/dist/template/source/client/dec.d.ts

@@ -1 +0,0 @@
-/// <reference types="vite/client" />

package/dist/template/source/server/dec.d.ts

@@ -1 +0,0 @@
-/// <reference types="@types/node" />

package/dist/template/vite.server.ts

@@ -1,27 +0,0 @@
-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"
-        }
-    }
-})