@yunsoft/yuncms 0.1.23 → 0.1.25

package/README.md

@@ -4,6 +4,10 @@ Command-line setup, runtime launcher and guarded upgrade tooling for YunCMS.
 
 YunCMS is developed and maintained by **[Yunsoft Software](https://yunsoft.com)**.
 
+Need help building your project, integrating YunCMS or migrating an existing backend? [Talk to Yunsoft](https://yunsoft.com/contact?utm_source=npm&utm_medium=yuncms&utm_campaign=yuncms-services). Support the project by [starring it on GitHub](https://github.com/Yunsoft-Software/yuncms) or [sponsor YunCMS](https://github.com/sponsors/Yunsoft-Software).
+
+Configure repeated summaries, classifications or translations through Studio/MCP with [AI Automations](https://github.com/Yunsoft-Software/yuncms/blob/main/docs/ai-automations.md): preview a record, select restricted input/output fields and inspect persistent run history.
+
 ## Quick start
 
 You do **not** need to clone or fork the YunCMS repository. From an empty project directory, run the published package directly:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yunsoft/yuncms",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "Command-line setup and runtime launcher for YunCMS.",
   "license": "MIT",
   "type": "module",
@@ -30,7 +30,11 @@
     "test": "node --test"
   },
   "dependencies": {
-    "@yunsoft/yuncms-api": "0.1.23",
-    "@yunsoft/yuncms-core": "0.1.23"
+    "@yunsoft/yuncms-api": "0.1.25",
+    "@yunsoft/yuncms-core": "0.1.25"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/Yunsoft-Software"
   }
 }

package/src/cli.js

@@ -4,6 +4,7 @@ import { runInitCommand } from './init-command.js';
 import { runRestoreCommand } from './restore-command.js';
 import { runStartCommand } from './start-command.js';
 import { runUpdateCommand } from './update-command.js';
+import { printCommunityLinks } from './community-links.js';
 
 function assertSupportedNode(version = process.versions.node) {
   const major = Number(String(version).split('.')[0]);
@@ -41,7 +42,11 @@ export async function runCli(argv = process.argv.slice(2), {
   switch (command) {
     case 'init':
       assertNoArguments(command, rest);
-      return runInitCommand({ env, cwd, output, ...(prompts ? { prompts } : {}) });
+      {
+        const result = await runInitCommand({ env, cwd, output, ...(prompts ? { prompts } : {}) });
+        printCommunityLinks({ env, output });
+        return result;
+      }
     case 'bootstrap':
       assertNoArguments(command, rest);
       return runBootstrapCommand({ env, output });
@@ -59,6 +64,7 @@ export async function runCli(argv = process.argv.slice(2), {
     case '-h':
       assertNoArguments(command, rest);
       printHelp(output);
+      printCommunityLinks({ env, output, help: true });
       return null;
     default: {
       const error = new Error(`Unknown YunCMS command: ${command}`);

package/src/community-links.js

@@ -0,0 +1,10 @@
+export const COMMUNITY_LINKS = Object.freeze({
+  github: 'https://github.com/Yunsoft-Software/yuncms',
+  services: 'https://yunsoft.com/contact?utm_source=cli&utm_medium=yuncms&utm_campaign=yuncms-services',
+  sponsorship: 'https://github.com/sponsors/Yunsoft-Software',
+});
+
+export function printCommunityLinks({ output = console, env = process.env, isTTY = process.stdout.isTTY, help = false } = {}) {
+  if (!help && (!isTTY || env.CI)) return;
+  output.log?.(`\nEnjoy YunCMS? Star the project: ${COMMUNITY_LINKS.github}\nBuild with Yunsoft — setup, migration and AI workflows: ${COMMUNITY_LINKS.services}\nSponsor YunCMS: ${COMMUNITY_LINKS.sponsorship}`);
+}

package/src/runtime-probe.js

@@ -1,7 +1,10 @@
-import { spawn } from 'node:child_process';
+import { execFileSync, spawn } from 'node:child_process';
 import { resolve } from 'node:path';
 
 import { MAINTENANCE_BYPASS_ENV } from '@yunsoft/yuncms-core';
+import { ATTACHED_RUNTIME_ENV } from './start-command.js';
+
+export const DEFAULT_PROBE_SHUTDOWN_GRACE_MS = 12_000;
 
 function delay(ms) {
   return new Promise((resolveDelay) => setTimeout(resolveDelay, ms));
@@ -9,8 +12,10 @@ function delay(ms) {
 
 function probeError(code, message, details = {}) {
   const error = new Error(message);
+  const { code: exitCode, ...otherDetails } = details;
+  Object.assign(error, otherDetails);
+  if (Object.hasOwn(details, 'code')) error.exitCode = exitCode;
   error.code = code;
-  Object.assign(error, details);
   return error;
 }
 
@@ -22,7 +27,7 @@ export async function verifyInstalledRuntime({
   fetchFn = globalThis.fetch,
   spawnProcess = spawn,
   timeoutMs = 15_000,
-  shutdownGraceMs = 3_000,
+  shutdownGraceMs = DEFAULT_PROBE_SHUTDOWN_GRACE_MS,
 } = {}) {
   if (!Number.isInteger(port) || port < 1 || port > 65535) {
     throw probeError('UPDATE_PROBE_PORT_INVALID', `Invalid probe port: ${port}`);
@@ -48,6 +53,7 @@ export async function verifyInstalledRuntime({
     PORT: String(port),
     STUDIO_ORIGIN: origin,
     AUTH_PUBLIC_URL: origin,
+    [ATTACHED_RUNTIME_ENV]: '1',
   };
   if (maintenanceBypassToken !== null) childEnv[MAINTENANCE_BYPASS_ENV] = maintenanceBypassToken;
 
@@ -55,6 +61,7 @@ export async function verifyInstalledRuntime({
     cwd,
     env: childEnv,
     stdio: ['ignore', 'ignore', 'pipe'],
+    detached: process.platform !== 'win32',
   });
 
   let stderr = '';
@@ -65,6 +72,7 @@ export async function verifyInstalledRuntime({
 
   let settled = false;
   let shutdownAttempted = false;
+  let readyAndStopped = false;
   const exitPromise = new Promise((resolveExit, rejectExit) => {
     child.once('error', (error) => {
       if (settled) return;
@@ -81,9 +89,18 @@ export async function verifyInstalledRuntime({
 
   function requestKill(signal) {
     try {
+      if (signal === 'SIGKILL' && Number.isInteger(child.pid)) {
+        if (process.platform === 'win32') {
+          execFileSync('taskkill', ['/pid', String(child.pid), '/T', '/F'], { stdio: 'ignore', timeout: 1000 });
+        } else {
+          process.kill(-child.pid, signal);
+        }
+        return;
+      }
       child.kill(signal);
     } catch {
-      // The bounded shutdown path still escalates and reports a timeout.
+      // ESRCH is expected for an exited group; keep a bounded direct-child fallback.
+      try { child.kill(signal); } catch {}
     }
   }
 
@@ -145,6 +162,7 @@ export async function verifyInstalledRuntime({
             if (result.code !== 0 && result.signal !== 'SIGTERM') {
               throw probeError('UPDATE_PROBE_SHUTDOWN_FAILED', 'Updated runtime did not stop cleanly', result);
             }
+            readyAndStopped = true;
             return { ready: true, origin };
           }
         }
@@ -161,5 +179,6 @@ export async function verifyInstalledRuntime({
     if (!settled && !shutdownAttempted) {
       await stopProbe({ strict: false }).catch(() => null);
     }
+    if (settled && !readyAndStopped && Number.isInteger(child.pid)) requestKill('SIGKILL');
   }
 }

package/src/start-command.js

@@ -3,6 +3,9 @@ import { fileURLToPath } from 'node:url';
 
 import { assertMaintenanceStartupAllowed } from '@yunsoft/yuncms-core';
 
+// Internal updater transport flag: the probe owns the entire process group.
+export const ATTACHED_RUNTIME_ENV = 'YUNCMS_CLI_ATTACHED_RUNTIME';
+
 export async function runStartCommand({
   env = process.env,
   cwd = process.cwd(),
@@ -21,7 +24,7 @@ export async function runStartCommand({
     cwd,
     env: { ...env },
     stdio: 'inherit',
-    detached: process.platform !== 'win32',
+    detached: process.platform !== 'win32' && env[ATTACHED_RUNTIME_ENV] !== '1',
   });
 
   return new Promise((resolve, reject) => {