@vobs/cli 1.7.7 → 1.8.0

package/dist/index.js

@@ -16,7 +16,7 @@ function timestamp() {
 }
 __name(timestamp, "timestamp");
 function info(msg) {
-  console.log(`${timestamp()} ${pc.cyan("\u2139")} ${msg}`);
+  console.error(`${timestamp()} ${pc.cyan("\u2139")} ${msg}`);
 }
 __name(info, "info");
 function success(msg) {
@@ -24,7 +24,7 @@ function success(msg) {
 }
 __name(success, "success");
 function warn(msg) {
-  console.log(`${timestamp()} ${pc.yellow("\u26A0")} ${msg}`);
+  console.error(`${timestamp()} ${pc.yellow("\u26A0")} ${msg}`);
 }
 __name(warn, "warn");
 function error(msg) {
@@ -128,6 +128,23 @@ function addPackage(targetDir, pm, pkg, dev) {
 }
 __name(addPackage, "addPackage");
 
+// packages/cli/src/version.ts
+import { readFileSync as readFileSync2 } from "fs";
+var cached;
+function cliVersion() {
+  if (cached !== void 0) return cached;
+  try {
+    const manifest = JSON.parse(
+      readFileSync2(new URL("../package.json", import.meta.url), "utf8")
+    );
+    cached = manifest.version ?? "0.0.0";
+  } catch {
+    cached = "0.0.0";
+  }
+  return cached;
+}
+__name(cliVersion, "cliVersion");
+
 // packages/cli/src/commands/init.ts
 async function initCommand(options) {
   const projectName = options.name || await p.text({
@@ -173,7 +190,7 @@ async function initCommand(options) {
     name: projectName,
     packageName: projectName.toLowerCase().replace(/\s+/g, "-"),
     typescript: useTypescript,
-    vobsVersion: "1.0.0"
+    vobsVersion: cliVersion()
   });
   logger.success("Project scaffolded");
   logger.step("Installing dependencies...");
@@ -325,7 +342,7 @@ async function addCommand(options) {
 __name(addCommand, "addCommand");
 
 // packages/cli/src/commands/dsh.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
 import { readFile } from "fs/promises";
 import { execSync as execSync3, spawnSync } from "child_process";
 import { createServer as createServer2 } from "http";
@@ -336,7 +353,7 @@ var PLATFORM_MODULES = ["react", "react-dom"];
 var vobsVersion = /* @__PURE__ */ __name(() => {
   try {
     const manifest = JSON.parse(
-      readFileSync2(new URL("../../package.json", import.meta.url), "utf8")
+      readFileSync3(new URL("../../package.json", import.meta.url), "utf8")
     );
     return manifest.version ?? "1.7.5";
   } catch {
@@ -634,7 +651,7 @@ ${buildError ?? ""}`);
 __name(dshDevCommand, "dshDevCommand");
 function readManifest(dir) {
   try {
-    return JSON.parse(readFileSync2(resolve5(dir, "package.json"), "utf8"));
+    return JSON.parse(readFileSync3(resolve5(dir, "package.json"), "utf8"));
   } catch {
     return void 0;
   }
@@ -660,7 +677,7 @@ function collectIssues(dir) {
     if (!existsSync3(patchPath)) {
       result.errors.push(`dsh.bundle.patch \u6307\u5411\u7684 ${bundle.patch} \u4E0D\u5B58\u5728`);
     } else {
-      const text5 = readFileSync2(patchPath, "utf8");
+      const text5 = readFileSync3(patchPath, "utf8");
       if (!text5.includes("insert:")) result.errors.push("cordis.patch.yml \u91CC\u6CA1\u6709 insert: \u6BB5\u843D\uFF0C\u63D2\u4EF6\u884C\u4E0D\u4F1A\u8FDB\u7EC4\u5408\u6811");
       else if (name !== "" && !text5.includes(name)) {
         result.warnings.push(`cordis.patch.yml \u91CC\u6CA1\u6709\u51FA\u73B0\u5305\u540D ${name}\uFF0C\u786E\u8BA4 insert \u7684 name \u5199\u5BF9\u4E86`);
@@ -695,7 +712,7 @@ function collectIssues(dir) {
     if (!existsSync3(clientPath)) {
       result.errors.push(`\u5BA2\u6237\u7AEF\u4EA7\u7269 ${clientEntry} \u4E0D\u5B58\u5728\uFF0C\u5148\u8FD0\u884C\u6784\u5EFA`);
     } else {
-      const code = readFileSync2(clientPath, "utf8");
+      const code = readFileSync3(clientPath, "utf8");
       const loads = (code.match(/__ModuleLoader__\.load\(/gu) ?? []).length;
       if (loads !== 1) result.errors.push(`\u5BA2\u6237\u7AEF\u4EA7\u7269\u91CC __ModuleLoader__.load \u51FA\u73B0 ${loads} \u6B21\uFF0C\u5E94\u4E3A 1 \u6B21\uFF08\u5148\u6784\u5EFA\uFF09`);
       else result.passed.push("\u4EA7\u7269\u5F62\u6001\u662F DSH \u5BA2\u6237\u7AEF\u6A21\u5757\u534F\u8BAE");
@@ -843,18 +860,319 @@ async function dshCommand(action, target, options) {
       dshInstallCommand(options);
       return;
     default:
-      logger.error(`\u672A\u77E5\u5B50\u547D\u4EE4: ${action ?? "(\u7A7A)"}`);
+      if (action !== void 0 && action !== "") logger.error(`\u672A\u77E5\u5B50\u547D\u4EE4: ${action}`);
       console.log("\n  \u53EF\u7528\u5B50\u547D\u4EE4\uFF1A");
       for (const [name, description] of Object.entries(ACTIONS)) {
         console.log(`    vobs dsh ${name.padEnd(8)} ${description}`);
       }
-      process.exitCode = 1;
+      if (action !== void 0 && action !== "") process.exitCode = 1;
   }
 }
 __name(dshCommand, "dshCommand");
 
+// packages/cli/src/commands/check.ts
+import { mkdir, readdir, readFile as readFile2, stat, writeFile as writeFile2 } from "fs/promises";
+import path from "path";
+import ts from "typescript";
+var REPORT_PATH = ".vobs/check.json";
+var TEST_FILE = /(?:^|\/)(?:[^/]*\.(?:test|spec)\.tsx?|__tests__\/)/u;
+var VOBS_C210 = "VOBS_C210";
+var VOBS_C232 = "VOBS_C232";
+var VOBS_C118 = "VOBS_C118";
+var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "dist", "lib", "build", ".git", ".vobs", "coverage"]);
+async function collectSources(root) {
+  let rootStat;
+  try {
+    rootStat = await stat(root);
+  } catch {
+    throw new Error(`\u8DEF\u5F84\u4E0D\u5B58\u5728\uFF1A${root}`);
+  }
+  if (!rootStat.isDirectory()) {
+    throw new Error(`\u4E0D\u662F\u76EE\u5F55\uFF1A${root}\uFF08vobs check \u63A5\u53D7\u4E00\u4E2A\u76EE\u5F55\uFF09`);
+  }
+  const found = [];
+  const walk = /* @__PURE__ */ __name(async (dir) => {
+    let entries;
+    try {
+      entries = await readdir(dir, { withFileTypes: true });
+    } catch (error2) {
+      if (dir === root) {
+        throw new Error(`\u65E0\u6CD5\u8BFB\u53D6\u76EE\u5F55\uFF1A${root}\uFF08${error2 instanceof Error ? error2.message : String(error2)}\uFF09`);
+      }
+      return;
+    }
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        if (SKIP_DIRS.has(entry.name) || entry.name.startsWith(".")) continue;
+        await walk(path.join(dir, entry.name));
+        continue;
+      }
+      if (!entry.isFile()) continue;
+      if (!/\.tsx?$/u.test(entry.name) || entry.name.endsWith(".d.ts")) continue;
+      found.push(path.join(dir, entry.name));
+    }
+  }, "walk");
+  await walk(root);
+  return found.sort();
+}
+__name(collectSources, "collectSources");
+function returnsJsx(node) {
+  let seen = false;
+  const visit = /* @__PURE__ */ __name((child) => {
+    if (seen) return;
+    if (ts.isJsxElement(child) || ts.isJsxSelfClosingElement(child) || ts.isJsxFragment(child)) {
+      seen = true;
+      return;
+    }
+    if (child !== node && ts.isFunctionLike(child)) return;
+    ts.forEachChild(child, visit);
+  }, "visit");
+  ts.forEachChild(node, visit);
+  return seen;
+}
+__name(returnsJsx, "returnsJsx");
+function signalNameOf(node) {
+  if (!ts.isPropertyAccessExpression(node)) return void 0;
+  if (node.name.text !== "value") return void 0;
+  return node.expression.getText();
+}
+__name(signalNameOf, "signalNameOf");
+function lineSnippet(source, node) {
+  const { line } = source.getLineAndCharacterOfPosition(node.getStart(source));
+  return (source.text.split(/\r?\n/u)[line] ?? "").trim();
+}
+__name(lineSnippet, "lineSnippet");
+function diagnosticAt(source, file, node, rest) {
+  const { line, character } = source.getLineAndCharacterOfPosition(node.getStart(source));
+  return {
+    ...rest,
+    file,
+    line: line + 1,
+    column: character + 1,
+    snippet: lineSnippet(source, node)
+  };
+}
+__name(diagnosticAt, "diagnosticAt");
+var isWriteOperator = /* @__PURE__ */ __name((kind) => kind === ts.SyntaxKind.EqualsToken || kind === ts.SyntaxKind.PlusEqualsToken || kind === ts.SyntaxKind.MinusEqualsToken || kind === ts.SyntaxKind.AsteriskEqualsToken || kind === ts.SyntaxKind.SlashEqualsToken, "isWriteOperator");
+function ruleEffectSelfSubscription(source, file) {
+  const found = [];
+  const inspectEffectBody = /* @__PURE__ */ __name((body) => {
+    const reads = /* @__PURE__ */ new Map();
+    const writes = /* @__PURE__ */ new Map();
+    const visit2 = /* @__PURE__ */ __name((node, insideUntrack) => {
+      if (node !== body && ts.isFunctionLike(node)) return;
+      const nextUntracked = insideUntrack || ts.isCallExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === "untrack";
+      if (ts.isBinaryExpression(node) && isWriteOperator(node.operatorToken.kind)) {
+        const name = signalNameOf(node.left);
+        if (name !== void 0 && !nextUntracked) writes.set(name, node);
+      } else if ((ts.isPrefixUnaryExpression(node) || ts.isPostfixUnaryExpression(node)) && (node.operator === ts.SyntaxKind.PlusPlusToken || node.operator === ts.SyntaxKind.MinusMinusToken)) {
+        const name = signalNameOf(node.operand);
+        if (name !== void 0) {
+          if (!nextUntracked) writes.set(name, node);
+          reads.set(name, node);
+        }
+      } else if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && node.expression.name.text === "set") {
+        if (!nextUntracked) writes.set(node.expression.expression.getText(), node);
+      } else {
+        const name = signalNameOf(node);
+        if (name !== void 0) {
+          const parent = node.parent;
+          const isAssignmentTarget = ts.isBinaryExpression(parent) && isWriteOperator(parent.operatorToken.kind) && parent.left === node;
+          if (!isAssignmentTarget) reads.set(name, node);
+        }
+      }
+      ts.forEachChild(node, (child) => visit2(child, nextUntracked));
+    }, "visit");
+    visit2(body, false);
+    for (const [name, writeNode] of writes) {
+      if (!reads.has(name)) continue;
+      found.push(diagnosticAt(source, file, writeNode, {
+        code: VOBS_C210,
+        severity: "error",
+        message: `effect \u5199\u5165\u4E86\u5B83\u81EA\u5DF1\u4F9D\u8D56\u7684\u4FE1\u53F7 "${name}" \u2014\u2014 \u8FD9\u6B21\u5199\u5165\u4F1A\u628A\u5B83\u91CD\u65B0\u8C03\u5EA6\uFF0C\u5F62\u6210\u81EA\u8BA2\u9605\u5FAA\u73AF`,
+        fix: `\u628A\u8FD9\u6B21\u5199\u5165\u5305\u8FDB untrack\uFF1Auntrack(() => { ${name}.value = next })\uFF1B\u5982\u679C\u8FD9\u4E2A effect \u672C\u6765\u5C31\u53EA\u8BE5\u505A\u526F\u4F5C\u7528\uFF0C\u68C0\u67E5\u662F\u4E0D\u662F\u8BEF\u8BFB\u4E86\u4E0D\u8BE5\u8BFB\u7684\u4FE1\u53F7\u3002`
+      }));
+    }
+  }, "inspectEffectBody");
+  const visit = /* @__PURE__ */ __name((node) => {
+    if (ts.isCallExpression(node) && ts.isIdentifier(node.expression) && (node.expression.text === "effect" || node.expression.text === "renderEffect")) {
+      const callback = node.arguments[0];
+      if (callback !== void 0 && (ts.isArrowFunction(callback) || ts.isFunctionExpression(callback))) {
+        inspectEffectBody(callback.body);
+      }
+    }
+    ts.forEachChild(node, visit);
+  }, "visit");
+  visit(source);
+  return found;
+}
+__name(ruleEffectSelfSubscription, "ruleEffectSelfSubscription");
+function isKeyedListCall(node) {
+  if (!ts.isCallExpression(node)) return false;
+  if (!ts.isPropertyAccessExpression(node.expression) || node.expression.name.text !== "map") return false;
+  const callback = node.arguments[0];
+  return callback !== void 0 && ts.isFunctionLike(callback) && returnsJsx(callback);
+}
+__name(isKeyedListCall, "isKeyedListCall");
+function ruleListInBranch(source, file) {
+  const found = [];
+  const message = "list \u5199\u5728\u4E09\u5143/&& \u7684\u5206\u652F\u91CC \u2014\u2014 \u4F1A\u8D70\u591A\u6001\u63D2\u5165\uFF0C\u5931\u53BB keyed \u590D\u7528";
+  const fix = "\u628A list \u63D0\u6210**\u76F4\u63A5\u7684**\u5B50\u8868\u8FBE\u5F0F\uFF1A\u5148\u5199\u6761\u4EF6\u5206\u652F\uFF0C\u518D\u5355\u72EC\u5199 {items.map(...)}\u3002\u4E09\u5143\u91CC\u540C\u65F6\u6709\u8282\u70B9\u4E0E list \u65F6\uFF0Clist \u90A3\u4E00\u652F\u4E0D\u4F1A\u7F16\u8BD1\u6210 insertList\u3002";
+  const visit = /* @__PURE__ */ __name((node) => {
+    if (ts.isConditionalExpression(node)) {
+      for (const branch of [node.whenTrue, node.whenFalse]) {
+        if (isKeyedListCall(branch)) {
+          found.push(diagnosticAt(source, file, branch, { code: VOBS_C232, severity: "warning", message, fix }));
+        }
+      }
+    } else if (ts.isBinaryExpression(node) && node.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken && isKeyedListCall(node.right)) {
+      found.push(diagnosticAt(source, file, node.right, { code: VOBS_C232, severity: "warning", message, fix }));
+    }
+    ts.forEachChild(node, visit);
+  }, "visit");
+  visit(source);
+  return found;
+}
+__name(ruleListInBranch, "ruleListInBranch");
+function containsSignalRead(node) {
+  let seen = false;
+  const visit = /* @__PURE__ */ __name((child) => {
+    if (seen) return;
+    if (ts.isFunctionLike(child)) return;
+    if (signalNameOf(child) !== void 0) {
+      seen = true;
+      return;
+    }
+    ts.forEachChild(child, visit);
+  }, "visit");
+  visit(node);
+  return seen;
+}
+__name(containsSignalRead, "containsSignalRead");
+function ruleSignalCapturedInBody(source, file) {
+  const found = [];
+  const inspectComponent = /* @__PURE__ */ __name((fn) => {
+    const body = fn.body;
+    if (body === void 0 || !ts.isBlock(body) || !returnsJsx(fn)) return;
+    const captured = [];
+    for (const statement of body.statements) {
+      if (!ts.isVariableStatement(statement)) continue;
+      for (const declaration of statement.declarationList.declarations) {
+        if (!ts.isIdentifier(declaration.name) || declaration.initializer === void 0) continue;
+        if (containsSignalRead(declaration.initializer)) {
+          captured.push({ name: declaration.name.text, node: declaration });
+        }
+      }
+    }
+    if (captured.length === 0) return;
+    const usedInJsx = /* @__PURE__ */ new Set();
+    const visit2 = /* @__PURE__ */ __name((node) => {
+      if (ts.isJsxExpression(node) && node.expression !== void 0) {
+        const scan = /* @__PURE__ */ __name((child) => {
+          if (ts.isIdentifier(child)) usedInJsx.add(child.text);
+          ts.forEachChild(child, scan);
+        }, "scan");
+        scan(node.expression);
+      }
+      ts.forEachChild(node, visit2);
+    }, "visit");
+    visit2(body);
+    for (const item of captured) {
+      if (!usedInJsx.has(item.name)) continue;
+      found.push(diagnosticAt(source, file, item.node, {
+        code: VOBS_C118,
+        severity: "warning",
+        message: `\u7EC4\u4EF6\u4F53\u91CC\u8BFB\u4E86\u4FE1\u53F7\u5E76\u5B58\u8FDB "${item.name}" \u2014\u2014 \u7EC4\u4EF6\u4F53\u53EA\u6267\u884C\u4E00\u6B21\uFF0C\u8FD9\u4E2A\u503C\u4E4B\u540E\u6C38\u8FDC\u4E0D\u4F1A\u66F4\u65B0`,
+        fix: `\u628A\u8BFB\u53D6\u653E\u8FDB\u52A8\u6001\u8868\u8FBE\u5F0F\uFF08\u76F4\u63A5\u5728 JSX \u91CC\u7528 .value\uFF09\uFF0C\u6216\u6539\u6210 memo \u6D3E\u751F\u503C\uFF1Aconst ${item.name} = memo(() => ...)\u3002`
+      }));
+    }
+  }, "inspectComponent");
+  const visit = /* @__PURE__ */ __name((node) => {
+    if (ts.isFunctionDeclaration(node) || ts.isFunctionExpression(node) || ts.isArrowFunction(node)) {
+      inspectComponent(node);
+    }
+    ts.forEachChild(node, visit);
+  }, "visit");
+  visit(source);
+  return found;
+}
+__name(ruleSignalCapturedInBody, "ruleSignalCapturedInBody");
+var IGNORE_NEXT_LINE = /vobs-check-ignore-next-line/u;
+function suppressedLines(text5) {
+  const suppressed = /* @__PURE__ */ new Set();
+  const lines = text5.split(/\r?\n/u);
+  for (let index = 0; index < lines.length; index++) {
+    if (IGNORE_NEXT_LINE.test(lines[index])) suppressed.add(index + 2);
+  }
+  return suppressed;
+}
+__name(suppressedLines, "suppressedLines");
+function analyzeSource(text5, file) {
+  const source = ts.createSourceFile(file, text5, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+  const suppressed = suppressedLines(text5);
+  return [
+    ...ruleEffectSelfSubscription(source, file),
+    ...ruleListInBranch(source, file),
+    ...ruleSignalCapturedInBody(source, file)
+  ].filter((item) => !suppressed.has(item.line)).sort((a, b) => a.line - b.line || a.column - b.column);
+}
+__name(analyzeSource, "analyzeSource");
+async function checkCommand(options = {}) {
+  const root = path.resolve(options.dir ?? process.cwd());
+  let all;
+  try {
+    all = await collectSources(root);
+  } catch (error2) {
+    logger.error(error2 instanceof Error ? error2.message : String(error2));
+    process.exitCode = 1;
+    return;
+  }
+  const files = options.includeTests === true ? all : all.filter((file) => !TEST_FILE.test(path.relative(root, file).split(path.sep).join("/")));
+  const skipped = all.length - files.length;
+  const diagnostics = [];
+  for (const absolute of files) {
+    const text5 = await readFile2(absolute, "utf8");
+    const relative2 = path.relative(root, absolute).split(path.sep).join("/");
+    diagnostics.push(...analyzeSource(text5, relative2));
+  }
+  const errors = diagnostics.filter((item) => item.severity === "error");
+  const report = { root, files: files.length, skippedTests: skipped, diagnostics };
+  if (options.write === true) {
+    const target = path.join(root, REPORT_PATH);
+    await mkdir(path.dirname(target), { recursive: true });
+    await writeFile2(target, `${JSON.stringify(report, null, 2)}
+`, "utf8");
+    logger.info(`\u62A5\u544A\u5199\u5165 ${REPORT_PATH}\uFF08\u5F00\u53D1\u53F0\u9762\u677F\u8BFB\u5B83\u663E\u793A\u300C\u9879\u76EE\u300D\u9875\uFF09`);
+  }
+  if (options.json === true) {
+    console.log(JSON.stringify(report, null, 2));
+    if (errors.length > 0) process.exitCode = 1;
+    return;
+  }
+  if (diagnostics.length === 0) {
+    logger.success(`\u68C0\u67E5\u901A\u8FC7 \u2014\u2014 ${files.length} \u4E2A\u6587\u4EF6${skipped > 0 ? `\uFF08\u8DF3\u8FC7 ${skipped} \u4E2A\u6D4B\u8BD5\u6587\u4EF6\uFF09` : ""}\uFF0C\u6CA1\u6709\u53D1\u73B0\u95EE\u9898`);
+    return;
+  }
+  console.log("");
+  for (const item of diagnostics) {
+    const mark = item.severity === "error" ? "\u2716" : "!";
+    console.log(`  ${mark} ${item.file}:${item.line}:${item.column}  ${item.code}`);
+    console.log(`    ${item.message}`);
+    if (item.snippet !== "") console.log(`    ${item.snippet}`);
+    console.log(`    \u2192 ${item.fix}`);
+    console.log("");
+  }
+  const warnings = diagnostics.length - errors.length;
+  console.log(
+    `  ${errors.length} \u4E2A\u9519\u8BEF \xB7 ${warnings} \u4E2A\u8B66\u544A \xB7 \u5171\u68C0\u67E5 ${files.length} \u4E2A\u6587\u4EF6${skipped > 0 ? `\uFF08\u8DF3\u8FC7 ${skipped} \u4E2A\u6D4B\u8BD5\u6587\u4EF6\uFF0C\u7528 --include-tests \u7EB3\u5165\uFF09` : ""}
+`
+  );
+  if (errors.length > 0) process.exitCode = 1;
+}
+__name(checkCommand, "checkCommand");
+
 // packages/cli/src/banner.ts
-var BANNER_LINE1 = "\u{1D5E9}\u{1D5E2}\u{1D5D5}\u{1D5E6} \u{1D5D6}\u{1D5DF}\u{1D5DC} \u{1D603}\u{1D7ED}.\u{1D7EC}";
+var BANNER_LINE1 = "\u{1D5E9}\u{1D5E2}\u{1D5D5}\u{1D5E6} \u{1D5D6}\u{1D5DF}\u{1D5DC}";
 var BANNER_TAGLINE = "Signals First \xB7 Zero Re-renders \xB7 Ultra Lightweight";
 var INDENT = "  ";
 var DIM = "\x1B[2m";
@@ -870,12 +1188,12 @@ function showLogo() {
 }
 __name(showLogo, "showLogo");
 function showBanner() {
-  console.log(`${INDENT}${BANNER_LINE1}`);
+  console.log(`${INDENT}${BANNER_LINE1} v${cliVersion()}`);
 }
 __name(showBanner, "showBanner");
 function showDevBanner() {
   console.log();
-  console.log(`${INDENT}${BANNER_LINE1}`);
+  console.log(`${INDENT}${BANNER_LINE1} v${cliVersion()}`);
   console.log();
 }
 __name(showDevBanner, "showDevBanner");
@@ -929,7 +1247,15 @@ function createCLI() {
       dev: options.dev
     });
   });
-  cli.command("dsh <action> [target]", "DSH \u63D2\u4EF6\u5DE5\u5177\u94FE\uFF08init / dev / build / check / install\uFF09").option("--dir <dir>", "init\uFF1A\u76EE\u6807\u76EE\u5F55").option("--pm <pm>", "init\uFF1A\u5305\u7BA1\u7406\u5668\uFF08pnpm/npm\uFF09").option("--port <port>", "dev\uFF1A\u9884\u89C8\u7AEF\u53E3", { default: 5199 }).option("--profile <name>", "install\uFF1ADSH profile \u540D", { default: "desktop" }).option("--spec <spec>", "install\uFF1A\u5B8C\u6574\u5B89\u88C5 spec").option("--repo <owner/name>", "install\uFF1AGitHub owner/name").option("--tag <ref>", "install\uFF1AGit tag / \u5206\u652F / commit").option("--subpath <path>", "install\uFF1A\u4ED3\u5E93\u5185\u5B50\u76EE\u5F55").option("--from <path>", "install\uFF1A\u4ECE\u672C\u5730\u76EE\u5F55\u5B89\u88C5").option("--dry", "install\uFF1A\u53EA\u6253\u5370\u547D\u4EE4\uFF0C\u4E0D\u6267\u884C").action(async (action, target, options) => {
+  cli.command("check [dir]", "\u9759\u6001\u68C0\u67E5\u6E90\u7801\uFF1Aeffect \u81EA\u8BA2\u9605 / \u5217\u8868\u5199\u8FDB\u5206\u652F / \u7EC4\u4EF6\u4F53\u91CC\u8BFB\u4FE1\u53F7\uFF08\u884C\u5185\u6291\u5236\uFF1A\u4E0A\u4E00\u884C\u5199 // vobs-check-ignore-next-line\uFF09").option("--json", "\u4EE5 JSON \u8F93\u51FA\uFF08\u7ED9 AI \u4E0E\u5DE5\u5177\u6D88\u8D39\uFF09").option("--write", `\u628A\u7ED3\u679C\u5199\u5230 ${".vobs/check.json"}\uFF08\u5F00\u53D1\u53F0\u9762\u677F\u8BFB\u5B83\uFF09`).option("--include-tests", "\u628A\u6D4B\u8BD5\u6587\u4EF6\u4E5F\u7EB3\u5165\u68C0\u67E5\uFF08\u9ED8\u8BA4\u8DF3\u8FC7\uFF09").action(async (dir, options) => {
+    await checkCommand({
+      dir,
+      json: options.json === true,
+      write: options.write === true,
+      includeTests: options.includeTests === true
+    });
+  });
+  cli.command("dsh [action] [target]", "DSH \u63D2\u4EF6\u5DE5\u5177\u94FE\uFF08init / dev / build / check / install\uFF09").option("--dir <dir>", "init\uFF1A\u76EE\u6807\u76EE\u5F55").option("--pm <pm>", "init\uFF1A\u5305\u7BA1\u7406\u5668\uFF08pnpm/npm\uFF09").option("--port <port>", "dev\uFF1A\u9884\u89C8\u7AEF\u53E3", { default: 5199 }).option("--profile <name>", "install\uFF1ADSH profile \u540D", { default: "desktop" }).option("--spec <spec>", "install\uFF1A\u5B8C\u6574\u5B89\u88C5 spec").option("--repo <owner/name>", "install\uFF1AGitHub owner/name").option("--tag <ref>", "install\uFF1AGit tag / \u5206\u652F / commit").option("--subpath <path>", "install\uFF1A\u4ED3\u5E93\u5185\u5B50\u76EE\u5F55").option("--from <path>", "install\uFF1A\u4ECE\u672C\u5730\u76EE\u5F55\u5B89\u88C5").option("--dry", "install\uFF1A\u53EA\u6253\u5370\u547D\u4EE4\uFF0C\u4E0D\u6267\u884C").action(async (action, target, options) => {
     await dshCommand(action, target, {
       dir: options.dir,
       pm: options.pm,
@@ -950,10 +1276,22 @@ function createCLI() {
     showBanner();
   });
   cli.help();
-  cli.version("1.0.0");
+  cli.version(cliVersion());
   return cli;
 }
 __name(createCLI, "createCLI");
+var KNOWN_SUBCOMMANDS = [
+  "init",
+  "create",
+  "dev",
+  "build",
+  "generate",
+  "g",
+  "add",
+  "check",
+  "dsh",
+  "logo"
+];
 
 // packages/cli/src/repl.ts
 import { createInterface } from "readline/promises";
@@ -1072,16 +1410,52 @@ function splitArgs(line) {
 __name(splitArgs, "splitArgs");
 
 // packages/cli/src/start.ts
+var META_FLAGS = /* @__PURE__ */ new Set(["--help", "-h", "--version", "-V"]);
+function isFlag(token) {
+  return token.startsWith("-") && token !== "-";
+}
+__name(isFlag, "isFlag");
 async function start(args) {
   if (args.length === 0 || args[0] === "cli") {
     await startRepl();
     return;
   }
-  if (args.includes("--version") || args.includes("-V")) {
+  const first = args[0];
+  const hasSubcommand = KNOWN_SUBCOMMANDS.includes(first);
+  if (!hasSubcommand && (args.includes("--version") || args.includes("-V"))) {
     showBanner();
     return;
   }
-  createCLI().parse();
+  if (!hasSubcommand && !isFlag(first)) {
+    process.stderr.write(`\u2716 \u672A\u77E5\u547D\u4EE4\uFF1A${first}
+
+`);
+    try {
+      createCLI().parse(["node", "vobs", "--help"]);
+    } catch {
+    }
+    process.exitCode = 1;
+    return;
+  }
+  if (!hasSubcommand && isFlag(first) && !META_FLAGS.has(first)) {
+    process.stderr.write(`\u2716 \u672A\u77E5\u9009\u9879\uFF1A${first}
+
+`);
+    try {
+      createCLI().parse(["node", "vobs", "--help"]);
+    } catch {
+    }
+    process.exitCode = 1;
+    return;
+  }
+  try {
+    createCLI().parse();
+  } catch (error2) {
+    const message = error2 instanceof Error ? error2.message : String(error2);
+    process.stderr.write(`\u2716 ${message}
+`);
+    process.exitCode = 1;
+  }
 }
 __name(start, "start");
 export {