amorphous-cli 0.1.9 → 0.1.11

package/README.md

@@ -1,6 +1,6 @@
 # amorphous-cli
 
-Make whatever you want, yourself, with your own agent, or with others. And whatever you want can be private, public, or even have users.
+Make whatever you want, yourself, with your own agent, or with others. And whatever you want can be private, public, or even have users of its own.
 
 ```bash
 npx amorphous-cli@latest setup

package/lib/agent-contract.mjs

@@ -5,7 +5,7 @@ import { fileURLToPath } from 'node:url'
 import { homedir } from 'node:os'
 import { CLI_VERSION } from './version.mjs'
 
-export const CONTRACT_VERSION = 10
+export const CONTRACT_VERSION = 13
 
 const skillRoot = join(dirname(fileURLToPath(import.meta.url)), '../skill/amorphous')
 

package/lib/api.mjs

@@ -2,7 +2,6 @@ import { cliAppFetchOrigin, cliAppHostHeader } from './config.mjs'
 import { ensureFreshSession } from './session.mjs'
 
 const FRIENDLY = {
-  'You already own 2 abstracts': 'You already own 2 abstracts. Run: amorphous-cli list',
   'This abstract already has 8 people': 'This abstract already has 8 people. Run: amorphous-cli people',
   'User not found': 'No account with that email yet.',
   'Grant failed': 'Could not invite. Run: amorphous-cli people',
@@ -27,6 +26,9 @@ export function friendlyMessage(raw) {
   if (FRIENDLY[text]) return FRIENDLY[text]
   const stripped = text.replace(/^\d{3}\s+/, '')
   if (FRIENDLY[stripped]) return FRIENDLY[stripped]
+  if (/^You already own \d+ abstracts$/.test(stripped)) {
+    return `${stripped}. Run: amorphous-cli list`
+  }
   return stripped || text || 'Request failed.'
 }
 

package/lib/commands.mjs

@@ -199,6 +199,11 @@ async function cmdSetup(rest) {
   }
   console.log('Installed the Amorphous skill.')
   for (const dir of dirs ?? installUserSkill()) console.log(dir)
+  console.log(`
+Tell the person:
+They describe what they want made. You make it.
+Prefer amorphous-cli serve while you edit. Open the URL and leave it running. It reloads when the files change.
+They tell you when to push, preview, publish, or invite.`)
 }
 
 async function cmdCreate(cwd, rest) {
@@ -225,7 +230,10 @@ async function cmdCreate(cwd, rest) {
   writeStarter(cwd)
   syncProjectContract(cwd)
   if (jsonMode(flags)) printJson({ id, name: name || 'Untitled' })
-  else console.log(id)
+  else {
+    console.log(id)
+    console.log('Prefer amorphous-cli serve while you edit.')
+  }
 }
 
 function takeAccess(flags, positional) {
@@ -326,6 +334,7 @@ async function cmdPull(cwd, rest) {
   })
   syncProjectContract(cwd)
   console.log('Pulled.')
+  console.log('Prefer amorphous-cli serve while you edit.')
 }
 
 async function cmdPush(cwd, rest) {

package/lib/help.mjs

@@ -7,7 +7,7 @@ export const ROOT_HELP = `Amorphous
   create                        New abstract
   open [abstract]               Open URL
   preview [abstract]            Preview URL (draft)
-  serve                         Serve this folder locally
+  serve                         Develop in this folder
   pull                          Pull draft and records to this folder
   push                          Push local files
   publish [--live]              Publish a version; --live is Go live
@@ -67,7 +67,7 @@ Print the Preview URL (draft).`,
 
   serve: `serve [--port <n>] [--json]
 
-Serve this folder on 127.0.0.1 and reload when index.html, styles.css, or app.js changes.
+Preferred way to develop in this folder. Serves it on 127.0.0.1 and reloads when index.html, styles.css, or app.js changes. Leave it running and open the URL.
 Records start local, in this folder. The page can switch to prod, which reads and writes the abstract's records.`,
 
   pull: `pull

package/mcp.mjs

@@ -72,7 +72,7 @@ await serveStdio(() => {
     {
       title: 'Pull the abstract',
       description:
-        'Download the abstract files and records into this folder. Overwrites the local copies of those files.',
+        'Download the abstract files and records into this folder. Overwrites the local copies of those files. Prefer amorphous-cli serve while editing; it reloads as the files change.',
       inputSchema: z.object({}),
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "amorphous-cli",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "mcpName": "io.github.amorphous-one/amorphous",
   "description": "Make whatever you want, yourself, with your own agent, or with others.",
   "type": "module",

package/skill/amorphous/SKILL.md

@@ -3,7 +3,7 @@ name: amorphous
 description: Make whatever you want, yourself, with your own agent, or with others. Use when someone wants an abstract other people can open, or wants to invite people, publish, or change an abstract.
 ---
 
-Make whatever you want, yourself, with your own agent, or with others. And whatever you want can be private, public, or even have users.
+Make whatever you want, yourself, with your own agent, or with others. And whatever you want can be private, public, or even have users of its own.
 
 ## Files
 
@@ -30,6 +30,14 @@ A running abstract provides `amorphous` in `app.js`:
 
 A private record belongs to the signed-in person who wrote it. The abstract does not read `private.ndjson`.
 
+## Person
+
+After `setup`, tell them this, briefly. `setup` also prints it. Say it to them in your own words.
+
+They describe what they want made. You make it.
+Prefer `amorphous-cli serve` while you edit. Open the URL and leave it running. It reloads when the files change, and it is the easiest way for them to look at the work.
+They tell you when to push, preview, publish, or invite. Do those when they ask.
+
 ## Loop
 
 Install the CLI once with `npm install -g amorphous-cli@latest`, then call it as `amorphous-cli <command>`. If a command prints `Run: npm install -g amorphous-cli@latest && amorphous-cli setup`, run that line, then repeat the command.
@@ -37,11 +45,14 @@ Install the CLI once with `npm install -g amorphous-cli@latest`, then call it as
 1. If you are not signed in, run `amorphous-cli login`. Show the person the link it prints and ask them to finish in the browser. Do not ask for an email or a code.
 2. `amorphous-cli create --name "..."` in a folder, or `amorphous-cli pull` when `.amorphous.json` is already there.
 3. Edit the files to match what they asked for. `me` and `names` are how the abstract knows who is here.
-4. `amorphous-cli serve` and open that URL. It reloads when the files change. Records on that page start in this folder. Switch the page to prod to read and write the abstract's records.
-5. `amorphous-cli push` sends the source. `amorphous-cli push --data` also sends the records in this folder.
-6. `amorphous-cli preview` and open that URL.
-7. `amorphous-cli publish --live`
-8. `amorphous-cli invite <email> use` or `edit` or `view`. It prints a link and does not send an email. Give them that link. They open it and sign in with that email.
+4. Prefer `amorphous-cli serve` while you edit. Open that URL and leave it running. It reloads when the files change, and it is the easiest way to check the work. Records on that page start in this folder. Switch the page to prod to read and write the abstract's records. You can push and preview without it.
+
+When they ask:
+
+- `amorphous-cli push` sends the source. `amorphous-cli push --data` also sends the records in this folder.
+- `amorphous-cli preview` and open that URL.
+- `amorphous-cli publish --live`
+- `amorphous-cli invite <email> use` or `edit` or `view`. It prints a link and does not send an email. Give them that link. They open it and sign in with that email.
 
 `amorphous-cli visibility anyone` lets anyone view and write shared records. `amorphous-cli visibility members` keeps the abstract to invited people.