@memohai/cloud-runtime 0.1.0 → 2026.9.12-1

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@memohai/cloud-runtime",
-  "version": "0.1.0",
+  "version": "2026.9.12-1",
   "description": "Memoh Cloud Remote Runtime CLI — connects a local machine to Memoh Cloud",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/memohai/Memoh-Cloud.git",
+    "url": "git+https://github.com/felinics/Memoh-Cloud.git",
     "directory": "packages/cloud-runtime"
   },
   "license": "AGPL-3.0-only",
@@ -20,6 +20,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "prepack": "pnpm run build",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
   "engines": {
     "node": ">=20"
   },
@@ -28,10 +34,5 @@
     "esbuild": "0.27.2",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
-  },
-  "scripts": {
-    "build": "node scripts/build.mjs",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
   }
-}
+}

package/scripts/build.mjs

@@ -82,15 +82,16 @@ await verifyHelpBranding()
  * is live, so its own error is the success signal here.
  */
 async function verifyBundleLoads() {
-  const { code, stderr, stdout } = await run(process.execPath, [resolve(outdir, 'cli.mjs')], {
+  const { code, stderr, stdout } = await run(process.execPath, [resolve(outdir, 'cli.mjs'), '--server', 'https://runtime-smoke.invalid'], {
     // Scrub the developer's own credentials: with a key present the CLI would
-    // skip validation and try to connect, hanging the build.
+    // skip validation and try to connect, hanging the build. An explicit server
+    // also prevents the new CLI from reading any saved local enrollment.
     ...process.env,
     MEMOH_RUNTIME_SERVER: '',
     MEMOH_RUNTIME_KEY: '',
     MEMOH_RUNTIME_TEAM_ID: '',
   })
-  if (!stderr.includes('--server and --key are required')) {
+  if (code === 0 || !/--server and --key (?:are required|must be provided together)/.test(stderr)) {
     throw new Error(`bundle smoke test failed (exit ${code}):\n${stderr || stdout}`)
   }
 }

package/src/bootstrap.ts

@@ -14,14 +14,14 @@ const args = process.argv.slice(2)
 
 // Both flags are handled here rather than upstream: the usage string there
 // names `memoh-runtime` and cannot know the Cloud default endpoint, and
-// upstream has no --version at all.
-if (args.includes('--help') || args.includes('-h')) {
+// the build stamp also identifies the bundled upstream commit.
+if (args[0] === 'help' || args.includes('--help') || args.includes('-h')) {
   // stderr and exit 0, matching upstream's usage() contract.
-  console.error(cloudUsage())
+  console.error(cloudUsage(args))
   process.exit(0)
 }
 
-if (args.includes('--version') || args.includes('-v')) {
+if (args[0] === 'version' || args.includes('--version') || args.includes('-v')) {
   console.log(versionReport())
   process.exit(0)
 }

package/src/cloud.ts

@@ -30,10 +30,13 @@ export const serverUrlEnvVar = 'MEMOH_RUNTIME_SERVER'
  * install), which is why both escape hatches are checked first.
  */
 export function applyCloudDefaults(args: readonly string[], env: NodeJS.ProcessEnv): void {
-  // The prefix match also catches `--server=url`, a spelling upstream does NOT
-  // parse. Seeding the default there would silently redirect a mistyped-but-
-  // explicit endpoint to Cloud production; deferring lets upstream's own
-  // usage error surface so the caller fixes the spelling instead.
+  // A foreground run without a new key reads the saved enrollment. Injecting
+  // a server alone would turn it into an incomplete explicit connection.
+  if (!args.some(arg => arg === '--key' || arg.startsWith('--key=')) && !env.MEMOH_RUNTIME_KEY?.trim()) {
+    return
+  }
+  // Both endpoint spellings remain owned by the caller. Upstream validates
+  // their values; Cloud must not redirect an explicit endpoint.
   if (args.some(arg => arg === '--server' || arg.startsWith('--server='))) {
     return
   }
@@ -47,11 +50,24 @@ export function applyCloudDefaults(args: readonly string[], env: NodeJS.ProcessE
  * Cloud-branded help text. The upstream string names `memoh-runtime` and omits
  * the default endpoint, so this package prints its own and never reaches it.
  */
-export function cloudUsage(): string {
+export function cloudUsage(args: readonly string[] = []): string {
+  const command = args[0]
+  if (command === 'service') {
+    return 'Usage: memoh-cloud-runtime service <install|start|stop|restart|status|uninstall>\nInstall registers a stopped service. Use enroll first; status supports --json.'
+  }
+  if (command === 'enroll') {
+    return `Usage: memoh-cloud-runtime enroll --key <key> [--server <url>] [--team-id <uuid>] [--replace]\nOr use enroll --config <file>. Saves enrollment for future runs.\n--server defaults to ${cloudDefaultServerUrl} (or $MEMOH_RUNTIME_SERVER).`
+  }
+  if (command === 'run') {
+    return `Usage: memoh-cloud-runtime run [--key <key> [--server <url>] | --config <file>] [--log <file>]\nReads saved enrollment when no new connection is supplied. Never saves or changes a service.\n--server defaults to ${cloudDefaultServerUrl} when a new key is supplied.`
+  }
   return [
-    'Usage: memoh-cloud-runtime --key <key> [--team-id <uuid>] [--server <url>] [--insecure-localhost]',
+    'Usage: memoh-cloud-runtime <enroll|run|service|version>',
+    '       memoh-cloud-runtime --key <key> [--team-id <uuid>] [--server <url>] [--insecure-localhost]',
     '',
     'Connects this machine to Memoh Cloud as a remote runtime.',
+    'Use <command> --help for enrollment and user-service commands.',
+    'Running without connection flags reads the saved enrollment.',
     '',
     `  --server   defaults to ${cloudDefaultServerUrl}`,
     '             (or $MEMOH_RUNTIME_SERVER when exported)',