@trypattern/sdk 0.1.5 → 0.1.7

package/dist/cli/app.js

@@ -74,7 +74,13 @@ const CONTACT_SHEET = join(SCREENSHOTS_DIR, 'contact-sheet.png');
 const SCREENSHOT_WORKER = join(SDK_SOURCE, 'cli', `screenshot${SDK_EXTENSION}`);
 const VISUAL_URL_ENV = 'PATTERN_VISUAL_URL';
 const GLOBAL_FLAGS = ['--json', '--help', '-h'];
-const VALUE_FLAGS = new Set(['--commands', '--name', '--as', '--code']);
+const VALUE_FLAGS = new Set([
+    '--commands',
+    '--name',
+    '--as',
+    '--code',
+    '--message'
+]);
 const SHIM_SOURCE = `#!/bin/sh
 ${SHIM_MARKER_LINE}
 dir=$PWD
@@ -284,9 +290,14 @@ git would keep, never .dev.vars, .env, node_modules, dist or .dev) to onpattern.
 until the new version answers at https://<name>.onpattern.app, printing each step. The database
 moves forward with any new migrations; nothing is ever deleted from it. If a step fails, the site
 keeps running the previous version and the error says why. Run app check first.
+--message '…' says what changed in a few plain words for the owner ("Pink brand colour and a welcome
+line"); onpattern.app and app versions show it beside the version.
 --starter (Pattern's admins only) publishes this project as the starter every new site begins from.`,
-        run: (_argument, options) => publish(publishingIo(), ROOT, options.has('--starter')),
-        flags: ['--starter']
+        run: (_argument, options) => {
+            const message = options.get('--message');
+            return publish(publishingIo(), ROOT, options.has('--starter'), typeof message === 'string' ? message : undefined);
+        },
+        flags: ['--starter', '--message']
     },
     versions: {
         summary: 'List the versions that went live, newest first',
@@ -302,8 +313,8 @@ every row and column added since, which version 3's code ignores.`,
         takesArgument: true
     },
     setup: {
-        summary: 'Verify Node/pnpm major versions, pnpm install, install the global `app` shim',
-        details: `Idempotent. Fails unless Node and pnpm have the major versions in .nvmrc and package.json devEngines.
+        summary: 'Verify Node/pnpm are the pinned major versions or newer, pnpm install, install the global `app` shim',
+        details: `Idempotent. Fails when Node or pnpm is older than the major versions in .nvmrc and package.json devEngines.
 Then runs \`pnpm install\` and installs ${SHIM_PATH}, a tiny shim that walks up from the
 current directory to the nearest project launcher (an executable ./app containing the line
 ${LAUNCHER_MARKER_LINE}) and runs it, so each project's CLI lives in its repo and the shim
@@ -1223,6 +1234,9 @@ async function build() {
 function majorOf(version) {
     return version.split('.')[0] ?? '';
 }
+function isAtLeastMajor(version, pinned) {
+    return version !== '' && Number(majorOf(version)) >= Number(majorOf(pinned));
+}
 const packagePins = z.object({
     devEngines: z.object({
         packageManager: z.object({ version: z.string() })
@@ -1265,11 +1279,11 @@ async function setup() {
     });
     const havePnpm = (pnpmVersion.stdout ?? '').trim();
     const problems = [];
-    if (majorOf(haveNode) !== majorOf(pins.node)) {
-        problems.push(`Node ${haveNode} is not Node ${majorOf(pins.node)} (.nvmrc says ${pins.node})\n  fix  pnpm env use --global ${majorOf(pins.node)}`);
+    if (!isAtLeastMajor(haveNode, pins.node)) {
+        problems.push(`Node ${haveNode} is older than Node ${majorOf(pins.node)} (.nvmrc says ${pins.node})\n  fix  pnpm env use --global ${majorOf(pins.node)}`);
     }
-    if (majorOf(havePnpm) !== majorOf(pins.pnpm)) {
-        problems.push(`pnpm ${havePnpm || '(not found)'} is not pnpm ${majorOf(pins.pnpm)} (package.json devEngines says ${pins.pnpm} or newer)\n  fix  curl -fsSL https://get.pnpm.io/install.sh | sh -`);
+    if (!isAtLeastMajor(havePnpm, pins.pnpm)) {
+        problems.push(`pnpm ${havePnpm || '(not found)'} is older than pnpm ${majorOf(pins.pnpm)} (package.json devEngines says ${pins.pnpm} or newer)\n  fix  npm install --global pnpm@latest`);
     }
     const versions = { node: haveNode, pnpm: havePnpm, expected: pins };
     if (problems.length > 0) {
@@ -1279,7 +1293,10 @@ async function setup() {
             text: problems.map((p) => `✗ ${p}`).join('\n')
         };
     }
-    say(`✓ Node ${haveNode} and pnpm ${havePnpm} match the pinned major versions`);
+    const tested = majorOf(haveNode) === majorOf(pins.node)
+        ? ''
+        : ` (tested on Node ${majorOf(pins.node)})`;
+    say(`✓ Node ${haveNode} and pnpm ${havePnpm}${tested}`);
     const install = await capture('pnpm', ['install']);
     if (install.code !== 0) {
         return {
@@ -1311,7 +1328,7 @@ async function setup() {
 function help() {
     const width = Math.max(...Object.keys(COMMANDS).map((n) => n.length));
     const lines = Object.entries(COMMANDS).map(([name, cmd]) => `app ${name.padEnd(width)}  ${cmd.summary}`);
-    lines.push('Flags: --json (machine-readable stdout), <command> --help (details and its own flags: start --no-open, test --visual, screenshot --commands --name --as --signed-out, pull --code)');
+    lines.push('Flags: --json (machine-readable stdout), <command> --help (details and its own flags: start --no-open, test --visual, screenshot --commands --name --as --signed-out, pull --code, publish --message)');
     return {
         code: 0,
         data: {

package/dist/cli/publishing.d.ts

@@ -15,7 +15,7 @@ export type PublishingIo = {
 };
 export declare function login(io: PublishingIo): Promise<Outcome>;
 export declare function pull(io: PublishingIo, name: string | undefined, cwd: string, setupCode: string | undefined): Promise<Outcome>;
-export declare function publish(io: PublishingIo, root: string, isStarter: boolean): Promise<Outcome>;
+export declare function publish(io: PublishingIo, root: string, isStarter: boolean, message: string | undefined): Promise<Outcome>;
 export declare function versions(io: PublishingIo, root: string): Promise<Outcome>;
 export declare function restore(io: PublishingIo, root: string, number: string | undefined): Promise<Outcome>;
 export {};

package/dist/cli/publishing.js

@@ -1,9 +1,9 @@
 import { spawnSync } from 'node:child_process';
 import { chmodSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
-import { homedir, hostname, userInfo } from 'node:os';
+import { homedir } from 'node:os';
 import { basename, dirname, extname, join, matchesGlob, relative } from 'node:path';
 import { z } from 'zod';
-import { DASHBOARD_URL, UPLOAD, appSummary, isPrivatePath, loginPoll, loginStarted, nameProblem, publishSummary, setupCodeExchanged, sourcePathProblem } from "../publishWire.js";
+import { DASHBOARD_URL, UPLOAD, appSummary, isPrivatePath, loginPoll, loginStarted, nameProblem, publishMessage, publishSummary, setupCodeExchanged, sourcePathProblem } from "../publishWire.js";
 import { appInfo } from "../appTitle.js";
 import { PROJECT_FILE, readProjectFile } from "../vite/projectFile.js";
 const CONFIG_DIR = join(homedir(), '.config', 'pattern');
@@ -121,8 +121,11 @@ async function callJson(path, schema, init = {}) {
     return schema.parse(body);
 }
 function labelOfThisMachine() {
-    const machine = hostname().replace(/\.local$/, '');
-    return `${userInfo().username} on ${machine}`.slice(0, 80);
+    const named = spawnSync('scutil', ['--get', 'ComputerName'], {
+        encoding: 'utf8'
+    });
+    const name = named.status === 0 ? named.stdout.trim() : '';
+    return (name === '' ? 'this computer' : name).slice(0, 80);
 }
 function sleep(ms) {
     return new Promise((done) => setTimeout(done, ms));
@@ -248,6 +251,24 @@ function folderFor(name, cwd) {
         return cwd;
     return join(isInsideHome(cwd) ? cwd : homedir(), name);
 }
+async function hasPnpm(io, cwd) {
+    return (await io.run('pnpm', ['--version'], cwd)).code === 0;
+}
+async function ensurePnpm(io, cwd) {
+    if (await hasPnpm(io, cwd))
+        return true;
+    io.say('Installing pnpm');
+    const installed = await io.run('npm', ['install', '--global', 'pnpm@latest'], cwd);
+    return installed.code === 0 && (await hasPnpm(io, cwd));
+}
+function firstChange(title, url, folder) {
+    return [
+        `cd into ${folder} and read AGENTS.md: every rule in it applies. Then run ./app start and open the address it prints, so they see their site running on this computer.`,
+        `Ask them one question: "In a sentence, what does ${title} do?" From their answer, make the home page welcome them with a line that says what ${title} does, and give src/theme/theme.ts a brand colour that suits the business.`,
+        `Run ./app check until it passes, then ./app publish --message '<what changed>' straight away: this first change goes live without asking, so they see their real site change at ${url}.`,
+        `Then tell them their site lives in ${folder}, that next time they can start Claude there, and that from now on you'll show changes on this computer first and publish when they say so.`
+    ].join('\n        ');
+}
 function commandLineToolsReady() {
     return spawnSync('xcode-select', ['-p'], { stdio: 'ignore' }).status === 0;
 }
@@ -276,12 +297,13 @@ export async function pull(io, name, cwd, setupCode) {
             if (!response.ok)
                 throw new Error(`Couldn’t download ${name}`);
             const number = response.headers.get('x-pattern-publish') ?? '?';
+            const isStarter = response.headers.get('x-pattern-starter') === 'true';
             const live = await fetch(`${app.url}/api/app`)
                 .then((reply) => reply.json())
                 .then((body) => appInfo.parse(body).title)
                 .catch(() => '');
             const title = live === '' ? app.title : live;
-            return { app, title, number, form: await response.formData() };
+            return { app, title, number, isStarter, form: await response.formData() };
         });
         if (isOutcome(result))
             return result;
@@ -301,6 +323,13 @@ export async function pull(io, name, cwd, setupCode) {
             chmodSync(join(target, LAUNCHER), 0o755);
         writeFileSync(join(target, PROJECT_FILE), `${JSON.stringify({ name, title: result.title }, null, 2)}\n`);
         io.say(`✓ Downloaded ${files} files of version ${result.number}`);
+        if (!(await ensurePnpm(io, target))) {
+            return {
+                code: 1,
+                data: { error: 'pnpm missing', folder: target },
+                text: `✗ pnpm isn’t installed, and npm couldn’t install it\n  fix  curl -fsSL https://get.pnpm.io/install.sh | sh -, then open a new terminal and run this again`
+            };
+        }
         const install = await io.run('pnpm', ['install'], target);
         if (install.code !== 0) {
             return failure(new Error(`pnpm install failed\n${install.output}`));
@@ -314,11 +343,13 @@ export async function pull(io, name, cwd, setupCode) {
             await io.run('git', ['add', '-A'], target);
             await io.run('git', ['commit', '-q', '-m', `Version ${result.number} from onpattern.app`], target);
         }
-        const moved = `\n  folder  ${target}`;
+        const next = result.isStarter
+            ? firstChange(result.title, result.app.url, target)
+            : `cd into ${target}, read AGENTS.md, then ./app start`;
         return {
             code: 0,
             data: { name, folder: target, version: result.number, files },
-            text: `✓ ${result.title} is on this computer${moved}\n  next  cd into that folder, read AGENTS.md, then ./app start`
+            text: `✓ ${result.title} is on this computer\n  folder  ${target}\n  next  ${next}`
         };
     }
     catch (error) {
@@ -424,11 +455,13 @@ async function followPublish(io, name, started) {
     }
     const data = { name, version: publish.number, status: publish.status };
     if (publish.status === 'live') {
-        return {
-            code: 0,
-            data,
-            text: `✓ Version ${publish.number} is live at https://${name}.onpattern.app`
-        };
+        const lines = [
+            `✓ Version ${publish.number} is live at https://${name}.onpattern.app${publish.message === null ? '' : ` · ${publish.message}`}`
+        ];
+        if (publish.message === null && publish.restoredFrom === null) {
+            lines.push("  tip  add --message '…' so the owner sees what changed, in plain words");
+        }
+        return { code: 0, data, text: lines.join('\n') };
     }
     if (publish.status === 'failed') {
         return {
@@ -443,7 +476,7 @@ async function followPublish(io, name, started) {
         text: `✗ Version ${publish.number} is still publishing after ${PUBLISH_WAIT_MS / 60_000} minutes\n  next  app versions shows how it ends`
     };
 }
-export async function publish(io, root, isStarter) {
+export async function publish(io, root, isStarter, message) {
     try {
         const { name } = readProjectFile(root);
         const built = await io.build();
@@ -451,6 +484,9 @@ export async function publish(io, root, isStarter) {
             return built;
         io.say('✓ Built');
         const { form, sources } = uploadForm(root, io, isStarter);
+        const said = publishMessage(message ?? '');
+        if (said !== null)
+            form.append(UPLOAD.message, said);
         io.say(`✓ Packed the build and ${sources} source files`);
         const again = isStarter ? 'app publish --starter' : 'app publish';
         const result = await signedIn(io, again, async () => {
@@ -492,7 +528,7 @@ export async function versions(io, root) {
                 ? `restored version ${item.restoredFrom}`
                 : item.isStarter
                     ? 'starter site'
-                    : `published by ${item.byEmail}`;
+                    : (item.message ?? `published by ${item.byEmail}`);
             return `  ${String(item.number).padStart(3)}  ${item.status.padEnd(7)}  ${item.startedAt.slice(0, 16).replace('T', ' ')}  ${what}`;
         });
         return {

package/dist/components/Button.js

@@ -8,7 +8,7 @@ import { Icon } from "./Icon.js";
 import { interact, textOf } from "./interaction.js";
 import { Kbd } from "./Kbd.js";
 import { Spinner } from "./Spinner.js";
-export function Button({ children, variant = 'primary', tone = 'neutral', size = 'md', to, href, icon, trailingIcon, shortcut, type = 'button', disabled = false, isPending = false, isFullWidth = false, onClick, style }) {
+export function Button({ children, variant = 'primary', tone = variant === 'primary' ? 'brand' : 'neutral', size = 'md', to, href, icon, trailingIcon, shortcut, type = 'button', disabled = false, isPending = false, isFullWidth = false, onClick, style }) {
     const isDisabled = disabled || isPending;
     const report = () => {
         interact({ primitive: 'Button', event: 'click', label: textOf(children) });

package/dist/components/Sidebar.js

@@ -89,8 +89,8 @@ const styles = stylex.create({
         placeItems: 'center',
         width: iconSizes.xl,
         height: iconSizes.xl,
-        color: colors.onInvertedForeground,
-        backgroundColor: colors.invertedSolid,
+        color: colors.onBrandSolidForeground,
+        backgroundColor: colors.brandSolid,
         borderRadius: radii.md
     },
     body: {

package/dist/components/SignInScreen.js

@@ -33,8 +33,8 @@ const styles = stylex.create({
         alignSelf: 'center',
         width: controls.heightLg,
         height: controls.heightLg,
-        color: colors.onInvertedForeground,
-        backgroundColor: colors.invertedSolid,
+        color: colors.onBrandSolidForeground,
+        backgroundColor: colors.brandSolid,
         borderRadius: radii.lg
     }
 });

package/dist/publishWire.d.ts

@@ -17,7 +17,10 @@ export declare const UPLOAD: {
     readonly source: "source/";
     readonly compatibilityDate: "compatibilityDate";
     readonly sdkVersion: "sdkVersion";
+    readonly message: "message";
 };
+export declare const PUBLISH_MESSAGE_LIMIT = 100;
+export declare function publishMessage(text: string): string | null;
 export declare const publishStep: z.ZodEnum<{
     publish: "publish";
     reserve: "reserve";
@@ -47,6 +50,7 @@ export declare const publishSummary: z.ZodObject<{
     byEmail: z.ZodString;
     restoredFrom: z.ZodNullable<z.ZodNumber>;
     isStarter: z.ZodBoolean;
+    message: z.ZodNullable<z.ZodString>;
     startedAt: z.ZodString;
     finishedAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
@@ -73,6 +77,7 @@ export declare const appSummary: z.ZodObject<{
         byEmail: z.ZodString;
         restoredFrom: z.ZodNullable<z.ZodNumber>;
         isStarter: z.ZodBoolean;
+        message: z.ZodNullable<z.ZodString>;
         startedAt: z.ZodString;
         finishedAt: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
@@ -135,6 +140,7 @@ export declare const publishServices: {
                 byEmail: z.ZodString;
                 restoredFrom: z.ZodNullable<z.ZodNumber>;
                 isStarter: z.ZodBoolean;
+                message: z.ZodNullable<z.ZodString>;
                 startedAt: z.ZodString;
                 finishedAt: z.ZodNullable<z.ZodString>;
             }, z.core.$strip>>;
@@ -161,6 +167,7 @@ export declare const publishServices: {
                 byEmail: z.ZodString;
                 restoredFrom: z.ZodNullable<z.ZodNumber>;
                 isStarter: z.ZodBoolean;
+                message: z.ZodNullable<z.ZodString>;
                 startedAt: z.ZodString;
                 finishedAt: z.ZodNullable<z.ZodString>;
             }, z.core.$strip>>;
@@ -190,6 +197,7 @@ export declare const publishServices: {
                 byEmail: z.ZodString;
                 restoredFrom: z.ZodNullable<z.ZodNumber>;
                 isStarter: z.ZodBoolean;
+                message: z.ZodNullable<z.ZodString>;
                 startedAt: z.ZodString;
                 finishedAt: z.ZodNullable<z.ZodString>;
             }, z.core.$strip>>;
@@ -227,6 +235,7 @@ export declare const publishServices: {
             byEmail: z.ZodString;
             restoredFrom: z.ZodNullable<z.ZodNumber>;
             isStarter: z.ZodBoolean;
+            message: z.ZodNullable<z.ZodString>;
             startedAt: z.ZodString;
             finishedAt: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>>>>;
@@ -247,6 +256,7 @@ export declare const publishServices: {
             byEmail: z.ZodString;
             restoredFrom: z.ZodNullable<z.ZodNumber>;
             isStarter: z.ZodBoolean;
+            message: z.ZodNullable<z.ZodString>;
             startedAt: z.ZodString;
             finishedAt: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>>>;
@@ -267,6 +277,7 @@ export declare const publishServices: {
             byEmail: z.ZodString;
             restoredFrom: z.ZodNullable<z.ZodNumber>;
             isStarter: z.ZodBoolean;
+            message: z.ZodNullable<z.ZodString>;
             startedAt: z.ZodString;
             finishedAt: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>>>;

package/dist/publishWire.js

@@ -89,8 +89,14 @@ export const UPLOAD = {
     migrations: 'migrations/',
     source: 'source/',
     compatibilityDate: 'compatibilityDate',
-    sdkVersion: 'sdkVersion'
+    sdkVersion: 'sdkVersion',
+    message: 'message'
 };
+export const PUBLISH_MESSAGE_LIMIT = 100;
+export function publishMessage(text) {
+    const firstLine = (text.split('\n')[0] ?? '').replaceAll(/\s+/g, ' ').trim();
+    return firstLine === '' ? null : firstLine.slice(0, PUBLISH_MESSAGE_LIMIT);
+}
 export const publishStep = z.enum(['reserve', 'database', 'sign-in', 'publish']);
 export const publishStatus = z.enum(['running', 'live', 'failed']);
 export const publishSummary = z.object({
@@ -101,6 +107,7 @@ export const publishSummary = z.object({
     byEmail: z.string(),
     restoredFrom: z.number().nullable(),
     isStarter: z.boolean(),
+    message: z.string().nullable(),
     startedAt: z.string(),
     finishedAt: z.string().nullable()
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trypattern/sdk",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "type": "module",
   "files": [
     "dist",