@grayspar/cli 0.0.4 → 0.0.5

package/dist/commands/access.js

@@ -87,17 +87,17 @@ accessCommand
 accessCommand
     .command('add')
     .argument('<targets...>', 'email addresses, or @company.example for everyone at a company')
-    .description('let named people or a whole company open a project')
+    .description('let people or a whole company open a project')
     .action(commandAction((format, _command, targets) => addAccess(targets, format)));
 accessCommand
     .command('remove')
     .argument('<target>', 'an email address, or @company.example')
-    .description('take someone or a company off a project')
+    .description("remove a person or company from a project's list")
     .action(commandAction((format, _command, target) => removeAccess(target, format)));
 accessCommand
     .command('set')
     .addOption(new Option('--mode <mode>', 'restricted lets in the people and companies on the list, open lets in anyone with the link')
     .choices(['restricted', 'open'])
     .makeOptionMandatory())
-    .description('choose whether the list decides who can open a project')
+    .description('choose whether only the list or anyone with the link can open a project')
     .action(commandAction((format, command) => setGeneralAccess(command.opts().mode, format)));

package/dist/commands/deploy/deploy.js

@@ -179,7 +179,7 @@ async function printOutcome(api, project, outcome) {
 }
 export const deployCommand = new Command('deploy')
     .argument('[folder]', 'deploy only the files under this folder of the project', '.')
-    .description('build a project folder and put it online')
+    .description('build a folder and put it online as a project')
     .option('-y, --yes', 'take the plan as shown without asking')
     .option('--name <name>', 'create a new project with this name')
     .option('--no-env', 'deploy without reading any .env file')

package/dist/commands/env.js

@@ -61,11 +61,11 @@ envCommand
     .command('set')
     .argument('<pairs...>', 'variables written as KEY=VALUE')
     .addOption(serviceOption('which service to set them on'))
-    .description('add or change environment variables')
+    .description('set variables on a service')
     .action(commandAction((format, command, pairs) => setVariables(pairs, serviceNameOf(command), format)));
 envCommand
     .command('remove')
     .argument('<keys...>', 'the names of the variables to remove')
     .addOption(serviceOption('which service to change'))
-    .description('remove environment variables')
+    .description('remove variables from a service')
     .action(commandAction((format, command, keys) => removeVariables(keys, serviceNameOf(command), format)));

package/dist/commands/link.js

@@ -21,8 +21,8 @@ async function unlink(format) {
     printResult(format, { status: 'ok' }, () => receipt(`Unlinked ${found.folder}`));
 }
 export const linkCommand = new Command('link')
-    .description('bind this folder to a project')
+    .description('link this folder to a project')
     .action(commandAction((format) => link(format)));
 export const unlinkCommand = new Command('unlink')
-    .description('unbind this folder from its project')
+    .description('unlink this folder from its project')
     .action(commandAction((format) => unlink(format)));

package/dist/commands/login/sign-in-callback.js

@@ -1,6 +1,5 @@
-/* Listens on a port the machine picks, catches exactly one redirect, and closes. The browser carries
-   a code; the verifier that makes it usable never leaves this process. The browser hears nothing until
-   the CLI has traded the code, so what its page says is true. */
+/* Listens on a port the machine picks for one redirect, then closes. The verifier that makes the browser's code usable
+   never leaves this process, and the browser hears nothing until the code is traded, so its page tells the truth. */
 import { createServer } from 'node:http';
 function browserPage(mark, markColor, title, detail) {
     return `<!doctype html><meta charset="utf-8"><meta name="color-scheme" content="light dark">

package/dist/commands/logout.js

@@ -14,5 +14,5 @@ async function logout(format) {
         : `${receipt('Signed out on this machine')}\n${warning("Grayspar couldn't be reached, so this sign-in stays valid there. Sign it out under Ways to sign in in the dashboard.")}`);
 }
 export const logoutCommand = new Command('logout')
-    .description('forget the saved sign-in on this machine')
+    .description('sign out on this machine')
     .action(commandAction((format) => logout(format)));

package/dist/commands/logs.js

@@ -98,7 +98,7 @@ async function printBuildLogs(api, format, follow) {
     }
 }
 export const logsCommand = new Command('logs')
-    .description('show what a service printed while running, or with --build the last build log')
+    .description("show a service's logs, or with --build its last build log")
     .addOption(serviceOption('which service to read'))
     .option('--build', 'show the log from the last build instead')
     .option('-f', 'keep printing new lines as they arrive')

package/dist/commands/restart.js

@@ -16,6 +16,6 @@ async function restart(serviceName, format) {
     printResult(format, { status: 'restarting', project: project.name, service: service.name }, () => `Restarting ${service.name}.\nTo follow it, run\n${follow}`);
 }
 export const restartCommand = new Command('restart')
-    .description('run a service again in place, keeping its volume')
+    .description("start a fresh copy of a service's running version")
     .addOption(serviceOption('which service to restart'))
     .action(commandAction((format, command) => restart(serviceNameOf(command), format)));

package/dist/commands/service.js

@@ -4,6 +4,7 @@ import { dataOrThrow, signedInClient } from '../lib/client.js';
 import { commandAction } from '../lib/command-helpers.js';
 import { CliError } from '../lib/errors.js';
 import { printResult } from '../lib/output.js';
+import { askText } from '../lib/prompt.js';
 import { resolveService } from '../lib/resolve-service.js';
 import { receipt } from '../lib/ui.js';
 function receiptsFor(service, change) {
@@ -38,7 +39,21 @@ async function setService(serviceName, change, format) {
     ];
     printResult(format, { status: 'ok' }, () => lines.join('\n'));
 }
-export const serviceCommand = new Command('service').description('change where a service answers and how it is built');
+async function removeService(serviceName, skipAsking, format) {
+    const api = await signedInClient();
+    const { project, service } = await resolveService(api, serviceName, '<name>');
+    if (!skipAsking) {
+        const typed = await askText(`Type ${service.name} to remove it with its volume and variables`, null, '--yes');
+        if (typed !== service.name) {
+            throw new CliError('name_mismatch', `That isn't ${service.name}. The service stays.`);
+        }
+    }
+    await dataOrThrow(api.DELETE('/api/projects/{projectId}/services/{serviceId}', {
+        params: { path: { projectId: project.id, serviceId: service.id } },
+    }));
+    printResult(format, { status: 'removed', service: service.name, project: project.name }, () => `${receipt(`Removed service ${service.name} from ${project.name}`)}\nAny future grayspar deploy will redeploy the ${service.name} service.`);
+}
+export const serviceCommand = new Command('service').description('change where a service answers and how it is built, or remove it');
 serviceCommand
     .command('set')
     .argument('[name]', 'the service to change, left out when the project has one')
@@ -61,3 +76,9 @@ serviceCommand
     };
     return setService(name, change, format);
 }));
+serviceCommand
+    .command('remove')
+    .argument('<name>', 'the service to remove')
+    .option('-y, --yes', 'remove it without asking')
+    .description('remove a service with its volume and variables')
+    .action(commandAction((format, command, name) => removeService(name, command.opts().yes === true, format)));

package/dist/commands/status.js

@@ -11,5 +11,5 @@ async function status(format) {
     printResult(format, project, () => `${color.heading(project.name)}\n\n${servicesTable(project)}`);
 }
 export const statusCommand = new Command('status')
-    .description('show what a project is doing')
+    .description("show each service's address and status")
     .action(commandAction((format) => status(format)));

package/dist/commands/volume.js

@@ -66,22 +66,22 @@ export async function removeVolume(mountPath, serviceName, skipAsking, format) {
         receipts: [`Removed volume ${mountPath} from ${service.name} and deleted its data`],
     });
 }
-export const volumeCommand = new Command('volume').description('keep a folder across deploys');
+export const volumeCommand = new Command('volume').description('keep folders across deploys with volumes');
 volumeCommand
     .command('list', { isDefault: true })
     .addOption(serviceOption('which service to read'))
-    .description('list the folders a service keeps')
+    .description('list the volumes of a project')
     .action(commandAction((format, command) => listVolumes(serviceNameOf(command), format)));
 volumeCommand
     .command('add')
     .argument('<path>', 'the folder inside the service to keep, such as /app/data')
     .addOption(serviceOption('which service keeps it'))
-    .description('keep a folder across deploys')
+    .description('add a volume to a service')
     .action(commandAction((format, command, path) => addVolume(path, serviceNameOf(command), format)));
 volumeCommand
     .command('remove')
     .argument('<path>', 'a folder the service keeps')
     .addOption(serviceOption('which service keeps it'))
     .option('-y, --yes', 'remove it without asking')
-    .description('stop keeping a folder, and throw its data away')
+    .description('delete a volume and its data')
     .action(commandAction((format, command, path) => removeVolume(path, serviceNameOf(command), command.opts().yes === true, format)));

package/dist/commands/whoami.js

@@ -12,5 +12,5 @@ async function whoami(format) {
     printResult(format, { ...profile, teams }, () => `Signed in as ${profile.email}\n\n${table(['TEAM', 'SLUG'], teams.map((team) => [team.name, team.slug]))}`);
 }
 export const whoamiCommand = new Command('whoami')
-    .description('show who this machine is signed in as')
+    .description('show which account this machine is signed in with')
     .action(commandAction((format) => whoami(format)));

package/dist/index.js

@@ -1,60 +1,5 @@
 #!/usr/bin/env node
-/* Every command is a singular noun and one of four verbs, or a single flat verb. `.claude/rules/cli.md` holds the
-   grammar, and each command's own file holds its flags; here are only the flags they all share. */
-import { Command } from 'commander';
-import { accessCommand } from './commands/access.js';
-import { deployCommand } from './commands/deploy/deploy.js';
-import { envCommand } from './commands/env.js';
-import { linkCommand, unlinkCommand } from './commands/link.js';
-import { loginCommand } from './commands/login/login.js';
-import { logoutCommand } from './commands/logout.js';
-import { logsCommand } from './commands/logs.js';
-import { openPathCommand } from './commands/open-path.js';
-import { projectCommand } from './commands/project.js';
-import { restartCommand } from './commands/restart.js';
-import { serviceCommand } from './commands/service.js';
-import { statusCommand } from './commands/status.js';
-import { volumeCommand } from './commands/volume.js';
-import { whoamiCommand } from './commands/whoami.js';
-import { setJsonOutput } from './lib/prompt.js';
-import { setNamedProject } from './lib/resolve-project.js';
-import { setNamedTeam } from './lib/resolve-team.js';
-import { routeUsageErrors } from './lib/usage-errors.js';
-import { cliVersion } from './lib/version.js';
-const program = new Command()
-    .name('grayspar')
-    .description('deploy your applications and share them with exactly the people you choose')
-    .version(cliVersion, '--version', 'show the version')
-    .option('--json', 'answer in JSON, for scripts and agents')
-    .option('--team <slug>', 'which of your teams to work in')
-    .option('--project <name>', 'which project to act on, instead of the linked one')
-    .option('--no-color', 'print without colour')
-    .hook('preAction', (_program, command) => {
-    const { json, team, project } = command.optsWithGlobals();
-    setJsonOutput(json === true);
-    setNamedTeam(team);
-    setNamedProject(project);
-});
-for (const command of [
-    loginCommand,
-    logoutCommand,
-    whoamiCommand,
-    deployCommand,
-    projectCommand,
-    accessCommand,
-    openPathCommand,
-    envCommand,
-    volumeCommand,
-    serviceCommand,
-    linkCommand,
-    unlinkCommand,
-    statusCommand,
-    logsCommand,
-    restartCommand,
-]) {
-    program.addCommand(command);
-}
-routeUsageErrors(program);
+import { program } from './program.js';
 // A reader such as `head` can leave early, which ends the output and nothing more.
 process.stdout.on('error', (error) => {
     if (error.code === 'EPIPE')

package/dist/lib/retry-transient.js

@@ -1,6 +1,5 @@
-/* A request that never arrived or failed without Grayspar's own answer is tried again with a growing, jittered wait,
-   for as long as failures follow one another without a break, then the last failure is let through. The two minutes
-   count from the start of the first failing attempt, and each later attempt is cut off when they are up. */
+/* A request that never arrived or failed without Grayspar's answer retries with growing, jittered waits while failures
+   run unbroken, for two minutes from the first failing attempt, which also end the last; then the failure stands. */
 import { setTimeout as pause } from 'node:timers/promises';
 import { CliError } from './errors.js';
 const FIRST_DELAY_MS = 1000;

package/dist/lib/services-table.js

@@ -5,6 +5,8 @@ const RUNTIME_STATUS = {
     running: { label: 'Running', tint: color.ok },
     restarting: { label: 'Restarting', tint: untinted },
     crashed: { label: 'Crashed', tint: color.bad },
+    sleeping: { label: 'Sleeping', tint: untinted },
+    stopped: { label: 'Stopped', tint: untinted },
     unknown: { label: 'Unknown', tint: untinted },
     failed: { label: 'Failed', tint: color.bad },
 };

package/dist/program.js

@@ -0,0 +1,56 @@
+/* Every command is a singular noun and one of four verbs, or a single flat verb. `.claude/rules/cli.md` holds the
+   grammar, and each command's own file holds its flags; here are only the flags they all share. */
+import { Command } from 'commander';
+import { accessCommand } from './commands/access.js';
+import { deployCommand } from './commands/deploy/deploy.js';
+import { envCommand } from './commands/env.js';
+import { linkCommand, unlinkCommand } from './commands/link.js';
+import { loginCommand } from './commands/login/login.js';
+import { logoutCommand } from './commands/logout.js';
+import { logsCommand } from './commands/logs.js';
+import { openPathCommand } from './commands/open-path.js';
+import { projectCommand } from './commands/project.js';
+import { restartCommand } from './commands/restart.js';
+import { serviceCommand } from './commands/service.js';
+import { statusCommand } from './commands/status.js';
+import { volumeCommand } from './commands/volume.js';
+import { whoamiCommand } from './commands/whoami.js';
+import { setJsonOutput } from './lib/prompt.js';
+import { setNamedProject } from './lib/resolve-project.js';
+import { setNamedTeam } from './lib/resolve-team.js';
+import { routeUsageErrors } from './lib/usage-errors.js';
+import { cliVersion } from './lib/version.js';
+export const program = new Command()
+    .name('grayspar')
+    .description('deploy your applications and share them with exactly the people you choose')
+    .version(cliVersion, '--version', 'show the version')
+    .option('--json', 'answer in JSON, for scripts and agents')
+    .option('--team <slug>', 'which of your teams to work in')
+    .option('--project <name>', 'which project to act on, instead of the linked one')
+    .option('--no-color', 'print without colour')
+    .hook('preAction', (_program, command) => {
+    const { json, team, project } = command.optsWithGlobals();
+    setJsonOutput(json === true);
+    setNamedTeam(team);
+    setNamedProject(project);
+});
+for (const command of [
+    loginCommand,
+    logoutCommand,
+    whoamiCommand,
+    deployCommand,
+    projectCommand,
+    accessCommand,
+    openPathCommand,
+    envCommand,
+    volumeCommand,
+    serviceCommand,
+    linkCommand,
+    unlinkCommand,
+    statusCommand,
+    logsCommand,
+    restartCommand,
+]) {
+    program.addCommand(command);
+}
+routeUsageErrors(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grayspar/cli",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "The cloud for small software. Deploy your applications with one command, and share them with exactly the people you choose.",
   "repository": {
     "type": "git",