@shanyucoder/flowgrid 0.1.3 → 0.1.5

package/README.md

@@ -91,16 +91,19 @@ pnpm 10+ cần `--allow-build` khi cài **từ GitHub** (build TypeScript lúc c
 | --- | --- |
 | **Linux / macOS** | Chạy `pnpm setup` nếu shell báo thiếu bin; thường là `~/.local/share/pnpm`. |
 | **WSL** | Giống Linux — dùng Node/pnpm **trong WSL**, không trộn với Node cài trên Windows host trừ khi cố ý. |
-| **Windows (PowerShell, CMD, Windows Terminal)** | Chạy **`pnpm setup`** một lần (ghi PATH user), **đóng và mở lại** terminal; kiểm tra: `where.exe flowgrid` · `flowgrid --version` (hoặc `flowgrid version`). Cần **Node ≥ 24** — nếu im lặng, chạy `node -v` rồi `pnpm add -g @shanyucoder/flowgrid@latest` sau bản **≥ 0.1.3** (fix CLI Windows). |
+| **Windows (PowerShell, CMD, Windows Terminal)** | **`pnpm setup`** → terminal mới → `pnpm add -g @shanyucoder/flowgrid@0.1.4` (hoặc `@latest` sau publish). **Node ≥ 24** bắt buộc (`node -v`). `flowgrid --version` — bản **≤ 0.1.2** có thể im lặng trên Windows. |
 
 **WSL / Git Bash** có thể dùng lệnh pnpm ở trên; **không** bắt buộc `install.sh` nếu đã cài global qua pnpm.
 
 **npx (không cài global):**
 
 ```text
+cd your-project
 npx -p @shanyucoder/flowgrid flowgrid init
 ```
 
+Luôn có từ **`flowgrid`** trước `init` — `npx @shanyucoder/flowgrid` (thiếu bin) không phải quy trình khuyến nghị. Global: `npm install -g @shanyucoder/flowgrid` → `cd your-project` → `flowgrid init`.
+
 Thay `init` bằng `doctor`, `harness sync`, … GitHub: `npx -p github:ShanYuCoder/flowgrid flowgrid init`.
 
 **npm (global):**

package/bin/flowgrid.mjs

@@ -25,23 +25,6 @@ function packageRootFromMeta(metaUrl) {
   return path.resolve(path.dirname(fileURLToPath(metaUrl)), '..');
 }
 
-/** pnpm/npm global shims on Windows may differ in path casing from import.meta.url */
-function isCliEntry(metaUrl) {
-  const invoked = process.argv[1];
-  if (!invoked) return false;
-  const entry = path.resolve(fileURLToPath(metaUrl));
-  const script = path.resolve(invoked);
-  if (script === entry) return true;
-  if (process.platform === 'win32' && script.toLowerCase() === entry.toLowerCase()) return true;
-  if (process.platform === 'win32') {
-    return (
-      path.basename(script).toLowerCase() === 'flowgrid.mjs' &&
-      path.basename(entry).toLowerCase() === 'flowgrid.mjs'
-    );
-  }
-  return false;
-}
-
 function assertNodeVersion() {
   const major = Number(process.versions.node.split('.')[0]);
   if (!Number.isFinite(major) || major < 24) {
@@ -52,6 +35,27 @@ function assertNodeVersion() {
   }
 }
 
+function printDefaultHelp() {
+  const lines = [
+    'FlowGrid CLI — chạy trong thư mục repo đích (cd project trước khi init).',
+    '',
+    'Cài một lần (global):',
+    '  npm install -g @shanyucoder/flowgrid',
+    '  pnpm add -g @shanyucoder/flowgrid',
+    '',
+    'Khởi tạo repo đích:',
+    '  flowgrid init',
+    '',
+    'Khác:',
+    '  flowgrid doctor · flowgrid update · flowgrid harness sync · flowgrid audit',
+    '',
+    'npx (không cài global) — phải gọi bin flowgrid:',
+    '  npx -p @shanyucoder/flowgrid flowgrid init',
+    '  (không dùng: npx @shanyucoder/flowgrid — sẽ không truyền lệnh init)',
+  ];
+  console.log(lines.join('\n'));
+}
+
 export async function main() {
   assertNodeVersion();
   const args = process.argv.slice(2);
@@ -421,7 +425,12 @@ export async function main() {
     process.exit(1);
   }
 
-  if (command && command !== 'init') {
+  if (!command) {
+    printDefaultHelp();
+    return;
+  }
+
+  if (command !== 'init') {
     console.error(pc.red(`Lệnh không hợp lệ: ${command}`));
     console.log(`Chạy 'flowgrid init', 'flowgrid doctor', 'flowgrid update', 'flowgrid harness sync', hoặc 'flowgrid audit'.`);
     process.exit(1);
@@ -938,7 +947,7 @@ export async function main() {
   outro(pc.green("Success! FlowGrid is initialized for your project."));
 }
 
-if (isCliEntry(import.meta.url)) {
+if (import.meta.main) {
   main().catch((err) => {
     console.error(pc.red(err.message));
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shanyucoder/flowgrid",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Unified Local MCP Toolkit (Graph, DNA, Docs, Test, Codegen)",
   "type": "module",
   "main": "./dist/index.js",
@@ -89,10 +89,5 @@
     "vitepress-mermaid-renderer": "^1.1.28",
     "vitepress-plugin-mermaid": "^2.0.17",
     "vue": "^3.4.21"
-  },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "esbuild"
-    ]
   }
 }