@manohub/app-kit 0.2.0 → 0.2.3

package/lint/pre-commit.sample

@@ -1,26 +1,38 @@
-#!/bin/sh
-# app-kit 护栏 pre-commit 钩子样本：只检查**已改动文件**，目标 < 3 秒（否则人会在本机把它关掉）。
-#
-# 启用（不需要改 git 配置，默认 hooks 目录即可）：
-#   cp node_modules/@manohub/app-kit/lint/pre-commit.sample .git/hooks/pre-commit
-#   chmod +x .git/hooks/pre-commit
-#
-# 应用包不是仓库根时（monorepo，如 apps/sub-app），用环境变量指出包目录：
-#   APPKIT_APP_DIR=apps/sub-app   （可在 .git/hooks/pre-commit 里写死，或提交前 export）
-#
-# 说明：护栏以「应用包根」为 cwd 读取 appkit-guardrails.config.json；仓库根不存在该配置时
-# 必须给 APPKIT_APP_DIR，否则会以「未找到配置」失败（这是刻意为之：宁可报错，也不要静默跳过检查）。
-set -e
-
-AUDIT="node_modules/@manohub/app-kit/lint/run-all.mjs"
-
-if [ ! -f "$AUDIT" ]; then
-  echo "[guardrails] 未安装 @manohub/app-kit（找不到 $AUDIT），跳过检查"
-  exit 0
-fi
-
-if [ -n "$APPKIT_APP_DIR" ]; then
-  exec node "$AUDIT" --changed --cwd="$APPKIT_APP_DIR"
-fi
-
-exec node "$AUDIT" --changed
+#!/bin/sh
+# app-kit 护栏 pre-commit 钩子样本：只检查**已改动文件**（含新增但未提交的文件），目标 < 3 秒
+# （否则人会在本机把它关掉）。
+#
+# 启用（不需要改 git 配置，默认 hooks 目录即可）：
+#   cp node_modules/@manohub/app-kit/lint/pre-commit.sample .git/hooks/pre-commit
+#   chmod +x .git/hooks/pre-commit
+#
+# 应用包不是仓库根时（monorepo，如 apps/sub-app）：**必须**用环境变量指出包目录，
+# 因为钩子的 cwd 恒为仓库根，而本包通常只装在应用包自己的 node_modules 下：
+#   APPKIT_APP_DIR=apps/sub-app       （推荐在钩子文件里写死一行，或提交前 export）
+#
+# 说明：护栏以「应用包根」为 cwd 读取 appkit-guardrails.config.json；找不到脚本或配置时
+# 会明确告知并**跳过**本次检查（不阻塞提交）—— 静默通过的假绿比报错更危险。
+set -e
+
+# 应用包目录（缺省仓库根）
+APP_DIR="${APPKIT_APP_DIR:-.}"
+
+# 护栏脚本按「应用包自己的 node_modules → 仓库根 node_modules」依次找
+if [ -f "$APP_DIR/node_modules/@manohub/app-kit/lint/run-all.mjs" ]; then
+  AUDIT="$APP_DIR/node_modules/@manohub/app-kit/lint/run-all.mjs"
+elif [ -f "node_modules/@manohub/app-kit/lint/run-all.mjs" ]; then
+  AUDIT="node_modules/@manohub/app-kit/lint/run-all.mjs"
+else
+  echo "[guardrails] 未找到护栏脚本（已查 $APP_DIR/node_modules 与 node_modules）。"
+  echo "[guardrails] monorepo 请在钩子里设置 APPKIT_APP_DIR=<应用包目录>（如 apps/sub-app），"
+  echo "[guardrails] 否则本次提交不检查（不阻塞，但请尽快修好这条路径）。"
+  exit 0
+fi
+
+if [ ! -f "$APP_DIR/appkit-guardrails.config.json" ]; then
+  echo "[guardrails] $APP_DIR 下缺少 appkit-guardrails.config.json，无法确定被审计的应用。"
+  echo "[guardrails] 配置片段见 node_modules/@manohub/app-kit/CONTRACT.md §8。"
+  exit 0
+fi
+
+exec node "$AUDIT" --changed --cwd="$APP_DIR"

package/lint/run-all.mjs

@@ -1,59 +1,63 @@
-#!/usr/bin/env node
-/**
- * run-all —— 三条护栏的统一入口（接入方只挂这一条，见 CONTRACT.md §8）。
- *
- * 并发跑 style / component / structure，汇总输出与退出码；支持 `--changed`（只跑改动文件，供 pre-commit）。
- * 任一脚本报 error 即整体失败；`--json` 时输出聚合结果。
- *
- * 用法（接入方的 `package.json` 只挂前两条，另两条是排查单条时才用的）：
- *   node node_modules/@manohub/app-kit/lint/run-all.mjs            # 全量（挂成 "lint"）
- *   node node_modules/@manohub/app-kit/lint/run-all.mjs --changed   # 只跑改动文件（挂成 "lint:changed"）
- *   node node_modules/@manohub/app-kit/lint/style-audit.mjs         # 单条排查：style / component / structure
- *   node node_modules/@manohub/app-kit/lint/run-all.mjs --json
- */
-import { spawn } from 'node:child_process'
-import { fileURLToPath } from 'node:url'
-import { dirname, join } from 'node:path'
-import { parseArgs } from './shared.mjs'
-
-const HERE = dirname(fileURLToPath(import.meta.url))
-const AUDITS = ['style-audit.mjs', 'component-audit.mjs', 'structure-audit.mjs']
-
-const args = parseArgs()
-const passthrough = process.argv.slice(2).filter((a) => a.startsWith('--app=') || a.startsWith('--cwd='))
-if (args.changed) passthrough.push('--changed')
-if (args.json) passthrough.push('--json')
-
-const runOne = (script) =>
-  new Promise((resolve) => {
-    const child = spawn(process.execPath, [join(HERE, script), ...passthrough], {
-      cwd: args.cwd,
-      stdio: ['ignore', 'pipe', 'pipe'],
-    })
-    let stdout = ''
-    let stderr = ''
-    child.stdout.on('data', (d) => (stdout += d))
-    child.stderr.on('data', (d) => (stderr += d))
-    child.on('close', (code) => resolve({ script, code, stdout, stderr }))
-  })
-
-const started = Date.now()
-const results = await Promise.all(AUDITS.map(runOne))
-const elapsed = ((Date.now() - started) / 1000).toFixed(2)
-
-if (args.json) {
-  process.stdout.write(JSON.stringify({ audits: results.map((r) => ({ script: r.script, code: r.code })), elapsed }, null, 2) + '\n')
-} else {
-  for (const r of results) {
-    if (r.stdout) process.stdout.write(r.stdout)
-    if (r.stderr) process.stderr.write(r.stderr)
-  }
-  const failed = results.filter((r) => r.code !== 0)
-  process.stdout.write(
-    failed.length === 0
-      ? `✓ 护栏（三条）：全绿（${elapsed}s）\n`
-      : `✗ 护栏（三条）：${failed.map((f) => f.script).join(' / ')} 未通过（${elapsed}s）\n`,
-  )
-}
-
-process.exit(results.some((r) => r.code !== 0) ? 1 : 0)
+#!/usr/bin/env node
+/**
+ * run-all —— 三条护栏的统一入口（接入方只挂这一条，见 CONTRACT.md §8）。
+ *
+ * 并发跑 style / component / structure，汇总输出与退出码；支持 `--changed`（只跑改动文件，供 pre-commit）。
+ * 任一脚本报 error 即整体失败；`--json` 时输出聚合结果。
+ *
+ * 用法（经包的命令入口；接入方的 `package.json` 只挂前两条，其余是排查时才用的）：
+ *   pnpm exec appkit lint             # 全量（挂成 "lint"）
+ *   pnpm exec appkit lint --changed   # 只跑改动文件（挂成 "lint:changed"）
+ *   pnpm exec appkit lint --strict    # 收口验收：存量挂起与规则豁免一律失效
+ *   pnpm exec appkit lint:style       # 单条排查：style / component / structure
+ *   pnpm exec appkit lint --json
+ *
+ * 直接跑本脚本（`node node_modules/@manohub/app-kit/lint/run-all.mjs`）与上面完全等价 ——
+ * CLI 只是薄壳，已有钩子/脚本不必改。
+ */
+import { spawn } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+import { parseArgs } from './shared.mjs'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+const AUDITS = ['style-audit.mjs', 'component-audit.mjs', 'structure-audit.mjs']
+
+const args = parseArgs()
+const passthrough = process.argv.slice(2).filter((a) => a.startsWith('--app=') || a.startsWith('--cwd='))
+if (args.changed) passthrough.push('--changed')
+if (args.json) passthrough.push('--json')
+
+const runOne = (script) =>
+  new Promise((resolve) => {
+    const child = spawn(process.execPath, [join(HERE, script), ...passthrough], {
+      cwd: args.cwd,
+      stdio: ['ignore', 'pipe', 'pipe'],
+    })
+    let stdout = ''
+    let stderr = ''
+    child.stdout.on('data', (d) => (stdout += d))
+    child.stderr.on('data', (d) => (stderr += d))
+    child.on('close', (code) => resolve({ script, code, stdout, stderr }))
+  })
+
+const started = Date.now()
+const results = await Promise.all(AUDITS.map(runOne))
+const elapsed = ((Date.now() - started) / 1000).toFixed(2)
+
+if (args.json) {
+  process.stdout.write(JSON.stringify({ audits: results.map((r) => ({ script: r.script, code: r.code })), elapsed }, null, 2) + '\n')
+} else {
+  for (const r of results) {
+    if (r.stdout) process.stdout.write(r.stdout)
+    if (r.stderr) process.stderr.write(r.stderr)
+  }
+  const failed = results.filter((r) => r.code !== 0)
+  process.stdout.write(
+    failed.length === 0
+      ? `✓ 护栏（三条）：全绿（${elapsed}s）\n`
+      : `✗ 护栏（三条）：${failed.map((f) => f.script).join(' / ')} 未通过（${elapsed}s）\n`,
+  )
+}
+
+process.exit(results.some((r) => r.code !== 0) ? 1 : 0)