@tbox.cn/app-template-agent 0.1.0

package/scripts/stop.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+cd "$PROJECT_DIR"
+
+PORT=${PORT:-8000}
+
+echo "=== Stopping server on port $PORT ==="
+if lsof -i :"$PORT" > /dev/null 2>&1; then
+  for PID in $(lsof -t -i :"$PORT"); do
+    echo "Killing process $PID..."
+    kill -9 "$PID" 2>/dev/null || true
+  done
+  sleep 1
+  lsof -i :"$PORT" > /dev/null 2>&1 && echo "Warning: Port $PORT still in use" || echo "Port $PORT is now free"
+else
+  echo "Port $PORT is not in use"
+fi
+
+echo "=== Cleaning up residual processes ==="
+pkill -f "tsx watch src/index.ts" 2>/dev/null || true
+pkill -f "node.*dist/index.js" 2>/dev/null || true
+pkill -f "vite" 2>/dev/null || true
+
+echo "=== All services stopped ==="

package/scripts/verify-generated.mjs

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+/**
+ * verify:generated 守卫（003 D5，三项内容）：
+ *   ① 装配文件与模块声明一致（漂移 = 0，服务端 modules.ts）
+ *   ② 2 装配文件双锚点完整（imports + register 标记齐全）
+ *   ③ 装配文件无裸露 import（全部 import 行在锚区内；import type 豁免）
+ * 自包含实现（模板独立于 CLI 包），全量校验以 `tbox-app module doctor` / `tbox-app module diff` 为准。
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { readdir } from 'node:fs/promises';
+import path from 'node:path';
+import process from 'node:process';
+
+const appDir = path.resolve(process.argv[2] ?? path.join(import.meta.dirname, '..'));
+const failures = [];
+const warnings = [];
+
+const ASSEMBLY_FILES = [
+  { path: 'apps/server/src/modules.ts', markers: ['imports', 'register'] },
+  { path: 'apps/client/src/modules.ts', markers: ['imports', 'register'] },
+];
+
+const IMPORT_LINE = /^import\s+.+from\s+['"][^'"]+['"];\s*$/;
+
+/**
+ * 锚点行判定：必须为独立注释行（精确匹配），避免文件头注释中出现
+ * "@tbox:imports-begin" 字样时把锚区状态机提前置 true，导致"无裸露 import"检查失效。
+ */
+function isAnchorBegin(line) {
+  return line.trim() === '// @tbox:imports-begin';
+}
+function isAnchorEnd(line) {
+  return line.trim() === '// @tbox:imports-end';
+}
+
+/** 读取 .tbox/app.json 的 npm 模块清单 */
+function readManifestModules() {
+  try {
+    const raw = JSON.parse(readFileSync(path.join(appDir, '.tbox/app.json'), 'utf8'));
+    return Array.isArray(raw?.npmModules) ? raw.npmModules : [];
+  } catch {
+    return [];
+  }
+}
+
+/** 收集 packages/* 下本地模块 id（有 tbox.component.json） */
+async function listLocalModuleIds() {
+  const packagesDir = path.join(appDir, 'packages');
+  if (!existsSync(packagesDir)) return [];
+  const entries = await readdir(packagesDir, { withFileTypes: true });
+  const ids = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (existsSync(path.join(packagesDir, entry.name, 'tbox.component.json'))) {
+      ids.push(entry.name);
+    }
+  }
+  return ids;
+}
+
+function extractBlock(content, marker) {
+  const begin = `// @tbox:${marker}-begin`;
+  const end = `// @tbox:${marker}-end`;
+  const b = content.indexOf(begin);
+  if (b === -1) return null;
+  const e = content.indexOf(end, b);
+  if (e === -1) return null;
+  return content.slice(b + begin.length, e);
+}
+
+function idFromPkg(pkg) {
+  return pkg.replace(/^@[^/]+\//, '').replace(/\/(server|client)$/, '');
+}
+
+async function main() {
+  // ② 锚点完整 + ③ 无裸露 import
+  for (const file of ASSEMBLY_FILES) {
+    const full = path.join(appDir, file.path);
+    if (!existsSync(full)) {
+      failures.push(`${file.path}: 缺失`);
+      continue;
+    }
+    const content = readFileSync(full, 'utf8');
+    for (const marker of file.markers) {
+      const block = extractBlock(content, marker);
+      if (block === null) {
+        failures.push(`${file.path}: 缺 ${marker} 锚区`);
+      }
+    }
+    const lines = content.split(/\r?\n/);
+    let inAnchor = false;
+    lines.forEach((line, i) => {
+      if (isAnchorBegin(line)) inAnchor = true;
+      else if (isAnchorEnd(line)) inAnchor = false;
+      // import type 属类型导入（非模块装配），锚区外合法，不视为裸露
+      else if (IMPORT_LINE.test(line.trim()) && !line.trim().startsWith('import type') && !inAnchor) {
+        failures.push(`${file.path}:${i + 1} 裸露 import（不在 imports 锚区内）: ${line.trim()}`);
+      }
+    });
+  }
+
+  // ① 漂移 = 0：声明（manifest + 本地模块）vs 服务端 modules.ts 实际装配
+  // 契约包（无 tbox.component.json / 无 serverModule）不参与 modules.ts 装配，不计入声明
+  // （客户端 modules.ts 装配漂移由 tbox-app module doctor 全量校验兜底）
+  const npmModules = readManifestModules();
+  const declared = new Set([
+    ...npmModules
+      .filter((m) => existsSync(path.join(appDir, 'packages', m.id, 'tbox.component.json')))
+      .map((m) => m.id),
+    ...(await listLocalModuleIds()),
+  ]);
+  const modulesTs = existsSync(path.join(appDir, 'apps/server/src/modules.ts'))
+    ? readFileSync(path.join(appDir, 'apps/server/src/modules.ts'), 'utf8')
+    : '';
+  const importsBlock = extractBlock(modulesTs, 'imports') ?? '';
+  const actual = new Set(
+    [...importsBlock.matchAll(/from\s+['"]([^'"]+)['"]/g)].map((m) => idFromPkg(m[1])),
+  );
+  for (const id of declared) {
+    if (!actual.has(id)) failures.push(`模块 ${id} 已声明未装配（modules.ts imports 锚区）`);
+  }
+  for (const id of actual) {
+    if (!declared.has(id)) warnings.push(`模块 ${id} 已装配未声明（仅告警，可能为手接）`);
+  }
+
+  if (warnings.length > 0) {
+    console.warn('[verify:generated] 告警：');
+    for (const w of warnings) console.warn(`  - ${w}`);
+  }
+  if (failures.length > 0) {
+    console.error('[verify:generated] 校验失败：');
+    for (const f of failures) console.error(`  - ${f}`);
+    process.exitCode = 1;
+  } else {
+    console.log('[verify:generated] 通过（装配一致 + 锚点完整 + 无裸露 import）');
+  }
+}
+
+main().catch((err) => {
+  console.error('[verify:generated] 执行失败:', err);
+  process.exitCode = 1;
+});

package/tsconfig.base.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "allowImportingTsExtensions": true,
+    "noEmit": true,
+    "useDefineForClassFields": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  }
+}