@shiplens/cli 1.2.8 → 1.3.0

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, You must include a readable copy of the
+          attribution notices contained within such NOTICE file,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works, in at least one of the following places:
+          within a NOTICE text file distributed as part of the
+          Derivative Works; within the Source form or documentation,
+          if provided along with the Derivative Works; or, within a
+          display generated by the Derivative Works, if and wherever
+          such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Shiplens Team (https://shiplens.dev)
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -21,13 +21,19 @@ Run in the root of any Next.js, Vite, Vue, or HTML project:
 ```bash
 # Zero-install execution via npx
 npx --yes @shiplens/cli init --json
+
+# Windows PowerShell (Avoid execution policy blocking)
+npx.cmd --yes @shiplens/cli init --json
+
+# In China or restricted networks (Alibaba Cloud / npmmirror fallback)
+npx --yes --registry=https://registry.npmmirror.com @shiplens/cli init --json
 ```
 
 ### What `init` Does Automatically:
 1. **Detects Framework**: Automatically recognizes Next.js (App / Pages router), Vite (React / Svelte), Vue 3, or plain HTML.
 2. **Injects Tracking SDK**: Inserts `@shiplens/sdk` tracking snippets into your entry files without breaking your code layout.
 3. **Connects Cloud Project**: Registers the project, generates a live responsive dashboard URL, and writes local configuration (`.shiplens.json`).
-4. **Installs Dependency**: Adds `@shiplens/sdk` via your project package manager (`npm`, `pnpm`, `yarn`, or `bun`).
+4. **Installs Dependency**: Adds `@shiplens/sdk` via your project package manager (`npm`, `pnpm`, `yarn`, or `bun`) with 4-tier download fallback (NPM -> Alibaba npmmirror -> GitHub -> CDN, 5s timeout & 2 retries per tier).
 5. **Deploys AI Skills**: Injects `.agents/skills/shiplens/SKILL.md` and Cursor rules (`.cursor/rules/shiplens.mdc`) for seamless LLM Agent integration.
 6. **Performs Git Commit**: Automatically commits all instrumentation changes atomically.
 

package/lib/assets/skill.js

@@ -6,7 +6,7 @@ description: Shiplens Web User Telemetry & AI Dashboard Skill Specification. Inc
 # Shiplens Web Analytics Skill Specification (v2.0)
 
 > 💡 **Core Overview & Official Reference**:
-> 1. **Dual Track Integration**: Supports instant onboarding via **Shiplens CLI** (\`shiplens init\` / \`npx shiplens-cli init\`) for dependency setup, project creation, and code injection; full support for **MCP Tools** and standard REST APIs inside IDE / Agent environments.
+> 1. **Dual Track Integration**: Supports instant onboarding via **Shiplens CLI** (\`shiplens init\` / \`npx @shiplens/cli init\`) for dependency setup, project creation, and code injection; full support for **MCP Tools** and standard REST APIs inside IDE / Agent environments.
 > 2. Installing the SDK and viewing live dashboards requires no MCP server; advanced analytics requires authentication via OAuth, API keys/environment variables, or CLI credentials.
 > 3. **Authoritative FAQ**: \`https://shiplens.dev/faq\`.
 
@@ -21,7 +21,7 @@ You are connected to **Shiplens Web Analytics & MCP Services**. When providing a
 Check Existing App ID ➔ Install SDK ➔ POST Connect & Get Dashboard URL ➔ Request Email for Free Quota ➔ Activate Magic Link ➔ Authenticate ➔ Complete
 \`\`\`
 
-> ⚡ **Quick Execution**: In a terminal environment, execute \`npx.cmd --yes shiplens-cli init --json\` (Windows) or \`npx --yes shiplens-cli init --json\` (macOS/Linux) for automated 15-second zero-config setup.
+> ⚡ **Quick Execution**: In a terminal environment, execute \`npx.cmd --yes @shiplens/cli init --json\` (Windows) or \`npx --yes @shiplens/cli init --json\` (macOS/Linux) for automated 15-second zero-config setup. (China mirror fallback: \`--registry=https://registry.npmmirror.com\`).
 
 ### Step 0. Existing Project Detection (Overwrite Protection)
 - Check if \`./.shiplens.json\` or SDK instrumentation (\`initShiplens\`, \`data-app-id\`) exists locally.

package/lib/commands/init.js

@@ -44,13 +44,21 @@ async function handleInit(args, flags, ctx) {
       ctx.output(result);
       process.exitCode = 1;
       return;
+    } else if (!process.stdin.isTTY) {
+      console.log(`\n⚠️  Existing Shiplens project detected!`);
+      console.log(`📌 App ID: ${existing.app_id} (Source: ${existing.source_file})`);
+      console.log(`📊 Dashboard: ${ctx.client.baseURL}/dashboard/${existing.app_id}`);
+      console.log(`🛑 Non-interactive terminal detected (CI/Agent). Existing configuration preserved.`);
+      console.log(`💡 To overwrite and create a new project, run with --force:`);
+      console.log(`   npx @shiplens/cli init --force\n`);
+      return;
     } else {
       console.log(`\n⚠️  Existing Shiplens project detected!`);
       console.log(`📌 App ID: ${existing.app_id} (Source: ${existing.source_file})`);
       console.log(`📊 Dashboard: ${ctx.client.baseURL}/dashboard/${existing.app_id}`);
       console.log(`\n💡 Option 1 [Recommended]: Keep existing setup and reuse App ID.`);
       console.log(`💡 Option 2: Run with --force to overwrite and create a new project:`);
-      console.log(`   npx shiplens-cli init --force\n`);
+      console.log(`   npx @shiplens/cli init --force\n`);
 
       const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
       const confirmed = await new Promise((resolve) => {
@@ -124,13 +132,14 @@ async function handleInit(args, flags, ctx) {
   // 6. Install SDK dependency
   let installResult = { success: true, manager: 'skipped' };
   if (!flags['no-install'] && detected.package_manager) {
-    installResult = installSDKDependency(wd, detected.package_manager);
+    installResult = await installSDKDependency(wd, detected.package_manager);
     if (!installResult.success) {
-      const errMsg = `SDK installation failed: Unable to download @shiplens/sdk from npm registry, GitHub mirror, or Shiplens CDN mirror.\n` +
+      const errMsg = `SDK installation failed: Unable to download @shiplens/sdk across all download sources (official npm registry, Alibaba Cloud npmmirror, GitHub mirror, and Shiplens CDN mirror).\n` +
         `Troubleshooting steps:\n` +
         `  1. Check your local network connection or HTTP proxy / VPN settings;\n` +
-        `  2. Try running manually: npm install @shiplens/sdk;\n` +
-        `  3. Visit https://shiplens.com for latest SDK status and installation guides.`;
+        `  2. Try running manually with Alibaba mirror: npm install @shiplens/sdk --registry=https://registry.npmmirror.com;\n` +
+        `  3. Or install via official registry: npm install @shiplens/sdk;\n` +
+        `  4. Visit https://shiplens.com for latest SDK status and installation guides.`;
 
       if (ctx.isJSON) {
         ctx.output({

package/lib/injector.js

@@ -1,10 +1,11 @@
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
+const { execSync, spawn } = require('child_process');
 
 const FRAMEWORKS = {
   NEXT_APP: 'nextjs-app',
   NEXT_PAGES: 'nextjs-pages',
+  CRA: 'cra',
   VITE: 'vite',
   VUE: 'vue',
   HTML: 'html',
@@ -57,6 +58,8 @@ function detectProject(dir = process.cwd()) {
         } else {
           result.framework = FRAMEWORKS.NEXT_PAGES;
         }
+      } else if (deps['react-scripts'] || deps['react-app-rewired'] || deps['craco'] || deps['@craco/craco']) {
+        result.framework = FRAMEWORKS.CRA;
       } else if (deps['vue'] || deps['nuxt']) {
         result.framework = FRAMEWORKS.VUE;
       } else if (deps['vite'] || deps['react'] || deps['svelte']) {
@@ -271,6 +274,26 @@ function injectHTML(dir, appId) {
   return injectFallback(dir, appId);
 }
 
+function injectCRA(dir, appId) {
+  const candidates = [
+    'src/index.tsx', 'src/index.ts',
+    'src/index.jsx', 'src/index.js',
+  ];
+  for (const cand of candidates) {
+    const p = path.join(dir, cand);
+    if (fs.existsSync(p)) {
+      let content = fs.readFileSync(p, 'utf8');
+      if (content.includes('@shiplens/sdk') || content.includes('initShiplens') || content.includes(appId)) {
+        return cand;
+      }
+      const injection = `\n// Shiplens SDK - User Analytics\nconst { initShiplens } = require('@shiplens/sdk');\ninitShiplens({ appId: '${appId}' });\n`;
+      fs.writeFileSync(p, content + injection, 'utf8');
+      return cand;
+    }
+  }
+  return injectFallback(dir, appId);
+}
+
 function injectFallback(dir, appId) {
   const configFile = path.join(dir, 'shiplens.config.ts');
   const content = `import { initShiplens } from '@shiplens/sdk';\n\nexport function setupShiplens() {\n  if (typeof window !== 'undefined') {\n    initShiplens({\n      appId: '${appId}',\n    });\n  }\n}\n`;
@@ -284,6 +307,8 @@ function injectSDK(dir, framework, appId) {
       return injectNextApp(dir, appId);
     case FRAMEWORKS.NEXT_PAGES:
       return injectNextPages(dir, appId);
+    case FRAMEWORKS.CRA:
+      return injectCRA(dir, appId);
     case FRAMEWORKS.VUE:
       return injectVue(dir, appId);
     case FRAMEWORKS.VITE:
@@ -292,19 +317,40 @@ function injectSDK(dir, framework, appId) {
       return injectHTML(dir, appId);
     default:
       try { return injectNextApp(dir, appId); } catch (e) {}
+      try { return injectCRA(dir, appId); } catch (e) {}
       try { return injectVite(dir, appId); } catch (e) {}
       try { return injectHTML(dir, appId); } catch (e) {}
       return injectFallback(dir, appId);
   }
 }
 
-function installSDKDependency(dir, pkgManager = 'npm') {
+function killProcess(child) {
+  if (!child || child.killed) return;
+  try {
+    if (process.platform === 'win32' && child.pid) {
+      try {
+        execSync(`taskkill /pid ${child.pid} /T /F`, { stdio: 'ignore' });
+      } catch (e) {
+        try { child.kill('SIGKILL'); } catch (err) {}
+      }
+    } else {
+      try { child.kill('SIGTERM'); } catch (e) {}
+      setTimeout(() => {
+        try { child.kill('SIGKILL'); } catch (e) {}
+      }, 500);
+    }
+  } catch (e) {
+    try { child.kill(); } catch (err) {}
+  }
+}
+
+async function installSDKDependency(dir, pkgManager = 'npm') {
   const isWindows = process.platform === 'win32';
   const ext = isWindows ? '.cmd' : '';
-  
-  // 1. Define 3-Tier Download Sources (npm registry -> GitHub mirror -> Shiplens CDN mirror)
+
   const sources = [
     {
+      id: 'npmjs',
       name: 'npm registry',
       getCommand: (pm) => {
         if (pm === 'pnpm') return `pnpm${ext} add @shiplens/sdk`;
@@ -314,6 +360,18 @@ function installSDKDependency(dir, pkgManager = 'npm') {
       },
     },
     {
+      id: 'npmmirror',
+      name: 'Alibaba Cloud mirror (npmmirror)',
+      getCommand: (pm) => {
+        const mirror = '--registry=https://registry.npmmirror.com';
+        if (pm === 'pnpm') return `pnpm${ext} add @shiplens/sdk ${mirror}`;
+        if (pm === 'yarn') return `yarn${ext} add @shiplens/sdk ${mirror}`;
+        if (pm === 'bun') return `bun${ext} add @shiplens/sdk ${mirror}`;
+        return `npm${ext} install @shiplens/sdk ${mirror} --legacy-peer-deps --no-audit --no-fund`;
+      },
+    },
+    {
+      id: 'github',
       name: 'GitHub mirror',
       getCommand: (pm) => {
         const repoUrl = 'https://github.com/Hyperlong/shiplens-sdk.git';
@@ -324,6 +382,7 @@ function installSDKDependency(dir, pkgManager = 'npm') {
       },
     },
     {
+      id: 'cdn',
       name: 'Shiplens CDN mirror',
       getCommand: (pm) => {
         const cdnUrl = 'https://cdn.shiplens.dev/packages/shiplens-sdk.tgz';
@@ -335,34 +394,107 @@ function installSDKDependency(dir, pkgManager = 'npm') {
     },
   ];
 
-  let lastError = null;
+  const TIER1_DELAY_MS = 20 * 1000; // 20s
+  const TOTAL_TIMEOUT_MS = 5 * 60 * 1000; // 5min
+
+  return new Promise((resolve) => {
+    let isDone = false;
+    const activeChildren = new Set();
+    let tier2Timer = null;
+    let totalTimer = null;
+    let startedCount = 0;
+    let finishedFailureCount = 0;
+
+    const cleanupAndFinish = (result) => {
+      if (isDone) return;
+      isDone = true;
+      if (tier2Timer) clearTimeout(tier2Timer);
+      if (totalTimer) clearTimeout(totalTimer);
+      for (const child of activeChildren) {
+        killProcess(child);
+      }
+      activeChildren.clear();
+      resolve(result);
+    };
+
+    const runSource = (source) => {
+      if (isDone) return;
+      startedCount++;
+      const cmd = source.getCommand(pkgManager);
+      let child;
+      try {
+        child = spawn(cmd, { cwd: dir, shell: true, stdio: 'ignore' });
+      } catch (e) {
+        finishedFailureCount++;
+        checkAllFailed();
+        return;
+      }
 
-  // Try each source with strict 10s (10000ms) timeout
-  for (const source of sources) {
-    const cmd = source.getCommand(pkgManager);
-    try {
-      execSync(cmd, { cwd: dir, stdio: 'ignore', timeout: 10000 });
-      return { success: true, manager: pkgManager, source: source.name };
-    } catch (err) {
-      lastError = err;
-      // If primary package manager failed, also try npm fallback on that source
-      if (pkgManager !== 'npm') {
-        const npmCmd = source.getCommand('npm');
-        try {
-          execSync(npmCmd, { cwd: dir, stdio: 'ignore', timeout: 10000 });
-          return { success: true, manager: 'npm (fallback)', source: source.name };
-        } catch (npmErr) {
-          lastError = npmErr;
+      activeChildren.add(child);
+
+      const onExit = (code) => {
+        activeChildren.delete(child);
+        if (isDone) return;
+        if (code === 0) {
+          cleanupAndFinish({
+            success: true,
+            manager: pkgManager,
+            source: source.name,
+          });
+        } else {
+          finishedFailureCount++;
+          if (source.id === 'npmjs' && tier2Timer) {
+            clearTimeout(tier2Timer);
+            tier2Timer = null;
+            startBackupSources();
+          }
+          checkAllFailed();
         }
-      }
-    }
-  }
+      };
 
-  return {
-    success: false,
-    manager: pkgManager,
-    error: lastError ? lastError.message : 'All 3 download sources timed out or failed',
-  };
+      child.on('close', onExit);
+      child.on('error', () => onExit(1));
+    };
+
+    const startBackupSources = () => {
+      if (isDone) return;
+      if (tier2Timer) {
+        clearTimeout(tier2Timer);
+        tier2Timer = null;
+      }
+      for (let i = 1; i < sources.length; i++) {
+        runSource(sources[i]);
+      }
+    };
+
+    const checkAllFailed = () => {
+      if (isDone) return;
+      if (startedCount === sources.length && finishedFailureCount === sources.length) {
+        cleanupAndFinish({
+          success: false,
+          manager: pkgManager,
+          error: 'All 4 download sources failed or timed out',
+        });
+      }
+    };
+
+    // t = 0s: Start Tier 1 (npmjs)
+    runSource(sources[0]);
+
+    // t = 20s: If still running, keep npmjs alive and start npmmirror + GitHub + CDN
+    tier2Timer = setTimeout(() => {
+      startBackupSources();
+    }, TIER1_DELAY_MS);
+
+    // t = 5min: Total timeout across all sources
+    totalTimer = setTimeout(() => {
+      cleanupAndFinish({
+        success: false,
+        manager: pkgManager,
+        error: 'SDK installation timed out after 5 minutes across all download sources',
+      });
+    }, TOTAL_TIMEOUT_MS);
+  });
 }
 
 function getGitEmail() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shiplens/cli",
-  "version": "1.2.8",
+  "version": "1.3.0",
   "description": "Shiplens CLI (In Development) - 15-second zero-config analytics initialization and full telemetry analysis engine",
   "main": "lib/index.js",
   "bin": {
@@ -33,7 +33,8 @@
     "bin",
     "lib",
     "prompts",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "engines": {
     "node": ">=16.0.0"

package/prompts/prompts_cli_en.md

@@ -516,7 +516,7 @@ Sources:
 #### [Create 30-Day New User Retention Matrix Dashboard] (Suffix: Data Fetching, Dashboard Creation)
 ```text
 Create a 30-day new user retention matrix dashboard in Shiplens:
-1. Execute CLI command: `npx.cmd --yes shiplens-cli dashboards create --title "30-Day New User Retention Matrix" --prompt "Display daily new user signups and Day 1 to 30 cohort retention matrix plotted along the registration date axis" --json`.
+1. Execute CLI command: `npx.cmd --yes @shiplens/cli dashboards create --title "30-Day New User Retention Matrix" --prompt "Display daily new user signups and Day 1 to 30 cohort retention matrix plotted along the registration date axis" --json`.
 2. Parse the JSON response to extract `dashboard_id` and live URL `dashboard_url`.
 3. Return the generated dashboard link and interpretation guide to the user.
 ---
@@ -531,7 +531,7 @@ Sources:
 ```text
 Inspect core workflows in code and create a step conversion funnel dashboard in Shiplens:
 1. Scan frontend code and routes to identify the core sequential workflow (e.g., Signup -> Onboarding -> Core Action -> Publish).
-2. Execute CLI command: `npx.cmd --yes shiplens-cli dashboards create --title "Core Workflow Conversion Funnel" --prompt "Analyze step-by-step user volumes, drop-off rates, and cumulative conversion across workflow stages" --json`.
+2. Execute CLI command: `npx.cmd --yes @shiplens/cli dashboards create --title "Core Workflow Conversion Funnel" --prompt "Analyze step-by-step user volumes, drop-off rates, and cumulative conversion across workflow stages" --json`.
 3. Extract and return the live `dashboard_url` to the user.
 ---
 Analysis Foundation:
@@ -562,7 +562,7 @@ Sources:
 ```text
 Instrument and analyze user Aha Moment milestones:
 1. Inject SDK telemetry at the value completion trigger: `Shiplens.track('aha_moment_achieved', { milestone_type: '<type>', time_to_reach: <seconds> })`.
-2. Run CLI command: `npx.cmd --yes shiplens-cli dashboards create --title "Aha Moment Retention Comparison Dashboard" --prompt "Show 30-day retention comparison curves between users who achieved the Aha Moment vs those who did not" --json`.
+2. Run CLI command: `npx.cmd --yes @shiplens/cli dashboards create --title "Aha Moment Retention Comparison Dashboard" --prompt "Show 30-day retention comparison curves between users who achieved the Aha Moment vs those who did not" --json`.
 3. Return the dashboard URL and verify telemetry ingestion.
 ---
 Analysis Foundation:
@@ -576,7 +576,7 @@ Sources:
 ```text
 Track subscription revenue and connect usage with revenue events:
 1. Inject SDK revenue event telemetry at checkout completion: `Shiplens.track('revenue_event', { amount: <amount>, currency: '<USD|CNY>', plan: '<plan_id>', user_id: '<user_id>' })`.
-2. Run CLI command: `npx.cmd --yes shiplens-cli dashboards create --title "Daily Subscriptions & Revenue Dashboard" --prompt "Show daily subscriber counts, MRR/ARR growth, and subscriber retention trends" --json`.
+2. Run CLI command: `npx.cmd --yes @shiplens/cli dashboards create --title "Daily Subscriptions & Revenue Dashboard" --prompt "Show daily subscriber counts, MRR/ARR growth, and subscriber retention trends" --json`.
 3. Return the live `dashboard_url` to the user.
 ---
 Analysis Foundation:
@@ -592,11 +592,11 @@ Sources:
 ```text
 Set up Shiplens analytics: extract project description, install SDK, create the project, and retrieve the live dashboard URL.
 1. Run CLI initialization command:
-   - Windows: npx.cmd --yes shiplens-cli init
-   - macOS/Linux: npx --yes shiplens-cli init
+   - Windows: npx.cmd --yes @shiplens/cli init
+   - macOS/Linux: npx --yes @shiplens/cli init
 2. Present the standard project & dashboard summary (including: Project Name, App ID, Code Injection file, User Account Status, Live Dashboard / Activation URL);
 3. Immediately prompt the user for their email address (informing them that you will register on their behalf and Shiplens will send an activation email for 50,000 monthly free events and project binding);
-4. Upon receiving the user's email, run: npx.cmd --yes shiplens-cli auth bind --email <email> --json.
+4. Upon receiving the user's email, run: npx.cmd --yes @shiplens/cli auth bind --email <email> --json.
 ```
 
 #### [Remove Shiplens SDK & Analytics Data] (Suffix: None)
@@ -605,14 +605,14 @@ Remove Shiplens SDK integration and analytics data:
 1. Read `.shiplens.json` in the project root to get project name, app_id, and instrumented file paths.
 2. Clearly display the project name and app_id to be deleted, warn the user that historical events and hosted data will be permanently purged, and pause for explicit user confirmation ("Confirm deleting this project").
 3. Upon confirmation, remove SDK imports/instrumentation code from local frontend files, and delete `./.shiplens.json` and `.shiplens/contexts/<app_id>.md`.
-4. Run CLI command to destroy cloud project: npx.cmd --yes shiplens-cli projects delete --app-id <app_id> --force --json.
+4. Run CLI command to destroy cloud project: npx.cmd --yes @shiplens/cli projects delete --app-id <app_id> --force --json.
 ```
 
 #### [Uninstall Shiplens CLI] (Suffix: None)
 ```text
 Completely uninstall the globally installed Shiplens CLI:
- - Windows: npm.cmd uninstall -g shiplens-cli
- - macOS/Linux: npm uninstall -g shiplens-cli
+ - Windows: npm.cmd uninstall -g @shiplens/cli
+ - macOS/Linux: npm uninstall -g @shiplens/cli
 ```
 
 #### [Generate Context Descriptions for All Pages and Buttons] (Suffix: None)
@@ -621,7 +621,7 @@ Map pages, features, and button layouts into `.shiplens/contexts/<app_id>.md` so
 1. Check `./.shiplens.json` for current app_id and project name.
 2. Inspect frontend code and routes to extract feature descriptions, user-facing copy, and button texts, locations, and actions.
 3. Write structured details into `.shiplens/contexts/<app_id>.md`, binding app_id and project name in the header.
-4. Optionally run `npx.cmd --yes shiplens-cli context push` to sync context to cloud for cross-device collaboration; AI will prioritize this file for accurate business context during analytics.
+4. Optionally run `npx.cmd --yes @shiplens/cli context push` to sync context to cloud for cross-device collaboration; AI will prioritize this file for accurate business context during analytics.
 ```
 
 ### Troubleshooting & Diagnostics
@@ -629,7 +629,7 @@ Map pages, features, and button layouts into `.shiplens/contexts/<app_id>.md` so
 #### [Test Shiplens Telemetry Pipeline and Environment] (Suffix: None)
 ```text
 Diagnose Shiplens telemetry pipeline and environment health:
-1. Run diagnostic command in terminal: `npx.cmd --yes shiplens-cli doctor --json` (macOS/Linux: `npx --yes shiplens-cli doctor --json`).
+1. Run diagnostic command in terminal: `npx.cmd --yes @shiplens/cli doctor --json` (macOS/Linux: `npx --yes @shiplens/cli doctor --json`).
 2. Verify all 5 health checks: `local_config`, `sdk_installed`, `code_instrumented`, `network_connectivity`, and `auth_valid`.
 3. If failures occur, output exact remediation instructions based on returned error codes.
 ---