@ones-open/cli 0.0.11 → 0.0.12

package/dist/index.cjs

@@ -12,6 +12,7 @@ const lodashEs = require("lodash-es");
 const process$1 = require("node:process");
 const node_url = require("node:url");
 const cosmiconfig = require("cosmiconfig");
+const node_net = require("node:net");
 const getPort = require("get-port");
 const envPaths = require("env-paths");
 const zod = require("zod");
@@ -23,6 +24,9 @@ const http = require("node:http");
 const open = require("open");
 const uuid = require("uuid");
 const PKCEChallenge = require("pkce-challenge");
+const node_crypto = require("node:crypto");
+const promises = require("node:stream/promises");
+const node_os = require("node:os");
 var _documentCurrentScript = typeof document !== "undefined" ? document.currentScript : null;
 const en = {
   "desc.ones": "ONES CLI/{env}",
@@ -40,10 +44,21 @@ const en = {
   "desc.logout": "Log out of your ONES account",
   "desc.whoami": "Display the account information of the logged in user",
   "desc.app": "Manage app installations",
+  "desc.specs": "Manage ONES app specs resources to build your ONES App",
+  "desc.specs.fetch": "Fetch ONES app specs (download, checksum verify, and extract by default)",
+  "desc.specs.fetch.baseUrl": "Specify the base URL for specs resources",
+  "desc.specs.fetch.dir": "Specify the base directory (specs saved to <dir>/.ones/ones-app-specs)",
+  "desc.specs.fetch.noExtract": "Download only, do not extract archive automatically",
+  "desc.specs.fetch.json": "Output result in JSON format",
+  "desc.specs.fetch.force": "Force fetch even when local checksum is already up to date",
   "desc.install": "Install your ONES App",
   "desc.enable": "Enable your ONES App",
   "desc.disable": "Disable your ONES App",
   "desc.uninstall": "Uninstall your ONES App",
+  "desc.app.appId": "Specify app id",
+  "desc.logs": "View runtime logs for your ONES App",
+  "desc.logs.fromOpkxJson": "Read app id from local opkx.json when app id is not provided",
+  "desc.logs.tail": "Specify latest log lines to fetch (default 100)",
   "desc.legacy": "Legacy command",
   "desc.legacy.create": "Create a new ONES plugin",
   "desc.legacy.create.projectPath": "Specify the project path",
@@ -61,7 +76,14 @@ const en = {
   "error.store.permission": 'Permission denied, please check the file permission with "{filePath}"',
   "error.hostedToken.requestFailed": "Failed to request hosted token",
   "error.hostedToken.empty": "Hosted token is empty",
-  "error.legacy.create.missingProjectPath": "Project path is required"
+  "error.legacy.create.missingProjectPath": "Project path is required",
+  "error.specs.fetch.incorrectBaseURL": "Incorrect specs base URL",
+  "error.specs.fetch.fetchChecksumFailed": 'Failed to fetch checksum file from "{url}"',
+  "error.specs.fetch.incorrectChecksum": 'Invalid checksum content. Please provide a correct base URL that serves "ones-app-specs.sha256" in format "<sha256>  <zip-file>". Received: "{preview}"',
+  "error.specs.fetch.downloadFailed": 'Failed to download specs archive from "{url}"',
+  "error.specs.fetch.extractFailed": 'Failed to extract archive "{file}": {reason}',
+  "error.specs.fetch.cleanupFailed": 'Failed to cleanup archive "{file}": {reason}',
+  "error.specs.fetch.verifyChecksumFailed": 'SHA256 verification failed, expected "{expected}" but got "{actual}"'
 };
 const map = {
   en
@@ -108,6 +130,10 @@ var ErrorCode = ((ErrorCode2) => {
   ErrorCode2["HOSTED_TOKEN_EMPTY"] = "E14";
   ErrorCode2["INCORRECT_DEV_COMMAND"] = "E15";
   ErrorCode2["INCORRECT_BUILD_COMMAND"] = "E16";
+  ErrorCode2["INCORRECT_SPECS_BASE_URL"] = "E17";
+  ErrorCode2["INCORRECT_SPECS_CHECKSUM"] = "E18";
+  ErrorCode2["SPECS_FETCH_FAILED"] = "E19";
+  ErrorCode2["SPECS_CHECKSUM_MISMATCH"] = "E20";
   return ErrorCode2;
 })(ErrorCode || {});
 const getPackageJSONPath = () => {
@@ -161,6 +187,18 @@ const getAppManifestJSON = () => {
     return createOnesApp.throwError(ErrorCode.APP_MANIFEST_JSON_PARSE_ERROR, `${i18n.t("error.schema.app.manifest.parseError")}: ${details}`);
   }
 };
+const tryGetAppManifestJSON = function() {
+  let path = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : getAppManifestJSONPath();
+  try {
+    const string = node_fs.readFileSync(path, {
+      encoding: "utf8"
+    });
+    const json = JSON.parse(string);
+    return createOnesApp.AppManifestJSONSchema.parse(json);
+  } catch (error) {
+    return null;
+  }
+};
 const validateAppManifestJSON = () => {
   const appManifestJSON = getAppManifestJSON();
   try {
@@ -212,7 +250,7 @@ const getAppRcJSON = async () => {
 };
 const isOPKXFilename = /\.opkx$/;
 const defaultOutputPath = "";
-const normalize$a = async (options) => {
+const normalize$c = async (options) => {
   var _options$output, _options$command;
   let output = node_path.resolve(process$1.cwd(), (_options$output = options.output) !== null && _options$output !== void 0 ? _options$output : defaultOutputPath);
   const command = (_options$command = options.command) !== null && _options$command !== void 0 ? _options$command : "";
@@ -231,7 +269,7 @@ const normalize$a = async (options) => {
 };
 const {
   existsSync,
-  ensureDirSync
+  ensureDirSync: ensureDirSync$1
 } = fse;
 const build = async function() {
   var _appRcJSON$dev, _defaultAppRcJSON$dev, _appRcJSON$build$comm, _appRcJSON$build, _currentCommand$, _appRcJSON$build$comp, _appRcJSON$build2;
@@ -241,7 +279,7 @@ const build = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, buildCommandArguments);
-  const normalizedOptions = await normalize$a(options);
+  const normalizedOptions = await normalize$c(options);
   const appManifestJSON = getAppManifestJSON();
   const appRcJSON = await getAppRcJSON();
   const correctCommand = normalizedOptions.command || ((_appRcJSON$dev = appRcJSON.dev) === null || _appRcJSON$dev === void 0 || (_appRcJSON$dev = _appRcJSON$dev.command) === null || _appRcJSON$dev === void 0 ? void 0 : _appRcJSON$dev[0]) || ((_defaultAppRcJSON$dev = defaultAppRcJSON.dev) === null || _defaultAppRcJSON$dev === void 0 || (_defaultAppRcJSON$dev = _defaultAppRcJSON$dev.command) === null || _defaultAppRcJSON$dev === void 0 ? void 0 : _defaultAppRcJSON$dev[0]) || "";
@@ -289,7 +327,7 @@ const build = async function() {
   const outputPath = normalizedOptions.output;
   const outputDir = node_path.dirname(outputPath);
   const outputFilename = node_path.basename(outputPath);
-  ensureDirSync(outputDir);
+  ensureDirSync$1(outputDir);
   const outputStream = node_fs.createWriteStream(outputPath);
   const files = (_appRcJSON$build$comp = (_appRcJSON$build2 = appRcJSON.build) === null || _appRcJSON$build2 === void 0 || (_appRcJSON$build2 = _appRcJSON$build2.compress) === null || _appRcJSON$build2 === void 0 ? void 0 : _appRcJSON$build2.files) !== null && _appRcJSON$build$comp !== void 0 ? _appRcJSON$build$comp : [];
   const archive = archiver("zip", {
@@ -463,6 +501,7 @@ const API = {
   APP_ENABLE: "/platform/api/app/:installation_id/enable",
   APP_DISABLE: "/platform/api/app/:installation_id/disable",
   OAUTH_TOKEN: "/identity/oauth/token",
+  APP_RUNTIME_LOGS: "/platform/runtime_manager/app/runtime/logs",
   REFRESH_TOKEN: "/identity/oauth/token"
 };
 const REQUEST_TIMEOUT = 1e4;
@@ -653,12 +692,36 @@ const fetchHostedAbilityStorageDevDeclare = async (appID, data) => {
     data
   }).catch(handleError);
 };
-const fetchAppInstall = async (data) => {
-  var _appList$data$0$insta, _appList$data;
-  const appID = getAppManifestJSON().app.id;
+const getAppInstallation = async (appID) => {
+  var _appList$data$, _appList$data, _appData$installation, _appData$app_env;
   const appList = await fetchAppList(appID);
-  const installationID = (_appList$data$0$insta = (_appList$data = appList.data) === null || _appList$data === void 0 || (_appList$data = _appList$data[0]) === null || _appList$data === void 0 ? void 0 : _appList$data.installation_id) !== null && _appList$data$0$insta !== void 0 ? _appList$data$0$insta : "";
+  const appData = (_appList$data$ = (_appList$data = appList.data) === null || _appList$data === void 0 ? void 0 : _appList$data[0]) !== null && _appList$data$ !== void 0 ? _appList$data$ : {};
+  return {
+    installationID: (_appData$installation = appData.installation_id) !== null && _appData$installation !== void 0 ? _appData$installation : "",
+    appEnv: (_appData$app_env = appData.app_env) !== null && _appData$app_env !== void 0 ? _appData$app_env : "development"
+  };
+};
+const consoleProductionNotAllowedMessage = (operation) => {
+  console.log(`Cannot run "${operation}" in "production" environment`);
+  process.exit(1);
+};
+const getDisplayAppEnv = (appEnv) => {
+  return appEnv === "production" ? "production" : "development";
+};
+const consoleAppEnvMessage = (operation, appEnv) => {
+  console.log(`Operating "${operation}" in "${appEnv}" environment`);
+};
+const fetchAppInstall = async (appID, data) => {
+  const {
+    installationID,
+    appEnv
+  } = await getAppInstallation(appID);
   if (installationID) {
+    if (appEnv === "production") {
+      consoleProductionNotAllowedMessage("install");
+    }
+    const displayAppEnv = getDisplayAppEnv(appEnv);
+    consoleAppEnvMessage("install", displayAppEnv);
     return await fetchAppBase({
       url: API.APP_UPGRADE,
       method: "POST",
@@ -668,18 +731,24 @@ const fetchAppInstall = async (data) => {
       data
     }).catch(handleError);
   }
+  consoleAppEnvMessage("install", "development");
   return await fetchAppBase({
     url: API.APP_INSTALL,
     method: "POST",
     data
   }).catch(handleError);
 };
-const fetchAppUninstall = async () => {
-  var _appList$data$0$insta2, _appList$data2;
-  const appID = getAppManifestJSON().app.id;
-  const appList = await fetchAppList(appID);
-  const installationID = (_appList$data$0$insta2 = (_appList$data2 = appList.data) === null || _appList$data2 === void 0 || (_appList$data2 = _appList$data2[0]) === null || _appList$data2 === void 0 ? void 0 : _appList$data2.installation_id) !== null && _appList$data$0$insta2 !== void 0 ? _appList$data$0$insta2 : "";
+const fetchAppUninstall = async (appID) => {
+  const {
+    installationID,
+    appEnv
+  } = await getAppInstallation(appID);
   if (installationID) {
+    if (appEnv === "production") {
+      consoleProductionNotAllowedMessage("uninstall");
+    }
+    const displayAppEnv = getDisplayAppEnv(appEnv);
+    consoleAppEnvMessage("uninstall", displayAppEnv);
     return await fetchAppBase({
       url: API.APP_UNINSTALL,
       method: "POST",
@@ -691,12 +760,14 @@ const fetchAppUninstall = async () => {
   consoleAppNotInstalledMessage();
   process.exit(1);
 };
-const fetchAppEnable = async () => {
-  var _appList$data$0$insta3, _appList$data3;
-  const appID = getAppManifestJSON().app.id;
-  const appList = await fetchAppList(appID);
-  const installationID = (_appList$data$0$insta3 = (_appList$data3 = appList.data) === null || _appList$data3 === void 0 || (_appList$data3 = _appList$data3[0]) === null || _appList$data3 === void 0 ? void 0 : _appList$data3.installation_id) !== null && _appList$data$0$insta3 !== void 0 ? _appList$data$0$insta3 : "";
+const fetchAppEnable = async (appID) => {
+  const {
+    installationID,
+    appEnv
+  } = await getAppInstallation(appID);
   if (installationID) {
+    const displayAppEnv = getDisplayAppEnv(appEnv);
+    consoleAppEnvMessage("enable", displayAppEnv);
     return await fetchAppBase({
       url: API.APP_ENABLE,
       method: "POST",
@@ -708,12 +779,14 @@ const fetchAppEnable = async () => {
   consoleAppNotInstalledMessage();
   process.exit(1);
 };
-const fetchAppDisable = async () => {
-  var _appList$data$0$insta4, _appList$data4;
-  const appID = getAppManifestJSON().app.id;
-  const appList = await fetchAppList(appID);
-  const installationID = (_appList$data$0$insta4 = (_appList$data4 = appList.data) === null || _appList$data4 === void 0 || (_appList$data4 = _appList$data4[0]) === null || _appList$data4 === void 0 ? void 0 : _appList$data4.installation_id) !== null && _appList$data$0$insta4 !== void 0 ? _appList$data$0$insta4 : "";
+const fetchAppDisable = async (appID) => {
+  const {
+    installationID,
+    appEnv
+  } = await getAppInstallation(appID);
   if (installationID) {
+    const displayAppEnv = getDisplayAppEnv(appEnv);
+    consoleAppEnvMessage("disable", displayAppEnv);
     return await fetchAppBase({
       url: API.APP_DISABLE,
       method: "POST",
@@ -725,6 +798,13 @@ const fetchAppDisable = async () => {
   consoleAppNotInstalledMessage();
   process.exit(1);
 };
+const fetchAppRuntimeLogs = async (data) => {
+  return await fetchAppBase({
+    url: API.APP_RUNTIME_LOGS,
+    method: "POST",
+    data
+  }).catch(handleError);
+};
 const checkTokenInfo = async () => {
   let boolean = true;
   const regionURL = await getRegionURL().catch(() => "");
@@ -741,8 +821,28 @@ const checkTokenInfo = async () => {
   }
   return boolean;
 };
+const resolveAppInfo = (input) => {
+  var _input$appID;
+  const appIDFromArgument = (_input$appID = input.appID) !== null && _input$appID !== void 0 ? _input$appID : "";
+  if (appIDFromArgument) {
+    return {
+      appID: appIDFromArgument,
+      appName: appIDFromArgument
+    };
+  }
+  const appManifestPath = input.opkxPath ? node_path.resolve(process$1.cwd(), input.opkxPath) : getAppManifestJSONPath();
+  const appManifestJSON = tryGetAppManifestJSON(appManifestPath);
+  if (appManifestJSON) {
+    return {
+      appID: appManifestJSON.app.id,
+      appName: appManifestJSON.app.name
+    };
+  }
+  console.log('Cannot read local "opkx.json". Please ensure "opkx.json" exists in the current directory, or provide an app ID.');
+  process.exit(1);
+};
 const isPortNumber = /^[1-9]\d{0,4}$/;
-const normalize$9 = async (options) => {
+const normalize$b = async (options) => {
   var _options$clearStorage;
   const portInput = options.port;
   if (portInput)
@@ -1106,7 +1206,7 @@ const tunnel = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, tunnelCommandArguments);
-  const normalizedOptions = await normalize$9(options);
+  const normalizedOptions = await normalize$b(options);
   const port = Number(normalizedOptions.port);
   const cancelWaiting = startWaiting();
   await invokeTunnel(port, {
@@ -1118,9 +1218,12 @@ const tunnel = async function() {
   const tunnelUrl = await buildTunnelUrl();
   console.log(`Relay endpoint: ${tunnelUrl}`);
 };
-const normalize$8 = async (options) => {
+const normalize$a = async (options) => {
+  var _options$appID;
   lodashEs.noop(options);
-  return {};
+  return {
+    appID: (_options$appID = options.appID) !== null && _options$appID !== void 0 ? _options$appID : ""
+  };
 };
 const displayAppDetail = async (installationID) => {
   var _tokenInfo$org$uuid, _tokenInfo$org, _tokenInfo$teams$0$uu, _tokenInfo$teams, _tokenInfo$org$visibi, _tokenInfo$org2;
@@ -1138,14 +1241,10 @@ const displayAppDetail = async (installationID) => {
     console.log(`See App detail: ${url}`);
   }
 };
-const invokeInstall = async (manifestUrl) => {
-  const {
-    app
-  } = getAppManifestJSON();
-  const appName = app.name;
-  const appID = app.id;
+const invokeInstall = async (manifestUrl, appInfo) => {
+  const appID = appInfo.appID;
   const cancelWaiting = startWaiting();
-  const result = await fetchAppInstall({
+  const result = await fetchAppInstall(appID, {
     manifest_url: manifestUrl,
     options: {
       enable: true
@@ -1154,7 +1253,7 @@ const invokeInstall = async (manifestUrl) => {
   cancelWaiting();
   if (result.code === "OK") {
     var _appList$data$0$insta, _appList$data;
-    console.log(`App "${appName}" installed successfully!`);
+    console.log(`App "${appID}" installed successfully!`);
     const appList = await fetchAppList(appID);
     const installationID = (_appList$data$0$insta = (_appList$data = appList.data) === null || _appList$data === void 0 || (_appList$data = _appList$data[0]) === null || _appList$data === void 0 ? void 0 : _appList$data.installation_id) !== null && _appList$data$0$insta !== void 0 ? _appList$data$0$insta : "";
     if (installationID) {
@@ -1162,7 +1261,7 @@ const invokeInstall = async (manifestUrl) => {
     }
     return true;
   } else {
-    console.log(`App "${appName}" installed failed!`);
+    console.log(`App "${appID}" installed failed!`);
     console.error(JSON.stringify(result, null, 2));
   }
   return false;
@@ -1202,19 +1301,19 @@ const install = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, installCommandArguments);
-  const normalizedOptions = await normalize$8(options);
+  const normalizedOptions = await normalize$a(options);
   lodashEs.noop(normalizedOptions);
-  const {
-    app
-  } = getAppManifestJSON();
-  const appName = app.name;
+  const appInfo = resolveAppInfo({
+    appID: options.appID
+  });
+  const appID = appInfo.appID;
   const manifestUrl = await getManifestUrl();
   if (!manifestUrl) {
-    console.log(`App "${appName}" server not available!`);
+    console.log(`App "${appID}" server not available!`);
     console.log('Use "ones dev" command or "ones tunnel" command to start the server first');
     process.exit(1);
   }
-  await invokeInstall(manifestUrl);
+  await invokeInstall(manifestUrl, appInfo);
 };
 var InstallOptions = /* @__PURE__ */ ((InstallOptions2) => {
   InstallOptions2["AUTO"] = "auto";
@@ -1229,7 +1328,7 @@ var DevCommandScripts = /* @__PURE__ */ ((DevCommandScripts2) => {
   return DevCommandScripts2;
 })(DevCommandScripts || {});
 const defaultInstall = InstallOptions.AUTO;
-const normalize$7 = async (options) => {
+const normalize$9 = async (options) => {
   var _options$install, _options$command, _options$clearStorage;
   let install2 = (_options$install = options.install) !== null && _options$install !== void 0 ? _options$install : defaultInstall;
   const command = (_options$command = options.command) !== null && _options$command !== void 0 ? _options$command : "";
@@ -1251,6 +1350,47 @@ const normalize$7 = async (options) => {
   };
 };
 const IDLE_MS = 2e3;
+const WAIT_PORT_TIMEOUT_MS = 12e4;
+const WAIT_PORT_INTERVAL_MS = 500;
+const WAIT_PORT_CONNECT_TIMEOUT_MS = 1e3;
+const sleep$1 = (ms) => {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+};
+const canConnectPort = (port) => {
+  return new Promise((resolve) => {
+    let settled = false;
+    const socket = node_net.createConnection({
+      host: "127.0.0.1",
+      port
+    });
+    const done = (result) => {
+      if (settled)
+        return;
+      settled = true;
+      socket.removeAllListeners();
+      socket.destroy();
+      resolve(result);
+    };
+    socket.setTimeout(WAIT_PORT_CONNECT_TIMEOUT_MS);
+    socket.on("connect", () => done(true));
+    socket.on("timeout", () => done(false));
+    socket.on("error", () => done(false));
+  });
+};
+const waitForPortReady = async function(port) {
+  let timeoutMs = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : WAIT_PORT_TIMEOUT_MS;
+  const startedAt = Date.now();
+  while (Date.now() - startedAt < timeoutMs) {
+    const connected = await canConnectPort(port);
+    if (connected) {
+      return true;
+    }
+    await sleep$1(WAIT_PORT_INTERVAL_MS);
+  }
+  return false;
+};
 const dev = async function() {
   var _appRcJSON$dev, _defaultAppRcJSON$dev, _appRcJSON$dev$comman, _appRcJSON$dev2, _currentCommand$;
   for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
@@ -1259,7 +1399,7 @@ const dev = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, devCommandArguments);
-  const normalizedOptions = await normalize$7(options);
+  const normalizedOptions = await normalize$9(options);
   const appRcJSON = await getAppRcJSON();
   const correctCommand = normalizedOptions.command || ((_appRcJSON$dev = appRcJSON.dev) === null || _appRcJSON$dev === void 0 || (_appRcJSON$dev = _appRcJSON$dev.command) === null || _appRcJSON$dev === void 0 ? void 0 : _appRcJSON$dev[0]) || ((_defaultAppRcJSON$dev = defaultAppRcJSON.dev) === null || _defaultAppRcJSON$dev === void 0 || (_defaultAppRcJSON$dev = _defaultAppRcJSON$dev.command) === null || _defaultAppRcJSON$dev === void 0 ? void 0 : _defaultAppRcJSON$dev[0]) || "";
   if (!correctCommand) {
@@ -1293,6 +1433,10 @@ const dev = async function() {
     app
   } = appManifestJSON;
   const appID = app.id;
+  const appInfo = {
+    appID: app.id,
+    appName: app.name
+  };
   const config2 = getConfig();
   const ONES_HOSTED_PORT = await getPort({
     port: config2.defaultPort.hosted
@@ -1349,7 +1493,7 @@ const dev = async function() {
     if (enableTunnel) {
       switch (normalizedOptions.install) {
         case InstallOptions.TRUE:
-          await invokeInstall(manifestUrl);
+          await invokeInstall(manifestUrl, appInfo);
           break;
         case InstallOptions.AUTO:
           {
@@ -1359,7 +1503,7 @@ const dev = async function() {
             if (installationID) {
               await displayAppDetail(installationID);
             } else {
-              await invokeInstall(manifestUrl);
+              await invokeInstall(manifestUrl, appInfo);
             }
           }
           break;
@@ -1378,6 +1522,28 @@ const dev = async function() {
   const createReadyStatusPipes = (onReady2) => {
     let readyTimer = null;
     let summaryPrinted = false;
+    let readyInProgress = false;
+    const printReady = async () => {
+      if (summaryPrinted || readyInProgress) {
+        return;
+      }
+      readyInProgress = true;
+      try {
+        if (templateCommand) {
+          const ready = await waitForPortReady(ONES_HOSTED_PORT);
+          if (!ready) {
+            console.error(`Timed out waiting for local app server to listen on port ${ONES_HOSTED_PORT}.`);
+            return;
+          }
+        }
+        if (!summaryPrinted) {
+          summaryPrinted = true;
+          await onReady2();
+        }
+      } finally {
+        readyInProgress = false;
+      }
+    };
     const scheduleReady = () => {
       if (summaryPrinted)
         return;
@@ -1385,10 +1551,9 @@ const dev = async function() {
         clearTimeout(readyTimer);
       readyTimer = setTimeout(() => {
         readyTimer = null;
-        if (!summaryPrinted) {
-          summaryPrinted = true;
-          onReady2();
-        }
+        printReady().catch((error) => {
+          console.error(error);
+        });
       }, IDLE_MS);
     };
     const pipe2 = (stream, isStderr) => {
@@ -1460,7 +1625,7 @@ const sleep = (number) => {
 };
 const isURL = /^https?:\/\//;
 const HostBlackList = ["ones.cn", "www.ones.cn", "ones.com", "www.ones.com"];
-const normalize$6 = async (options) => {
+const normalize$8 = async (options) => {
   const baseURLInput = options.baseURL;
   if (baseURLInput)
     ;
@@ -1498,7 +1663,7 @@ const login = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, loginCommandArguments);
-  const normalizedOptions = await normalize$6(options);
+  const normalizedOptions = await normalize$8(options);
   const {
     code_verifier,
     code_challenge
@@ -1651,7 +1816,7 @@ const login = async function() {
     return createOnesApp.throwError(ErrorCode.INCORRECT_BASE_URL, i18n.t("error.login.incorrectBaseURL"));
   }
 };
-const normalize$5 = async (options) => {
+const normalize$7 = async (options) => {
   lodashEs.noop(options);
   return {};
 };
@@ -1662,12 +1827,12 @@ const logout = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, logoutCommandArguments);
-  const normalizedOptions = await normalize$5(options);
+  const normalizedOptions = await normalize$7(options);
   lodashEs.noop(normalizedOptions);
   await setStore({});
   console.log("Logged out successfully!");
 };
-const normalize$4 = async (options) => {
+const normalize$6 = async (options) => {
   lodashEs.noop(options);
   return {};
 };
@@ -1679,7 +1844,7 @@ const whoami = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, whoamiCommandArguments);
-  const normalizedOptions = await normalize$4(options);
+  const normalizedOptions = await normalize$6(options);
   lodashEs.noop(normalizedOptions);
   const baseURL = await getBaseURL();
   const cancelWaiting = startWaiting();
@@ -1695,9 +1860,12 @@ const whoami = async function() {
     consoleUnauthorizedMessage();
   }
 };
-const normalize$3 = async (options) => {
+const normalize$5 = async (options) => {
+  var _options$appID;
   lodashEs.noop(options);
-  return {};
+  return {
+    appID: (_options$appID = options.appID) !== null && _options$appID !== void 0 ? _options$appID : ""
+  };
 };
 const enable = async function() {
   for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
@@ -1706,22 +1874,28 @@ const enable = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, enableCommandArguments);
-  const normalizedOptions = await normalize$3(options);
+  const normalizedOptions = await normalize$5(options);
   lodashEs.noop(normalizedOptions);
-  const appName = getAppManifestJSON().app.name;
+  const appInfo = resolveAppInfo({
+    appID: options.appID
+  });
+  const appID = appInfo.appID;
   const cancelWaiting = startWaiting();
-  const result = await fetchAppEnable();
+  const result = await fetchAppEnable(appID);
   cancelWaiting();
   if (result.code === "OK") {
-    console.log(`App "${appName}" enabled successfully!`);
+    console.log(`App "${appID}" enabled successfully!`);
   } else {
-    console.log(`App "${appName}" enabled failed!`);
+    console.log(`App "${appID}" enabled failed!`);
     console.error(JSON.stringify(result, null, 2));
   }
 };
-const normalize$2 = async (options) => {
+const normalize$4 = async (options) => {
+  var _options$appID;
   lodashEs.noop(options);
-  return {};
+  return {
+    appID: (_options$appID = options.appID) !== null && _options$appID !== void 0 ? _options$appID : ""
+  };
 };
 const disable = async function() {
   for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
@@ -1730,22 +1904,28 @@ const disable = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, disableCommandArguments);
-  const normalizedOptions = await normalize$2(options);
+  const normalizedOptions = await normalize$4(options);
   lodashEs.noop(normalizedOptions);
-  const appName = getAppManifestJSON().app.name;
+  const appInfo = resolveAppInfo({
+    appID: options.appID
+  });
+  const appID = appInfo.appID;
   const cancelWaiting = startWaiting();
-  const result = await fetchAppDisable();
+  const result = await fetchAppDisable(appID);
   cancelWaiting();
   if (result.code === "OK") {
-    console.log(`App "${appName}" disabled successfully!`);
+    console.log(`App "${appID}" disabled successfully!`);
   } else {
-    console.log(`App "${appName}" disabled failed!`);
+    console.log(`App "${appID}" disabled failed!`);
     console.error(JSON.stringify(result, null, 2));
   }
 };
-const normalize$1 = async (options) => {
+const normalize$3 = async (options) => {
+  var _options$appID;
   lodashEs.noop(options);
-  return {};
+  return {
+    appID: (_options$appID = options.appID) !== null && _options$appID !== void 0 ? _options$appID : ""
+  };
 };
 const uninstall = async function() {
   for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
@@ -1754,18 +1934,97 @@ const uninstall = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, uninstallCommandArguments);
-  const normalizedOptions = await normalize$1(options);
+  const normalizedOptions = await normalize$3(options);
   lodashEs.noop(normalizedOptions);
-  const appName = getAppManifestJSON().app.name;
+  const appInfo = resolveAppInfo({
+    appID: options.appID
+  });
+  const appID = appInfo.appID;
   const cancelWaiting = startWaiting();
-  const result = await fetchAppUninstall();
+  const result = await fetchAppUninstall(appID);
   cancelWaiting();
   if (result.code === "OK") {
-    console.log(`App "${appName}" uninstalled successfully!`);
+    console.log(`App "${appID}" uninstalled successfully!`);
   } else {
-    console.log(`App "${appName}" uninstalled failed!`);
+    console.log(`App "${appID}" uninstalled failed!`);
+    console.error(JSON.stringify(result, null, 2));
+  }
+};
+const defaultTail = 100;
+const normalize$2 = async (options) => {
+  var _options$appID, _options$fromOpkxJson, _options$tail;
+  const appID = (_options$appID = options.appID) !== null && _options$appID !== void 0 ? _options$appID : "";
+  const fromOpkxJSON = (_options$fromOpkxJson = options.fromOpkxJson) !== null && _options$fromOpkxJson !== void 0 ? _options$fromOpkxJson : false;
+  if (!appID && !fromOpkxJSON) {
+    console.log('App id is required, use "ones app logs <app-id>" or "--from-opkx-json"');
+    process.exit(1);
+  }
+  const appInfo = appID ? resolveAppInfo({
+    appID
+  }) : resolveAppInfo({});
+  const tailString = (_options$tail = options.tail) !== null && _options$tail !== void 0 ? _options$tail : `${defaultTail}`;
+  const tail = Number(tailString);
+  if (!Number.isInteger(tail) || tail <= 0) {
+    console.log("Tail should be a positive integer");
+    process.exit(1);
+  }
+  return {
+    appID: appInfo.appID,
+    appName: appInfo.appName,
+    tail
+  };
+};
+const displayLogs = (data) => {
+  if (Array.isArray(data)) {
+    data.forEach((line) => {
+      if (typeof line === "string") {
+        console.log(line);
+      } else {
+        console.log(JSON.stringify(line, null, 2));
+      }
+    });
+    return;
+  }
+  if (typeof data === "string") {
+    console.log(data);
+    return;
+  }
+  console.log(JSON.stringify(data !== null && data !== void 0 ? data : {}, null, 2));
+};
+const logs = async function() {
+  var _appList$data;
+  for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+    args[_key] = arguments[_key];
+  }
+  const {
+    options
+  } = createOnesApp.getCommandOptions(args, logsCommandArguments);
+  const normalizedOptions = await normalize$2(options);
+  const {
+    appID,
+    tail
+  } = normalizedOptions;
+  const cancelWaiting = startWaiting();
+  const appList = await fetchAppList(appID);
+  const productionInstallation = (_appList$data = appList.data) === null || _appList$data === void 0 ? void 0 : _appList$data.find((item) => {
+    return item.installation_id && item.app_env === "production";
+  });
+  if (!productionInstallation) {
+    cancelWaiting();
+    console.log(`App "${appID}" is not installed in production environment`);
+    process.exit(1);
+  }
+  const result = await fetchAppRuntimeLogs({
+    app_id: appID,
+    tail
+  });
+  cancelWaiting();
+  if (result.code && result.code !== "OK") {
+    console.log(`App "${appID}" fetch logs failed!`);
     console.error(JSON.stringify(result, null, 2));
+    return;
   }
+  displayLogs(result.data);
 };
 const getTemplatePath = () => {
   const __dirname = node_path.dirname(node_url.fileURLToPath(typeof document === "undefined" ? require("url").pathToFileURL(__filename).href : _documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === "SCRIPT" && _documentCurrentScript.src || new URL("index.cjs", document.baseURI).href));
@@ -1774,7 +2033,7 @@ const getTemplatePath = () => {
 const getTemplateLegacy = () => {
   return "legacy";
 };
-const normalize = async (options) => {
+const normalize$1 = async (options) => {
   const projectPathInput = options.projectPath;
   if (projectPathInput)
     ;
@@ -1797,7 +2056,7 @@ const legacy = async function() {
   const {
     options
   } = createOnesApp.getCommandOptions(args, legacyCommandArguments);
-  const normalizedOptions = await normalize(options);
+  const normalizedOptions = await normalize$1(options);
   const {
     projectPath
   } = normalizedOptions;
@@ -1812,6 +2071,274 @@ const legacy = async function() {
   });
   console.log("Plugin created successfully!");
 };
+const defaultBaseURL = "https://open.ones.cn/";
+const defaultDir = "~/.ones/ones-app-specs";
+const expandHomeDirectory = (dir) => {
+  if (dir === "~") {
+    return node_os.homedir();
+  }
+  if (dir.startsWith("~/")) {
+    return node_path.resolve(node_os.homedir(), dir.slice(2));
+  }
+  return dir;
+};
+const normalizeBaseURL = (baseURLInput) => {
+  let url;
+  try {
+    url = new URL(baseURLInput);
+  } catch (error) {
+    return createOnesApp.throwError(ErrorCode.INCORRECT_SPECS_BASE_URL, i18n.t("error.specs.fetch.incorrectBaseURL"));
+  }
+  if (url.protocol === "http:" || url.protocol === "https:")
+    ;
+  else {
+    return createOnesApp.throwError(ErrorCode.INCORRECT_SPECS_BASE_URL, i18n.t("error.specs.fetch.incorrectBaseURL"));
+  }
+  url.search = "";
+  url.hash = "";
+  if (!url.pathname.endsWith("/")) {
+    url.pathname = `${url.pathname}/`;
+  }
+  return url.toString();
+};
+const normalize = async (options) => {
+  var _options$baseUrl, _options$extract, _context, _options$json, _options$force;
+  const baseUrl = normalizeBaseURL((_options$baseUrl = options.baseUrl) !== null && _options$baseUrl !== void 0 ? _options$baseUrl : defaultBaseURL);
+  const dir = options.dir ? node_path.resolve(process$1.cwd(), expandHomeDirectory(options.dir), ".ones", "ones-app-specs") : node_path.resolve(process$1.cwd(), expandHomeDirectory(defaultDir));
+  const extractString = `${(_options$extract = options.extract) !== null && _options$extract !== void 0 ? _options$extract : "true"}`.toLowerCase();
+  const extract = _includesInstanceProperty(_context = ["false", "0", "no"]).call(_context, extractString) ? false : true;
+  const json = (_options$json = options.json) !== null && _options$json !== void 0 ? _options$json : false;
+  const force = (_options$force = options.force) !== null && _options$force !== void 0 ? _options$force : false;
+  return {
+    baseUrl,
+    dir,
+    extract,
+    json,
+    force
+  };
+};
+const {
+  ensureDirSync,
+  writeFile,
+  remove,
+  pathExists,
+  readFile
+} = fse;
+const CHECKSUM_FILENAME = "ones-app-specs.sha256";
+const DEFAULT_ARCHIVE_FILENAME = "ones-app-specs.zip";
+const DOWNLOAD_TIMEOUT = 6e4;
+const getShellSafePath = (value) => {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+};
+const getExtractErrorOutput = (result) => {
+  var _result$error;
+  const output = [result.stderr, result.stdout].map((item) => typeof item === "string" ? item.trim() : "").filter(Boolean).join("\n");
+  if ((_result$error = result.error) !== null && _result$error !== void 0 && _result$error.message) {
+    return result.error.message;
+  }
+  return output || "unknown error";
+};
+const extractArchive = (archivePath, dir) => {
+  if (process.platform === "win32") {
+    const powershellEscape = (value) => value.replace(/'/g, "''");
+    const command = `Expand-Archive -LiteralPath '${powershellEscape(archivePath)}' -DestinationPath '${powershellEscape(dir)}' -Force`;
+    const result2 = node_child_process.spawnSync("powershell", ["-NoProfile", "-NonInteractive", "-Command", command], {
+      encoding: "utf8"
+    });
+    if (result2.status === 0 && !result2.error) {
+      return;
+    }
+    return createOnesApp.throwError(ErrorCode.SPECS_FETCH_FAILED, i18n.t("error.specs.fetch.extractFailed", {
+      file: archivePath,
+      reason: getExtractErrorOutput(result2)
+    }));
+  }
+  const result = node_child_process.spawnSync("unzip", ["-oq", archivePath, "-d", dir], {
+    encoding: "utf8"
+  });
+  if (result.status === 0 && !result.error) {
+    return;
+  }
+  return createOnesApp.throwError(ErrorCode.SPECS_FETCH_FAILED, i18n.t("error.specs.fetch.extractFailed", {
+    file: archivePath,
+    reason: getExtractErrorOutput(result)
+  }));
+};
+const parseChecksumValue = (text) => {
+  var _match$;
+  const firstLine = text.split(/\r?\n/).map((line) => line.trim()).find(Boolean);
+  if (!firstLine) {
+    return null;
+  }
+  const match = firstLine.match(/^([a-fA-F0-9]{64})(?:\s+\*?(.+))?$/);
+  if (!match) {
+    return null;
+  }
+  const checksum = match[1].toLowerCase();
+  const archiveFilenameInput = ((_match$ = match[2]) !== null && _match$ !== void 0 ? _match$ : DEFAULT_ARCHIVE_FILENAME).trim();
+  const archiveFilename = node_path.basename(archiveFilenameInput);
+  if (!archiveFilename || archiveFilename !== archiveFilenameInput) {
+    return null;
+  }
+  return {
+    checksum,
+    archiveFilename
+  };
+};
+const parseChecksum = (text) => {
+  var _text$split$find$trim, _text$split$find;
+  const parsed = parseChecksumValue(text);
+  if (parsed) {
+    return parsed;
+  }
+  const firstLine = (_text$split$find$trim = (_text$split$find = text.split(/\r?\n/).find(Boolean)) === null || _text$split$find === void 0 ? void 0 : _text$split$find.trim()) !== null && _text$split$find$trim !== void 0 ? _text$split$find$trim : "";
+  const preview = firstLine.slice(0, 120) || "<empty>";
+  return createOnesApp.throwError(ErrorCode.INCORRECT_SPECS_CHECKSUM, i18n.t("error.specs.fetch.incorrectChecksum", {
+    preview
+  }));
+};
+const getSHA256 = async (filePath) => {
+  const hash = node_crypto.createHash("sha256");
+  const stream = node_fs.createReadStream(filePath);
+  for await (const chunk of stream) {
+    hash.update(chunk);
+  }
+  return hash.digest("hex");
+};
+const specsFetch = async function() {
+  for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+    args[_key] = arguments[_key];
+  }
+  const {
+    options
+  } = createOnesApp.getCommandOptions(args, specsFetchCommandArguments);
+  const normalizedOptions = await normalize(options);
+  const baseURL = normalizedOptions.baseUrl;
+  const dir = normalizedOptions.dir;
+  const onesDir = node_path.dirname(dir);
+  const shouldExtract = normalizedOptions.extract;
+  const useJSONOutput = normalizedOptions.json;
+  const forceFetch = normalizedOptions.force;
+  ensureDirSync(dir);
+  const checksumURL = new URL(CHECKSUM_FILENAME, baseURL).toString();
+  const checksumText = await axios.get(checksumURL, {
+    responseType: "text",
+    timeout: REQUEST_TIMEOUT
+  }).then((response2) => {
+    var _response2$data;
+    return `${(_response2$data = response2.data) !== null && _response2$data !== void 0 ? _response2$data : ""}`;
+  }).catch(() => {
+    return createOnesApp.throwError(ErrorCode.SPECS_FETCH_FAILED, i18n.t("error.specs.fetch.fetchChecksumFailed", {
+      url: checksumURL
+    }));
+  });
+  const parsedChecksum = parseChecksum(checksumText);
+  const archiveURL = new URL(parsedChecksum.archiveFilename, baseURL).toString();
+  const archivePath = node_path.join(dir, parsedChecksum.archiveFilename);
+  const checksumPath = node_path.join(dir, CHECKSUM_FILENAME);
+  const localChecksum = await pathExists(checksumPath).then(async (exists) => {
+    if (!exists) {
+      return null;
+    }
+    const content = await readFile(checksumPath, "utf8");
+    return parseChecksumValue(content);
+  }).catch(() => null);
+  if (!forceFetch && (localChecksum === null || localChecksum === void 0 ? void 0 : localChecksum.checksum) === parsedChecksum.checksum) {
+    if (useJSONOutput) {
+      console.log(JSON.stringify({
+        status: "up_to_date",
+        base_url: baseURL,
+        download_dir: dir,
+        specs_dir: dir,
+        checksum_url: checksumURL,
+        sha256: parsedChecksum.checksum,
+        force: false,
+        message: "Local ones-app-specs is already up to date."
+      }, null, 2));
+      return;
+    }
+    console.log("Local ones-app-specs is already up to date.");
+    console.log(`SHA256: ${parsedChecksum.checksum}`);
+    console.log(`Specs directory: ${dir}`);
+    return;
+  }
+  const response = await axios({
+    url: archiveURL,
+    method: "GET",
+    responseType: "stream",
+    timeout: DOWNLOAD_TIMEOUT
+  }).catch(() => {
+    return createOnesApp.throwError(ErrorCode.SPECS_FETCH_FAILED, i18n.t("error.specs.fetch.downloadFailed", {
+      url: archiveURL
+    }));
+  });
+  await promises.pipeline(response.data, node_fs.createWriteStream(archivePath)).catch(async () => {
+    await remove(archivePath).catch(() => void 0);
+    return createOnesApp.throwError(ErrorCode.SPECS_FETCH_FAILED, i18n.t("error.specs.fetch.downloadFailed", {
+      url: archiveURL
+    }));
+  });
+  const actualChecksum = await getSHA256(archivePath);
+  if (actualChecksum === parsedChecksum.checksum)
+    ;
+  else {
+    await remove(archivePath).catch(() => void 0);
+    return createOnesApp.throwError(ErrorCode.SPECS_CHECKSUM_MISMATCH, i18n.t("error.specs.fetch.verifyChecksumFailed", {
+      expected: parsedChecksum.checksum,
+      actual: actualChecksum
+    }));
+  }
+  const verifyCommand = `sha256sum -c ${getShellSafePath(checksumPath)}`;
+  if (shouldExtract) {
+    try {
+      ensureDirSync(onesDir);
+      extractArchive(archivePath, onesDir);
+      await writeFile(checksumPath, `${parsedChecksum.checksum}  ${parsedChecksum.archiveFilename}
+`, "utf8");
+      await remove(archivePath).catch(() => void 0);
+    } catch (error) {
+      return createOnesApp.throwError(ErrorCode.SPECS_FETCH_FAILED, i18n.t("error.specs.fetch.cleanupFailed", {
+        file: archivePath,
+        reason: `${error}`
+      }));
+    }
+  } else {
+    await writeFile(checksumPath, `${parsedChecksum.checksum}  ${parsedChecksum.archiveFilename}
+`, "utf8");
+  }
+  if (useJSONOutput) {
+    console.log(JSON.stringify({
+      status: "success",
+      base_url: baseURL,
+      download_dir: dir,
+      specs_dir: dir,
+      checksum_url: checksumURL,
+      archive_url: archiveURL,
+      archive_path: archivePath,
+      checksum_path: checksumPath,
+      sha256: actualChecksum,
+      force: forceFetch,
+      extract: shouldExtract,
+      archive_removed: shouldExtract,
+      verify_command: shouldExtract ? null : verifyCommand
+    }, null, 2));
+    return;
+  }
+  console.log("ONES specs fetched successfully!");
+  console.log(`SHA256: ${actualChecksum}`);
+  console.log(`Specs directory: ${dir}`);
+  console.log(`Base URL: ${baseURL}`);
+  console.log(`Checksum URL: ${checksumURL}`);
+  console.log(`Archive URL: ${archiveURL}`);
+  console.log(`Archive path: ${archivePath}`);
+  if (shouldExtract) {
+    console.log("Archive extracted successfully!");
+    console.log("Archive cleanup: enabled (source zip removed)");
+  } else {
+    console.log("Archive extraction: skipped");
+    console.log(`Verify command: ${verifyCommand}`);
+  }
+};
 const buildCommandArguments = [];
 const $build = new commander.Command("build").description(i18n.t("desc.build")).option("-o, --output [file-path]", i18n.t("desc.build.output")).option("-c, --command [string]", i18n.t("desc.build.command")).action(build);
 createOnesApp.addCommandUsage($build);
@@ -1836,26 +2363,40 @@ const whoamiCommandArguments = [];
 const $whoami = new commander.Command("whoami").description(i18n.t("desc.whoami")).action(whoami);
 createOnesApp.addCommandUsage($whoami);
 createOnesApp.addCommandOutput($whoami);
-const installCommandArguments = [];
-const $install = new commander.Command("install").description(i18n.t("desc.install")).action(install);
+const installCommandArguments = ["appID"];
+const $install = new commander.Command("install").description(i18n.t("desc.install")).argument("[app-id]", i18n.t("desc.app.appId")).action(install);
 createOnesApp.addCommandUsage($install);
 createOnesApp.addCommandOutput($install);
-const enableCommandArguments = [];
-const $enable = new commander.Command("enable").description(i18n.t("desc.enable")).action(enable);
+const enableCommandArguments = ["appID"];
+const $enable = new commander.Command("enable").description(i18n.t("desc.enable")).argument("[app-id]", i18n.t("desc.app.appId")).action(enable);
 createOnesApp.addCommandUsage($enable);
 createOnesApp.addCommandOutput($enable);
-const disableCommandArguments = [];
-const $disable = new commander.Command("disable").description(i18n.t("desc.disable")).action(disable);
+const disableCommandArguments = ["appID"];
+const $disable = new commander.Command("disable").description(i18n.t("desc.disable")).argument("[app-id]", i18n.t("desc.app.appId")).action(disable);
 createOnesApp.addCommandUsage($disable);
 createOnesApp.addCommandOutput($disable);
-const uninstallCommandArguments = [];
-const $uninstall = new commander.Command("uninstall").description(i18n.t("desc.uninstall")).action(uninstall);
+const uninstallCommandArguments = ["appID"];
+const $uninstall = new commander.Command("uninstall").description(i18n.t("desc.uninstall")).argument("[app-id]", i18n.t("desc.app.appId")).action(uninstall);
 createOnesApp.addCommandUsage($uninstall);
 createOnesApp.addCommandOutput($uninstall);
+const logsCommandArguments = ["appID"];
+const $logs = new commander.Command("logs").description(i18n.t("desc.logs")).argument("[app-id]", i18n.t("desc.app.appId")).option("--from-opkx-json", i18n.t("desc.logs.fromOpkxJson")).option("-t, --tail [number]", i18n.t("desc.logs.tail")).action(logs);
+createOnesApp.addCommandUsage($logs);
+createOnesApp.addCommandOutput($logs);
 const $app = new commander.Command("app").description(i18n.t("desc.app"));
-$app.addCommand($install).addCommand($enable).addCommand($disable).addCommand($uninstall);
+$app.addCommand($install).addCommand($enable).addCommand($disable).addCommand($uninstall).addCommand($logs);
 createOnesApp.addCommandUsage($app);
 createOnesApp.addCommandOutput($app);
+const specsFetchCommandArguments = [];
+const $fetch = new commander.Command("fetch").description(i18n.t("desc.specs.fetch")).option("-u, --base-url <url>", i18n.t("desc.specs.fetch.baseUrl")).option("-d, --dir <directory>", i18n.t("desc.specs.fetch.dir")).option("--no-extract", i18n.t("desc.specs.fetch.noExtract")).option("--json", i18n.t("desc.specs.fetch.json")).option("--force", i18n.t("desc.specs.fetch.force")).action(specsFetch);
+$fetch.addHelpText("after", ["", "Examples:", "  ones specs fetch", "  ones specs fetch --json", "  ones specs fetch --no-extract", "  ones specs fetch --force", "  ones specs fetch --base-url http://open-preview.myones.net/ --dir /path/to/project"].join("\n"));
+createOnesApp.addCommandUsage($fetch);
+createOnesApp.addCommandOutput($fetch);
+const $specs = new commander.Command("specs").description(i18n.t("desc.specs"));
+$specs.addCommand($fetch);
+$specs.addHelpText("after", ["", "Examples:", "  ones specs fetch", "  ones specs fetch --json", "  ones specs fetch --no-extract", "  ones specs fetch --force", "  ones specs fetch --base-url https://docs.ones.com/developer/ --dir /path/to/project"].join("\n"));
+createOnesApp.addCommandUsage($specs);
+createOnesApp.addCommandOutput($specs);
 const legacyCommandArguments = ["projectPath"];
 const $create = new commander.Command("create").description(i18n.t("desc.legacy.create")).argument("<project-path>", i18n.t("desc.legacy.create.projectPath")).action(legacy);
 createOnesApp.addCommandUsage($create);
@@ -1869,7 +2410,7 @@ const version = `${getPackageJSON().version}`;
 const env = `${version} Node/${process.version}`;
 ones.description(i18n.t("desc.ones", {
   env
-})).addCommand(createOnesApp.$create).addCommand($build).addCommand($dev).addCommand($tunnel).addCommand($app).addCommand($login).addCommand($logout).addCommand($whoami).addCommand($legacy).configureHelp({
+})).addCommand(createOnesApp.$create).addCommand($build).addCommand($dev).addCommand($tunnel).addCommand($app).addCommand($login).addCommand($logout).addCommand($whoami).addCommand($specs).addCommand($legacy).configureHelp({
   visibleCommands: (cmd) => {
     const blackList = ["legacy"];
     return cmd.commands.filter((command) => !_includesInstanceProperty(blackList).call(blackList, command.name()));