@volter/world 2.0.52 → 2.0.54

package/dist/src/cli.js

@@ -424,14 +424,12 @@ async function worldCommand(verb, args) {
         }
         case 'changeset': {
             const message = value(args, '-m') ?? value(args, '--message');
-            if (message === undefined)
-                throw new Error('volter world changeset: say what and why — volter world changeset -m "<message>"');
-            const cs = world.changeset({ ...(pos[0] ? { name: pos[0] } : {}), message, ...(value(args, '--base') ? { base: value(args, '--base') } : {}), overwrite: flag(args, '--force') });
+            const cs = world.changeset({ ...(pos[0] ? { name: pos[0] } : {}), ...(message !== undefined ? { message } : {}), ...(value(args, '--base') ? { base: value(args, '--base') } : {}), overwrite: flag(args, '--force') });
             if (asJson) {
                 json(cs);
                 return;
             }
-            out(`changeset  ${cs.name}  ${cs.actions.length} change${cs.actions.length === 1 ? '' : 's'}\n  ${message}${cs.narration ? `\n${cs.narration.split('\n').map((l) => `  ${l}`).join('\n')}` : ''}`);
+            out(`changeset  ${cs.name}  ${cs.actions.length} change${cs.actions.length === 1 ? '' : 's'}${cs.message ? `\n  ${cs.message}` : ''}${cs.narration ? `\n${cs.narration.split('\n').map((l) => `  ${l}`).join('\n')}` : ''}`);
             return;
         }
         case 'view':
@@ -684,7 +682,7 @@ async function loginCommand(args) {
     if (!res.ok)
         throw new Error(`${origin} answered ${res.status}: ${body.error ?? 'not signed in'}`);
     storeToken(origin, token);
-    storePlatform(origin);
+    storePlatform(origin, undefined, body.person?.email ?? body.person?.id);
     out(`signed in  ${origin}  as ${body.person?.email ?? body.person?.id ?? 'you'}\norgs       ${(body.orgs ?? []).map((o) => o.slug ?? o.name).join(', ') || '(none yet)'}\nnext       in your app's folder: volter world init, then volter remote add origin ${(body.orgs ?? [])[0]?.slug ?? '<org>'}/<world> --create`);
 }
 /** `volter whoami`: which platform the command is signed into, as whom, and the orgs it reaches. */

package/dist/src/credentials.d.ts

@@ -8,7 +8,10 @@ export declare function storeToken(origin: string, token: string, path?: string)
 export declare function forgetToken(origin: string, path?: string): boolean;
 /** `volter login`: the hosted platform a person signed the CLI into — its origin, beside the credentials. */
 export declare function platformPath(): string;
-export declare function storePlatform(origin: string, path?: string): void;
+export declare function storePlatform(origin: string, path?: string, person?: string): void;
+/** Whom `volter login` signed the CLI in as (the platform's email or id for them): this machine's person, whom a World
+ *  served here records as acting from its own page (docs/contributing/architecture.md, "Who acted is recorded"). */
+export declare function platformPerson(path?: string): string | undefined;
 /** Forget which platform the CLI is signed into. */
 export declare function forgetPlatform(path?: string): void;
 export declare function platformOrigin(path?: string): string | undefined;

package/dist/src/credentials.js

@@ -47,9 +47,22 @@ export function forgetToken(origin, path = credentialsPath()) {
 }
 /** `volter login`: the hosted platform a person signed the CLI into — its origin, beside the credentials. */
 export function platformPath() { return join(dirname(credentialsPath()), 'platform.json'); }
-export function storePlatform(origin, path = platformPath()) {
+export function storePlatform(origin, path = platformPath(), person) {
     mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
-    writeFileSync(path, `${JSON.stringify({ url: normalizeOrigin(origin), savedAt: new Date().toISOString() }, null, 2)}\n`, { mode: 0o600 });
+    writeFileSync(path, `${JSON.stringify({ url: normalizeOrigin(origin), ...(person ? { person } : {}), savedAt: new Date().toISOString() }, null, 2)}\n`, { mode: 0o600 });
+}
+/** Whom `volter login` signed the CLI in as (the platform's email or id for them): this machine's person, whom a World
+ *  served here records as acting from its own page (docs/contributing/architecture.md, "Who acted is recorded"). */
+export function platformPerson(path = platformPath()) {
+    if (!existsSync(path))
+        return undefined;
+    try {
+        const p = JSON.parse(readFileSync(path, 'utf8')).person;
+        return typeof p === 'string' && p !== '' ? p : undefined;
+    }
+    catch {
+        return undefined;
+    }
 }
 /** Forget which platform the CLI is signed into. */
 export function forgetPlatform(path = platformPath()) { if (existsSync(path))

package/dist/src/world.js

@@ -2,10 +2,11 @@
 // docs/concepts/worlds.md#the-config-and-the-running-world): a branch with compute attached. `World.open()` finds the world of the cwd the
 // way git finds its repository; every method is a name for a world-runtime verb, in the words a
 // user reads. The `volter` command is one client of this class and adds nothing.
+import { platformPerson } from "./credentials.js";
 import { rebaseChangeset, worldBootMarker, listActions, isTwinBookkeeping, pushablePendingActions, pendingActions, applyTwinWrite, twinResources } from '@volter/world-core';
 import { spawnSync } from 'node:child_process';
 import clockForm from '@volter/world-core/world-clock';
-import { activateScript, approveWorldChangeset, branchWorld, clockFile, checkoutWorld, createWorldChangeset, diffWorld, downWorld, fetchFromOrigin, findWorldChangeset, initWorld, listWorldChangesets, listWorldMarks, listWorlds, markWorld, pushWorldChangeset, rebaseWorldChangeset, replayWorldChangeset, resetWorld, runWithWorldEnv, seedWorld, shellWorld, statusWorld, statusWorldChangeset, upWorld, verifyWorldChangeset, worldLedgers, worldOrigin, bindLegacyCredentials, deployWorld, loadWorldConfig, writeWorldConfig, readServeRecord, refreshTwin, serveWorld, serveWorldView, findInstalledPackage, rootForControlRoot, sealTwinCredential, sealedCredentialInfo, setTwinRoot, credentialPayloadFrom, rootCredentialInput, withoutVaultSignIn, materializeRoots } from '@volter/world-runtime';
+import { activateScript, approveWorldChangeset, branchWorld, clockFile, checkoutWorld, createWorldChangeset, diffWorld, downWorld, fetchFromOrigin, findWorldChangeset, initWorld, listWorldChangesets, listWorldMarks, listWorlds, markWorld, pushWorldChangeset, rebaseWorldChangeset, replayWorldChangeset, resetWorld, runWithWorldEnv, seedWorld, shellWorld, statusWorld, statusWorldChangeset, upWorld, verifyWorldChangeset, worldLedgers, worldOrigin, bindLegacyCredentials, deployWorld, loadWorldConfig, writeWorldConfig, readServeRecord, refreshTwin, serveWorld, serveWorldView, findInstalledPackage, rootForControlRoot, sealTwinCredential, sealedCredentialInfo, setTwinRoot, credentialPayloadFrom, rootCredentialInput, withoutVaultSignIn, materializeRoots, worldChangesetRules } from '@volter/world-runtime';
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { requireToken, storeToken } from "./credentials.js";
@@ -367,7 +368,7 @@ export class World {
     /** Serve this world on a port under `/<org>/<world>/`; returns when listening. */
     serve(opts = {}) { return serveWorld(this.name, { root: this.root, ...opts }); }
     /** `volter world view`: this World, its mirrors, its branches and the console on one origin (docs/contributing/architecture.md, "Viewing a World"). */
-    view(opts = {}) { return serveWorldView(this.name, { root: this.root, ...opts }); }
+    view(opts = {}) { const person = platformPerson(); return serveWorldView(this.name, { root: this.root, ...(person ? { localPerson: person } : {}), ...opts }); }
     // ── remotes ─────────────────────────────────────────────────────────────────────────────
     /** The vendors this world has a twin of, as world.json names them (a twin service's package, else its id). */
     vendors() {
@@ -447,8 +448,17 @@ export class World {
     // ── changesets and push ─────────────────────────────────────────────────────────────────
     /** Cut a changeset from the unpushed changes: the reviewable unit, with the author's message. */
     changeset(opts = {}) {
-        const name = opts.name ?? (opts.message ? slugName(opts.message, this.changesets()) : nextChangesetName(this.changesets()));
-        return createWorldChangeset(this.name, name, { root: this.root, ...(opts.message !== undefined ? { message: opts.message } : {}), ...(opts.base ? { base: opts.base } : {}), ...(opts.verifiers ? { verifiers: opts.verifiers } : {}), ...(opts.overwrite ? { overwrite: true } : {}) });
+        // a summary is the author's, unless this World's rules take the one generated from its changes; a blank one is none
+        const message = opts.message?.trim() || undefined;
+        if (message === undefined && worldChangesetRules(this.root).summary !== 'generated')
+            throw new Error('volter world changeset: say what and why — volter world changeset -m "<message>"');
+        // with no summary, a cut must have something to say: an empty one is a slip (`volter world changeset status`)
+        if (message === undefined && !opts.overwrite && this.diff(opts.base).actions.length === 0)
+            throw new Error(`Nothing to cut in world "${this.name}": every change is already in a changeset`);
+        const name = opts.name ?? (message ? slugName(message, this.changesets()) : nextChangesetName(this.changesets()));
+        // cut on this machine: recorded as the person signed in here (`volter login`), else as no one in particular
+        const person = platformPerson();
+        return createWorldChangeset(this.name, name, { root: this.root, ...(person ? { cutBy: `person:${person}`, owner: person } : {}), ...(message !== undefined ? { message } : {}), ...(opts.base ? { base: opts.base } : {}), ...(opts.verifiers ? { verifiers: opts.verifiers } : {}), ...(opts.overwrite ? { overwrite: true } : {}) });
     }
     changesets() { return listWorldChangesets({ root: this.root, world: this.name }); }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/world",
-  "version": "2.0.52",
+  "version": "2.0.54",
   "description": "Run your app against a world of twins. `World` and `Repo` — one method per verb: init, up, run, log, diff, reset, branch, checkout, clone, fetch, changeset, push — and the `volter` command, one client of them.",
   "keywords": [
     "volter",
@@ -30,12 +30,12 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.1",
-    "@volter/world-core": "2.0.31",
-    "@volter/world-runtime": "2.0.49",
+    "@volter/world-core": "2.0.33",
+    "@volter/world-runtime": "2.0.51",
     "zod": "^4.6.5"
   },
   "peerDependencies": {
-    "@volter/world-console": "2.0.13"
+    "@volter/world-console": "2.0.14"
   },
   "peerDependenciesMeta": {
     "@volter/world-console": {
@@ -43,7 +43,7 @@
     }
   },
   "devDependencies": {
-    "@volter/world-console": "2.0.13"
+    "@volter/world-console": "2.0.14"
   },
   "bin": {
     "volter": "dist/src/cli.js"

package/src/cli.ts

@@ -318,10 +318,9 @@ async function worldCommand(verb: string, args: string[]): Promise<void> {
     }
     case 'changeset': {
       const message = value(args, '-m') ?? value(args, '--message');
-      if (message === undefined) throw new Error('volter world changeset: say what and why — volter world changeset -m "<message>"');
-      const cs = world.changeset({ ...(pos[0] ? { name: pos[0] } : {}), message, ...(value(args, '--base') ? { base: value(args, '--base')! } : {}), overwrite: flag(args, '--force') });
+      const cs = world.changeset({ ...(pos[0] ? { name: pos[0] } : {}), ...(message !== undefined ? { message } : {}), ...(value(args, '--base') ? { base: value(args, '--base')! } : {}), overwrite: flag(args, '--force') });
       if (asJson) { json(cs); return; }
-      out(`changeset  ${cs.name}  ${cs.actions.length} change${cs.actions.length === 1 ? '' : 's'}\n  ${message}${cs.narration ? `\n${cs.narration.split('\n').map((l) => `  ${l}`).join('\n')}` : ''}`);
+      out(`changeset  ${cs.name}  ${cs.actions.length} change${cs.actions.length === 1 ? '' : 's'}${cs.message ? `\n  ${cs.message}` : ''}${cs.narration ? `\n${cs.narration.split('\n').map((l) => `  ${l}`).join('\n')}` : ''}`);
       return;
     }
     case 'view':
@@ -490,7 +489,7 @@ async function loginCommand(args: string[]): Promise<void> {
   const res = await fetch(`${origin}/-/orgs`, { headers: { authorization: `Bearer ${token}` } });
   const body = (await res.json().catch(() => ({}))) as { person?: { email?: string; id?: string }; orgs?: Array<{ slug: string | null; name: string }>; error?: string };
   if (!res.ok) throw new Error(`${origin} answered ${res.status}: ${body.error ?? 'not signed in'}`);
-  storeToken(origin, token); storePlatform(origin);
+  storeToken(origin, token); storePlatform(origin, undefined, body.person?.email ?? body.person?.id);
   out(`signed in  ${origin}  as ${body.person?.email ?? body.person?.id ?? 'you'}\norgs       ${(body.orgs ?? []).map((o) => o.slug ?? o.name).join(', ') || '(none yet)'}\nnext       in your app's folder: volter world init, then volter remote add origin ${(body.orgs ?? [])[0]?.slug ?? '<org>'}/<world> --create`);
 }
 

package/src/credentials.ts

@@ -47,9 +47,15 @@ export function forgetToken(origin: string, path: string = credentialsPath()): b
 
 /** `volter login`: the hosted platform a person signed the CLI into — its origin, beside the credentials. */
 export function platformPath(): string { return join(dirname(credentialsPath()), 'platform.json'); }
-export function storePlatform(origin: string, path: string = platformPath()): void {
+export function storePlatform(origin: string, path: string = platformPath(), person?: string): void {
   mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
-  writeFileSync(path, `${JSON.stringify({ url: normalizeOrigin(origin), savedAt: new Date().toISOString() }, null, 2)}\n`, { mode: 0o600 });
+  writeFileSync(path, `${JSON.stringify({ url: normalizeOrigin(origin), ...(person ? { person } : {}), savedAt: new Date().toISOString() }, null, 2)}\n`, { mode: 0o600 });
+}
+/** Whom `volter login` signed the CLI in as (the platform's email or id for them): this machine's person, whom a World
+ *  served here records as acting from its own page (docs/contributing/architecture.md, "Who acted is recorded"). */
+export function platformPerson(path: string = platformPath()): string | undefined {
+  if (!existsSync(path)) return undefined;
+  try { const p = (JSON.parse(readFileSync(path, 'utf8')) as { person?: unknown }).person; return typeof p === 'string' && p !== '' ? p : undefined; } catch { return undefined; }
 }
 /** Forget which platform the CLI is signed into. */
 export function forgetPlatform(path: string = platformPath()): void { if (existsSync(path)) writeFileSync(path, '{}\n', { mode: 0o600 }); }

package/src/world.ts

@@ -2,6 +2,7 @@
 // docs/concepts/worlds.md#the-config-and-the-running-world): a branch with compute attached. `World.open()` finds the world of the cwd the
 // way git finds its repository; every method is a name for a world-runtime verb, in the words a
 // user reads. The `volter` command is one client of this class and adds nothing.
+import { platformPerson } from './credentials.ts';
 import { rebaseChangeset, worldBootMarker, type Changeset, type ChangesetApplication, type LedgerDelta, type PerformAction, type RemoteExecute, type TwinAction, type WorldMarker, type ApplyReceipt, listActions, isTwinBookkeeping, pushablePendingActions, pendingActions, applyTwinWrite, twinResources, type TwinResource } from '@volter/world-core';
 import { spawnSync } from 'node:child_process';
 import clockForm from '@volter/world-core/world-clock';
@@ -10,7 +11,7 @@ import {
   statusWorld, statusWorldChangeset, upWorld, verifyWorldChangeset, worldLedgers, worldOrigin,
   bindLegacyCredentials, deployWorld, loadWorldConfig, writeWorldConfig, readServeRecord, refreshTwin, serveWorld, serveWorldView, findInstalledPackage, type ServedWorld, type ViewConsole, type WorldView, rootForControlRoot, sealTwinCredential, sealedCredentialInfo, setTwinRoot, credentialPayloadFrom, rootCredentialInput, withoutVaultSignIn,
   type DeployTwinOutcome, type MaterializedRoot,
-  type ChangesetLocation, type InitOptions, type InitResult, type WorldInstance, materializeRoots } from '@volter/world-runtime';
+  type ChangesetLocation, type InitOptions, type InitResult, type WorldInstance, materializeRoots, worldChangesetRules } from '@volter/world-runtime';
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { requireToken, storeToken } from './credentials.ts';
@@ -338,7 +339,7 @@ export class World {
   /** Serve this world on a port under `/<org>/<world>/`; returns when listening. */
   serve(opts: { port?: number; host?: string; consolePort?: number; announce?: (info: { name: string; base: string; token: string; readToken: string; console: string | null }) => void } = {}): Promise<ServedWorld> { return serveWorld(this.name, { root: this.root, ...opts }); }
   /** `volter world view`: this World, its mirrors, its branches and the console on one origin (docs/contributing/architecture.md, "Viewing a World"). */
-  view(opts: { port?: number; host?: string; console?: ViewConsole; announce?: (line: string) => void; origins?: boolean; origin?: string } = {}): Promise<WorldView> { return serveWorldView(this.name, { root: this.root, ...opts }); }
+  view(opts: { port?: number; host?: string; console?: ViewConsole; announce?: (line: string) => void; origins?: boolean; origin?: string } = {}): Promise<WorldView> { const person = platformPerson(); return serveWorldView(this.name, { root: this.root, ...(person ? { localPerson: person } : {}), ...opts }); }
 
   // ── remotes ─────────────────────────────────────────────────────────────────────────────
   /** The vendors this world has a twin of, as world.json names them (a twin service's package, else its id). */
@@ -411,8 +412,15 @@ export class World {
   // ── changesets and push ─────────────────────────────────────────────────────────────────
   /** Cut a changeset from the unpushed changes: the reviewable unit, with the author's message. */
   changeset(opts: { name?: string; message?: string; base?: string; verifiers?: Parameters<typeof createWorldChangeset>[2] extends infer O ? (O extends { verifiers?: infer V } ? V : never) : never; overwrite?: boolean } = {}): Changeset {
-    const name = opts.name ?? (opts.message ? slugName(opts.message, this.changesets()) : nextChangesetName(this.changesets()));
-    return createWorldChangeset(this.name, name, { root: this.root, ...(opts.message !== undefined ? { message: opts.message } : {}), ...(opts.base ? { base: opts.base } : {}), ...(opts.verifiers ? { verifiers: opts.verifiers } : {}), ...(opts.overwrite ? { overwrite: true } : {}) });
+    // a summary is the author's, unless this World's rules take the one generated from its changes; a blank one is none
+    const message = opts.message?.trim() || undefined;
+    if (message === undefined && worldChangesetRules(this.root).summary !== 'generated') throw new Error('volter world changeset: say what and why — volter world changeset -m "<message>"');
+    // with no summary, a cut must have something to say: an empty one is a slip (`volter world changeset status`)
+    if (message === undefined && !opts.overwrite && this.diff(opts.base).actions.length === 0) throw new Error(`Nothing to cut in world "${this.name}": every change is already in a changeset`);
+    const name = opts.name ?? (message ? slugName(message, this.changesets()) : nextChangesetName(this.changesets()));
+    // cut on this machine: recorded as the person signed in here (`volter login`), else as no one in particular
+    const person = platformPerson();
+    return createWorldChangeset(this.name, name, { root: this.root, ...(person ? { cutBy: `person:${person}`, owner: person } : {}), ...(message !== undefined ? { message } : {}), ...(opts.base ? { base: opts.base } : {}), ...(opts.verifiers ? { verifiers: opts.verifiers } : {}), ...(opts.overwrite ? { overwrite: true } : {}) });
   }
   changesets(): ChangesetLocation[] { return listWorldChangesets({ root: this.root, world: this.name }); }
   /**