@vobs/cli 1.7.8 → 1.8.1

package/dist/index.cjs

@@ -69,7 +69,7 @@ function timestamp() {
 }
 __name(timestamp, "timestamp");
 function info(msg) {
-  console.log(`${timestamp()} ${import_picocolors.default.cyan("\u2139")} ${msg}`);
+  console.error(`${timestamp()} ${import_picocolors.default.cyan("\u2139")} ${msg}`);
 }
 __name(info, "info");
 function success(msg) {
@@ -77,7 +77,7 @@ function success(msg) {
 }
 __name(success, "success");
 function warn(msg) {
-  console.log(`${timestamp()} ${import_picocolors.default.yellow("\u26A0")} ${msg}`);
+  console.error(`${timestamp()} ${import_picocolors.default.yellow("\u26A0")} ${msg}`);
 }
 __name(warn, "warn");
 function error(msg) {
@@ -181,6 +181,23 @@ function addPackage(targetDir, pm, pkg, dev) {
 }
 __name(addPackage, "addPackage");
 
+// packages/cli/src/version.ts
+var import_node_fs3 = require("fs");
+var cached;
+function cliVersion() {
+  if (cached !== void 0) return cached;
+  try {
+    const manifest = JSON.parse(
+      (0, import_node_fs3.readFileSync)(new URL("../package.json", __VOBS_CJS_FILE_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({
@@ -226,7 +243,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...");
@@ -378,7 +395,7 @@ async function addCommand(options) {
 __name(addCommand, "addCommand");
 
 // packages/cli/src/commands/dsh.ts
-var import_node_fs3 = require("fs");
+var import_node_fs4 = require("fs");
 var import_promises = require("fs/promises");
 var import_node_child_process3 = require("child_process");
 var import_node_http = require("http");
@@ -389,7 +406,7 @@ var PLATFORM_MODULES = ["react", "react-dom"];
 var vobsVersion = /* @__PURE__ */ __name(() => {
   try {
     const manifest = JSON.parse(
-      (0, import_node_fs3.readFileSync)(new URL("../../package.json", __VOBS_CJS_FILE_URL), "utf8")
+      (0, import_node_fs4.readFileSync)(new URL("../../package.json", __VOBS_CJS_FILE_URL), "utf8")
     );
     return manifest.version ?? "1.7.5";
   } catch {
@@ -431,7 +448,7 @@ async function dshInitCommand(target, options) {
     "dsh-plugin"
   );
   ensureDir(targetDir);
-  (0, import_node_fs3.writeFileSync)(
+  (0, import_node_fs4.writeFileSync)(
     (0, import_node_path5.resolve)(targetDir, ".gitignore"),
     ["node_modules/", "*.log", "*.tsbuildinfo", "", "# lib/ \u662F\u6784\u5EFA\u4EA7\u7269\uFF0C\u5FC5\u987B\u63D0\u4EA4\uFF1ADSH \u5B89\u88C5\u65F6\u4E0D\u4F1A\u6784\u5EFA\u4F60\u7684\u5305\u3002", ""].join("\n"),
     "utf8"
@@ -458,7 +475,7 @@ __name(dshInitCommand, "dshInitCommand");
 async function dshBuildCommand() {
   const projectDir = process.cwd();
   const configFile = (0, import_node_path5.resolve)(projectDir, "vite.config.ts");
-  if (!(0, import_node_fs3.existsSync)(configFile)) {
+  if (!(0, import_node_fs4.existsSync)(configFile)) {
     logger.error("\u5F53\u524D\u76EE\u5F55\u6CA1\u6709 vite.config.ts\uFF0C\u8BF7\u5728\u63D2\u4EF6\u9879\u76EE\u6839\u76EE\u5F55\u8FD0\u884C\u3002");
     process.exitCode = 1;
     return;
@@ -481,7 +498,7 @@ async function dshBuildCommand() {
   logger.info("\u6784\u5EFA Host \u4EA7\u7269 \u2026");
   const hostTarget = (0, import_node_path5.resolve)(projectDir, hostEntry.replace(/^\.\//u, ""));
   const hostEntrySource = (0, import_node_path5.resolve)(projectDir, "src", "host", "index.ts");
-  if (!(0, import_node_fs3.existsSync)(hostEntrySource)) {
+  if (!(0, import_node_fs4.existsSync)(hostEntrySource)) {
     logger.warn(`\u6CA1\u6709\u627E\u5230 ${hostEntrySource}\uFF0C\u8DF3\u8FC7 Host \u6784\u5EFA\u3002`);
     return;
   }
@@ -594,7 +611,7 @@ async function dshDevCommand(options) {
       packageRoot = (0, import_node_path5.dirname)((0, import_node_path5.dirname)(projectRequire.resolve("@vobs/dsh")));
     }
     const candidate = (0, import_node_path5.join)(packageRoot, "dist", "preview.js");
-    previewFile = (0, import_node_fs3.existsSync)(candidate) ? candidate : void 0;
+    previewFile = (0, import_node_fs4.existsSync)(candidate) ? candidate : void 0;
   } catch {
     previewFile = void 0;
   }
@@ -666,7 +683,7 @@ data: 1
       return;
     }
     if (url === "/client.js") {
-      if (!(0, import_node_fs3.existsSync)(clientFile)) {
+      if (!(0, import_node_fs4.existsSync)(clientFile)) {
         response.writeHead(503, { "content-type": "text/plain; charset=utf-8" });
         response.end(`\u8FD8\u6CA1\u6709\u4EA7\u7269\uFF1A${clientEntry}
 ${buildError ?? ""}`);
@@ -687,7 +704,7 @@ ${buildError ?? ""}`);
 __name(dshDevCommand, "dshDevCommand");
 function readManifest(dir) {
   try {
-    return JSON.parse((0, import_node_fs3.readFileSync)((0, import_node_path5.resolve)(dir, "package.json"), "utf8"));
+    return JSON.parse((0, import_node_fs4.readFileSync)((0, import_node_path5.resolve)(dir, "package.json"), "utf8"));
   } catch {
     return void 0;
   }
@@ -710,10 +727,10 @@ function collectIssues(dir) {
     result.errors.push("\u7F3A\u5C11 dsh.bundle.patch \u2014\u2014 DSH \u4E0D\u4F1A\u628A\u8FD9\u4E2A\u5305\u5F53\u4F5C\u7EC4\u5408\u5305\uFF08bundle\uFF09");
   } else {
     const patchPath = (0, import_node_path5.resolve)(dir, bundle.patch.replace(/^\.\//u, ""));
-    if (!(0, import_node_fs3.existsSync)(patchPath)) {
+    if (!(0, import_node_fs4.existsSync)(patchPath)) {
       result.errors.push(`dsh.bundle.patch \u6307\u5411\u7684 ${bundle.patch} \u4E0D\u5B58\u5728`);
     } else {
-      const text5 = (0, import_node_fs3.readFileSync)(patchPath, "utf8");
+      const text5 = (0, import_node_fs4.readFileSync)(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`);
@@ -727,7 +744,7 @@ function collectIssues(dir) {
   const hostEntry = exportsField["."];
   const clientEntry = exportsField["./client"];
   if (typeof hostEntry !== "string") result.errors.push('exports["."] \u672A\u58F0\u660E \u2014\u2014 DSH \u52A0\u8F7D\u4E0D\u5230 Host \u4FA7\u63D2\u4EF6');
-  else if (!(0, import_node_fs3.existsSync)((0, import_node_path5.resolve)(dir, hostEntry.replace(/^\.\//u, "")))) {
+  else if (!(0, import_node_fs4.existsSync)((0, import_node_path5.resolve)(dir, hostEntry.replace(/^\.\//u, "")))) {
     result.errors.push(`exports["."] \u6307\u5411\u7684 ${hostEntry} \u4E0D\u5B58\u5728\uFF0C\u5148\u6784\u5EFA`);
   } else result.passed.push("Host \u5165\u53E3\u5B58\u5728");
   if (typeof clientEntry !== "string") result.errors.push('exports["./client"] \u672A\u58F0\u660E \u2014\u2014 \u9875\u9762\u62FF\u4E0D\u5230\u5BA2\u6237\u7AEF bundle');
@@ -745,10 +762,10 @@ function collectIssues(dir) {
   } else result.passed.push("\u6CA1\u6709 workspace: \u534F\u8BAE\u4F9D\u8D56");
   if (typeof clientEntry === "string") {
     const clientPath = (0, import_node_path5.resolve)(dir, clientEntry.replace(/^\.\//u, ""));
-    if (!(0, import_node_fs3.existsSync)(clientPath)) {
+    if (!(0, import_node_fs4.existsSync)(clientPath)) {
       result.errors.push(`\u5BA2\u6237\u7AEF\u4EA7\u7269 ${clientEntry} \u4E0D\u5B58\u5728\uFF0C\u5148\u8FD0\u884C\u6784\u5EFA`);
     } else {
-      const code = (0, import_node_fs3.readFileSync)(clientPath, "utf8");
+      const code = (0, import_node_fs4.readFileSync)(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");
@@ -799,7 +816,7 @@ function buildInstallSpec(options) {
   if (options.spec !== void 0) return { spec: options.spec };
   if (options.from !== void 0) {
     const target = (0, import_node_path5.resolve)(options.from);
-    if (!(0, import_node_fs3.existsSync)(target)) return { error: `--from \u6307\u5411\u7684\u8DEF\u5F84\u4E0D\u5B58\u5728\uFF1A${target}` };
+    if (!(0, import_node_fs4.existsSync)(target)) return { error: `--from \u6307\u5411\u7684\u8DEF\u5F84\u4E0D\u5B58\u5728\uFF1A${target}` };
     return { spec: target };
   }
   if (options.repo !== void 0) {
@@ -906,8 +923,309 @@ async function dshCommand(action, target, options) {
 }
 __name(dshCommand, "dshCommand");
 
+// packages/cli/src/commands/check.ts
+var import_promises2 = require("fs/promises");
+var import_node_path6 = __toESM(require("path"), 1);
+var import_typescript = __toESM(require("typescript"), 1);
+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 (0, import_promises2.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 (0, import_promises2.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(import_node_path6.default.join(dir, entry.name));
+        continue;
+      }
+      if (!entry.isFile()) continue;
+      if (!/\.tsx?$/u.test(entry.name) || entry.name.endsWith(".d.ts")) continue;
+      found.push(import_node_path6.default.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 (import_typescript.default.isJsxElement(child) || import_typescript.default.isJsxSelfClosingElement(child) || import_typescript.default.isJsxFragment(child)) {
+      seen = true;
+      return;
+    }
+    if (child !== node && import_typescript.default.isFunctionLike(child)) return;
+    import_typescript.default.forEachChild(child, visit);
+  }, "visit");
+  import_typescript.default.forEachChild(node, visit);
+  return seen;
+}
+__name(returnsJsx, "returnsJsx");
+function signalNameOf(node) {
+  if (!import_typescript.default.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 === import_typescript.default.SyntaxKind.EqualsToken || kind === import_typescript.default.SyntaxKind.PlusEqualsToken || kind === import_typescript.default.SyntaxKind.MinusEqualsToken || kind === import_typescript.default.SyntaxKind.AsteriskEqualsToken || kind === import_typescript.default.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 && import_typescript.default.isFunctionLike(node)) return;
+      const nextUntracked = insideUntrack || import_typescript.default.isCallExpression(node) && import_typescript.default.isIdentifier(node.expression) && node.expression.text === "untrack";
+      if (import_typescript.default.isBinaryExpression(node) && isWriteOperator(node.operatorToken.kind)) {
+        const name = signalNameOf(node.left);
+        if (name !== void 0 && !nextUntracked) writes.set(name, node);
+      } else if ((import_typescript.default.isPrefixUnaryExpression(node) || import_typescript.default.isPostfixUnaryExpression(node)) && (node.operator === import_typescript.default.SyntaxKind.PlusPlusToken || node.operator === import_typescript.default.SyntaxKind.MinusMinusToken)) {
+        const name = signalNameOf(node.operand);
+        if (name !== void 0) {
+          if (!nextUntracked) writes.set(name, node);
+          reads.set(name, node);
+        }
+      } else if (import_typescript.default.isCallExpression(node) && import_typescript.default.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 = import_typescript.default.isBinaryExpression(parent) && isWriteOperator(parent.operatorToken.kind) && parent.left === node;
+          if (!isAssignmentTarget) reads.set(name, node);
+        }
+      }
+      import_typescript.default.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 (import_typescript.default.isCallExpression(node) && import_typescript.default.isIdentifier(node.expression) && (node.expression.text === "effect" || node.expression.text === "renderEffect")) {
+      const callback = node.arguments[0];
+      if (callback !== void 0 && (import_typescript.default.isArrowFunction(callback) || import_typescript.default.isFunctionExpression(callback))) {
+        inspectEffectBody(callback.body);
+      }
+    }
+    import_typescript.default.forEachChild(node, visit);
+  }, "visit");
+  visit(source);
+  return found;
+}
+__name(ruleEffectSelfSubscription, "ruleEffectSelfSubscription");
+function isKeyedListCall(node) {
+  if (!import_typescript.default.isCallExpression(node)) return false;
+  if (!import_typescript.default.isPropertyAccessExpression(node.expression) || node.expression.name.text !== "map") return false;
+  const callback = node.arguments[0];
+  return callback !== void 0 && import_typescript.default.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 (import_typescript.default.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 (import_typescript.default.isBinaryExpression(node) && node.operatorToken.kind === import_typescript.default.SyntaxKind.AmpersandAmpersandToken && isKeyedListCall(node.right)) {
+      found.push(diagnosticAt(source, file, node.right, { code: VOBS_C232, severity: "warning", message, fix }));
+    }
+    import_typescript.default.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 (import_typescript.default.isFunctionLike(child)) return;
+    if (signalNameOf(child) !== void 0) {
+      seen = true;
+      return;
+    }
+    import_typescript.default.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 || !import_typescript.default.isBlock(body) || !returnsJsx(fn)) return;
+    const captured = [];
+    for (const statement of body.statements) {
+      if (!import_typescript.default.isVariableStatement(statement)) continue;
+      for (const declaration of statement.declarationList.declarations) {
+        if (!import_typescript.default.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 (import_typescript.default.isJsxExpression(node) && node.expression !== void 0) {
+        const scan = /* @__PURE__ */ __name((child) => {
+          if (import_typescript.default.isIdentifier(child)) usedInJsx.add(child.text);
+          import_typescript.default.forEachChild(child, scan);
+        }, "scan");
+        scan(node.expression);
+      }
+      import_typescript.default.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 (import_typescript.default.isFunctionDeclaration(node) || import_typescript.default.isFunctionExpression(node) || import_typescript.default.isArrowFunction(node)) {
+      inspectComponent(node);
+    }
+    import_typescript.default.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 = import_typescript.default.createSourceFile(file, text5, import_typescript.default.ScriptTarget.Latest, true, import_typescript.default.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 = import_node_path6.default.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(import_node_path6.default.relative(root, file).split(import_node_path6.default.sep).join("/")));
+  const skipped = all.length - files.length;
+  const diagnostics = [];
+  for (const absolute of files) {
+    const text5 = await (0, import_promises2.readFile)(absolute, "utf8");
+    const relative2 = import_node_path6.default.relative(root, absolute).split(import_node_path6.default.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 = import_node_path6.default.join(root, REPORT_PATH);
+    await (0, import_promises2.mkdir)(import_node_path6.default.dirname(target), { recursive: true });
+    await (0, import_promises2.writeFile)(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";
@@ -923,12 +1241,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");
@@ -982,6 +1300,14 @@ function createCLI() {
       dev: options.dev
     });
   });
+  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,
@@ -1003,18 +1329,30 @@ 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
-var import_promises2 = require("readline/promises");
+var import_promises3 = require("readline/promises");
 var import_node_process = require("process");
 var import_picocolors2 = __toESM(require("picocolors"), 1);
 async function startRepl() {
   showLogo();
-  const rl = (0, import_promises2.createInterface)({
+  const rl = (0, import_promises3.createInterface)({
     input: import_node_process.stdin,
     output: import_node_process.stdout,
     prompt: `  ${import_picocolors2.default.magenta("\u276F")} `,
@@ -1125,16 +1463,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");
 // Annotate the CommonJS export names for ESM import in node: