@farris/cli 2.2.6 → 2.3.0

package/lib/common/output.js

@@ -1,5 +1,8 @@
 import ora from 'ora';
+import { resolve } from 'node:path';
 import { SCHEMA_VERSION, ExitCode } from './constant.js';
+import { PROJECT_CONTAINERS } from './project-layout.js';
+import { PROJECT_SCRIPT_CONTRACT, ROOT_SCRIPT_CONTRACT, cliScriptCommand, cliScriptTarget, rootScriptCommand } from './workspace-contract.js';
 let isJsonMode = false;
 export function setJsonMode(value) {
     isJsonMode = !!value;
@@ -38,7 +41,7 @@ export function logWarn(message) {
         process.stderr.write(`[WARN] ${message}\n`);
     }
     else {
-        console.warn(`\x1b[33m${message}\x1b[0m`);
+        console.warn(message);
     }
 }
 export function logError(message) {
@@ -46,7 +49,7 @@ export function logError(message) {
         process.stderr.write(`[ERROR] ${message}\n`);
     }
     else {
-        console.error(`\x1b[31m${message}\x1b[0m`);
+        console.error(message);
     }
 }
 /**
@@ -92,4 +95,71 @@ export function createSpinner(text) {
     const spinner = ora(text);
     return spinner;
 }
+const INDENT = '   ';
+const COMMAND_COLUMN_WIDTH = 30;
+const DESCRIPTION_COLUMN_WIDTH = 18;
+/** 粗略计算显示宽度：CJK 与全角按 2 列计，保证命令区块对齐。 */
+function displayWidth(text) {
+    let width = 0;
+    for (const char of text) {
+        const code = char.codePointAt(0) ?? 0;
+        const isWide = code >= 0x1100 &&
+            (code <= 0x115f ||
+                (code >= 0x2e80 && code <= 0xa4cf) ||
+                (code >= 0xac00 && code <= 0xd7a3) ||
+                (code >= 0xf900 && code <= 0xfaff) ||
+                (code >= 0xfe30 && code <= 0xfe6f) ||
+                (code >= 0xff00 && code <= 0xff60) ||
+                (code >= 0xffe0 && code <= 0xffe6));
+        width += isWide ? 2 : 1;
+    }
+    return width;
+}
+function padColumns(command, description) {
+    const commandPad = Math.max(1, COMMAND_COLUMN_WIDTH - displayWidth(command));
+    const descriptionPad = Math.max(1, DESCRIPTION_COLUMN_WIDTH - displayWidth(description));
+    return `${command}${' '.repeat(commandPad)}# ${description}${' '.repeat(descriptionPad)}`;
+}
+function rootScriptLine(item) {
+    if (item.kind === 'cli') {
+        const command = cliScriptCommand(item.script, item.sampleArg);
+        const target = cliScriptTarget(item.containerKey, item.sampleArg);
+        return `${padColumns(command, item.description)}→ ${target}`;
+    }
+    return padColumns(rootScriptCommand(item.script), item.description);
+}
+function quoteIfNeeded(value) {
+    return /\s/.test(value) ? `"${value}"` : value;
+}
+export function printSuccess(summary) {
+    logInfo(`✔ ${summary}`);
+}
+/**
+ * 统一收尾提示：结果行 → 接下来 → 两个「常用命令」区块。
+ * 收录边界由 workspace-contract.ts 的脚本契约决定，脚本契约变化时提示随之变化。
+ */
+export function printNextSteps(input) {
+    const lines = [''];
+    lines.push('接下来：');
+    lines.push('');
+    if (resolve(input.cwd, input.targetArg) !== resolve(input.cwd)) {
+        lines.push(`${INDENT}cd ${quoteIfNeeded(input.targetArg)}`);
+    }
+    if (!input.installed) {
+        lines.push(`${INDENT}pnpm install`);
+    }
+    if (input.appPackageName) {
+        lines.push(`${INDENT}pnpm --filter ${input.appPackageName} dev`);
+    }
+    lines.push('');
+    lines.push('| 常用命令 · 在 workspace 根目录执行');
+    lines.push('');
+    ROOT_SCRIPT_CONTRACT.forEach((item) => lines.push(`${INDENT}${rootScriptLine(item)}`));
+    lines.push('');
+    lines.push(`| 常用命令 · 在具体工程目录内执行（如 cd ${PROJECT_CONTAINERS.app}/app）`);
+    lines.push('');
+    PROJECT_SCRIPT_CONTRACT.forEach((item) => lines.push(`${INDENT}${padColumns(rootScriptCommand(item.script), item.description)}`));
+    lines.push('');
+    logInfo(lines.join('\n'));
+}
 //# sourceMappingURL=output.js.map

package/lib/common/output.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/common/output.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/common/output.ts"],"names":[],"mappings":"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"}

package/lib/common/project-layout.js

@@ -0,0 +1,143 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+/** 新结构容器：app → applications，lib → libraries。全仓库唯一来源。 */
+export const PROJECT_CONTAINERS = { app: 'applications', lib: 'libraries' };
+/** 旧结构容器：只读兼容识别，不再写入。 */
+export const LEGACY_CONTAINERS = ['packages'];
+export function containerFor(type) {
+    return PROJECT_CONTAINERS[type];
+}
+export function resolveProjectPath(wsRoot, type, dir) {
+    return join(wsRoot, containerFor(type), dir);
+}
+/**
+ * 解析 pnpm-workspace.yaml 的 packages 列表。
+ * 只识别 `- "dir/*"` 形式，不引入 yaml 依赖；结构超出该形式时返回空数组，由调用方回退。
+ */
+export function parsePackagesBlock(content) {
+    const globs = [];
+    let inPackages = false;
+    for (const rawLine of content.split(/\r?\n/)) {
+        const line = rawLine.replace(/#.*$/, '');
+        if (/^packages\s*:\s*$/.test(line)) {
+            inPackages = true;
+            continue;
+        }
+        if (!inPackages || line.trim() === '') {
+            continue;
+        }
+        if (/^\S/.test(line)) {
+            // 回到顶层键，packages 块结束
+            inPackages = false;
+            continue;
+        }
+        const match = line.match(/^\s*-\s*["']?([^"'\s]+)["']?\s*$/);
+        if (match) {
+            globs.push(match[1]);
+        }
+    }
+    return globs;
+}
+/**
+ * 读出 workspace 的待扫描 glob。解析不到时回退到三个约定容器目录，并置 fallback=true。
+ */
+export function readWorkspaceGlobs(wsRoot) {
+    const convention = [...LEGACY_CONTAINERS, ...Object.values(PROJECT_CONTAINERS)].map((container) => `${container}/*`);
+    const yamlPath = join(wsRoot, 'pnpm-workspace.yaml');
+    if (!existsSync(yamlPath)) {
+        return { globs: convention, fallback: true };
+    }
+    const parsed = parsePackagesBlock(readFileSync(yamlPath, 'utf-8'));
+    if (parsed.length === 0) {
+        return { globs: convention, fallback: true };
+    }
+    return { globs: parsed, fallback: false };
+}
+function detectLegacyType(projectDir) {
+    return existsSync(join(projectDir, 'components', 'index.ts')) ? 'lib' : 'app';
+}
+/**
+ * 扫描 workspace 内的工程：同时支持新结构（applications / libraries）与旧结构（packages）。
+ */
+export function listProjects(wsRoot) {
+    const { globs } = readWorkspaceGlobs(wsRoot);
+    const entries = [];
+    const seen = new Set();
+    for (const glob of globs) {
+        const match = glob.match(/^([^/]+)\/\*$/);
+        if (!match) {
+            continue;
+        }
+        const container = match[1];
+        const containerDir = join(wsRoot, container);
+        if (!existsSync(containerDir) || !statSync(containerDir).isDirectory()) {
+            continue;
+        }
+        for (const name of readdirSync(containerDir).sort()) {
+            const projectDir = join(containerDir, name);
+            if (!statSync(projectDir).isDirectory()) {
+                continue;
+            }
+            const dir = `${container}/${name}`;
+            if (seen.has(dir)) {
+                continue;
+            }
+            seen.add(dir);
+            const type = container === PROJECT_CONTAINERS.app
+                ? 'app'
+                : container === PROJECT_CONTAINERS.lib
+                    ? 'lib'
+                    : detectLegacyType(projectDir);
+            entries.push({ type, dir, name });
+        }
+    }
+    return entries;
+}
+/**
+ * workspace 是否已采用新容器结构。verifier 用它区分「新工作空间强校验」与「旧工作空间只读兼容」。
+ */
+export function usesNewContainers(wsRoot) {
+    const { globs, fallback } = readWorkspaceGlobs(wsRoot);
+    if (fallback) {
+        return false;
+    }
+    return globs.some((glob) => glob.startsWith(`${PROJECT_CONTAINERS.app}/`) || glob.startsWith(`${PROJECT_CONTAINERS.lib}/`));
+}
+/**
+ * 从包名推导目录名（去掉 scope 并转为合法 kebab-case）
+ */
+export function deriveAppDir(name) {
+    const withoutScope = name.replace(/^@[^/]+\//, '');
+    return withoutScope
+        .toLowerCase()
+        .replace(/[^a-z0-9-_]/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/**
+ * 校验 npm 包名有效性
+ */
+export function validatePackageName(name) {
+    if (!name || typeof name !== 'string') {
+        return false;
+    }
+    return /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/.test(name);
+}
+/**
+ * 向上查找 Workspace 根目录（同时含 pnpm-workspace.yaml 与 package.json）。
+ */
+export function findWorkspaceRoot(startDir = process.cwd()) {
+    let current = resolve(startDir);
+    while (true) {
+        if (existsSync(join(current, 'pnpm-workspace.yaml')) &&
+            existsSync(join(current, 'package.json'))) {
+            return current;
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    return null;
+}
+//# sourceMappingURL=project-layout.js.map

package/lib/common/project-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-layout.js","sourceRoot":"","sources":["../../src/common/project-layout.ts"],"names":[],"mappings":"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"}

package/lib/common/safety.js

@@ -14,6 +14,8 @@ export const KNOWN_AI_AND_META_ENTRIES = new Set([
     '.github',
     '.codebuddy',
     '.trae',
+    '.gemini',
+    '.aider.conf.yml',
     'agents.md',
     'claude.md',
     'gemini.md',
@@ -32,6 +34,8 @@ export const PROJECT_EVIDENCE_FILES = [
     'farris.config.mjs',
     'tsconfig.json',
     'src',
+    'applications',
+    'libraries',
     'packages',
     'node_modules'
 ];
@@ -101,8 +105,6 @@ export function inspectTarget(targetPath) {
     }
     // 检查是否是现有 workspace
     const hasWorkspaceYaml = entries.includes('pnpm-workspace.yaml');
-    const hasPackageJson = entries.includes('package.json');
-    const hasPackagesDir = entries.includes('packages');
     if (hasWorkspaceYaml) {
         return {
             status: WorkspaceStatus.EXISTING_WORKSPACE,

package/lib/common/safety.js.map

@@ -1 +1 @@
-{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../src/common/safety.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../src/common/safety.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAmC,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,4BAA4B;AAC5B,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IAC/C,MAAM;IACN,YAAY;IACZ,QAAQ;IACR,SAAS;IACT,SAAS;IACT,SAAS;IACT,cAAc;IACd,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,WAAW;IACX,WAAW;IACX,WAAW;IACX,gBAAgB;IAChB,cAAc;CACf,CAAC,CAAC;AAEH,WAAW;AACX,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,cAAc;IACd,qBAAqB;IACrB,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,kBAAkB;IAClB,mBAAmB;IACnB,eAAe;IACf,KAAK;IACL,cAAc;IACd,WAAW;IACX,UAAU;IACV,cAAc;CACf,CAAC;AAYF;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QACzC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;KAC1D;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAChD,sBAAsB;IACtB,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;QAC3B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;KAC5D;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,MAAM,cAAc,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACtD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE;QACzB,OAAO;YACL,MAAM,EAAE,eAAe,CAAC,cAAc;YACtC,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,EAAE;YACb,qBAAqB,EAAE,EAAE;YACzB,OAAO,EAAE,cAAc,CAAC,KAAK;SAC9B,CAAC;KACH;IAED,MAAM,cAAc,GAAG,cAAc,CAAC,QAAQ,CAAC;IAE/C,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE;QAC/B,OAAO;YACL,MAAM,EAAE,eAAe,CAAC,OAAO;YAC/B,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,EAAE;YACb,qBAAqB,EAAE,EAAE;SAC1B,CAAC;KACH;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE;QACvB,OAAO;YACL,MAAM,EAAE,eAAe,CAAC,cAAc;YACtC,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,CAAC,cAAc,CAAC;YAC3B,qBAAqB,EAAE,EAAE;YACzB,OAAO,EAAE,aAAa;SACvB,CAAC;KACH;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;IAE5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE;QACxB,OAAO;YACL,MAAM,EAAE,eAAe,CAAC,KAAK;YAC7B,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,EAAE;YACb,qBAAqB,EAAE,EAAE;SAC1B,CAAC;KACH;IAED,oBAAoB;IACpB,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAEjE,IAAI,gBAAgB,EAAE;QACpB,OAAO;YACL,MAAM,EAAE,eAAe,CAAC,kBAAkB;YAC1C,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,CAAC,qBAAqB,CAAC;YAClC,qBAAqB,EAAE,EAAE;SAC1B,CAAC;KACH;IAED,eAAe;IACf,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE;QAC/B,OAAO;YACL,MAAM,EAAE,eAAe,CAAC,2BAA2B;YACnD,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,gBAAgB;YAC3B,qBAAqB,EAAE,EAAE;SAC1B,CAAC;KACH;IAED,qBAAqB;IACrB,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAClC,IAAI,yBAAyB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YACxC,SAAS;SACV;QACD,SAAS,GAAG,KAAK,CAAC;QAClB,4CAA4C;QAC5C,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;KAC7B;IAED,IAAI,SAAS,EAAE;QACb,OAAO;YACL,MAAM,EAAE,eAAe,CAAC,cAAc;YACtC,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,EAAE;YACb,qBAAqB,EAAE,EAAE;SAC1B,CAAC;KACH;IAED,OAAO;QACL,MAAM,EAAE,eAAe,CAAC,oBAAoB;QAC5C,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,EAAE;QACb,qBAAqB,EAAE,eAAe;KACvC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB,EAAE,oBAA8B;IACrF,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE;QAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE;YACxB,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;SACzB;KACF;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/common/template-manifest.js

@@ -1,15 +1,13 @@
 import { resolve } from 'node:path';
 import { getDirname } from './constant.js';
-const APP_REPLACE_FILES = ['package.json', 'farris.config.mjs', 'index.html', 'project.json'];
-const LIB_REPLACE_FILES = ['package.json', 'farris.config.mjs', 'README.md'];
 export function resolveTemplate(input) {
     if (input.type === 'lib') {
-        return { id: 'lib', replaceFiles: [...LIB_REPLACE_FILES] };
+        return { id: 'lib' };
     }
     if (!input.platform) {
         throw new Error('platform is required when type is app');
     }
-    return { id: input.platform, replaceFiles: [...APP_REPLACE_FILES] };
+    return { id: input.platform };
 }
 export function getTemplateDir(id) {
     return resolve(getDirname(import.meta.url), '../../templates', id);

package/lib/common/template-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"template-manifest.js","sourceRoot":"","sources":["../../src/common/template-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAS3C,MAAM,iBAAiB,GAAG,CAAC,cAAc,EAAE,mBAAmB,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;AAC9F,MAAM,iBAAiB,GAAG,CAAC,cAAc,EAAE,mBAAmB,EAAE,WAAW,CAAC,CAAC;AAE7E,MAAM,UAAU,eAAe,CAAC,KAG/B;IACC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE;QACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,GAAG,iBAAiB,CAAC,EAAE,CAAC;KAC5D;IACD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;QACnB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;KAC1D;IACD,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,GAAG,iBAAiB,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAc;IAC3C,OAAO,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC"}
+{"version":3,"file":"template-manifest.js","sourceRoot":"","sources":["../../src/common/template-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAQ3C,MAAM,UAAU,eAAe,CAAC,KAG/B;IACC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE;QACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;KACtB;IACD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;QACnB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;KAC1D;IACD,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAc;IAC3C,OAAO,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC"}

package/lib/common/verifier.js

@@ -1,8 +1,84 @@
-import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
-import { resolve, join } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve, join, relative } from 'node:path';
 import { findUnreplacedPlaceholders } from './template-renderer.js';
+import { LEGACY_CONTAINERS, PROJECT_CONTAINERS, listProjects, usesNewContainers } from './project-layout.js';
+import { CLI_COMMAND_REGISTRY, FORBIDDEN_ROOT_SCRIPTS, ROOT_SCRIPT_CONTRACT, expectedRootScriptValue } from './workspace-contract.js';
+/** 任何布局都必须存在的根脚本。 */
+const REQUIRED_ROOT_SCRIPTS = ['build', 'typecheck'];
+const CONTAINER_LIST = Object.values(PROJECT_CONTAINERS);
+function readJson(filePath) {
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function verifyAppProject(project, projectPath, pkg, label, addCheck) {
+    addCheck(`${label}_catalog_deps`, pkg.dependencies?.['@farris/ui-vue'] === 'catalog:', `工程 ${project.dir} 的 @farris/ui-vue 依赖必须使用 catalog: 协议`);
+    const indexHtmlPath = join(projectPath, 'index.html');
+    if (!existsSync(indexHtmlPath)) {
+        addCheck(`${label}_index_html`, false, `工程 ${project.dir} 缺少 index.html`);
+    }
+    else {
+        const html = readFileSync(indexHtmlPath, 'utf-8');
+        const hasCorrectEntry = /<script\s+type="module"\s+src="\/src\/main\.ts">\s*<\/script>/.test(html);
+        const hasWrongEntry = /<script\s+type="module"\s+src="\.\/src\/main\.ts">\s*<\/script>/.test(html);
+        addCheck(`${label}_html_entry`, hasCorrectEntry && !hasWrongEntry, `工程 ${project.dir} 的 index.html 入口必须为 /src/main.ts，不得写为 ./src/main.ts`);
+    }
+    addCheck(`${label}_main_ts`, existsSync(join(projectPath, 'src', 'main.ts')), `工程 ${project.dir} 缺少 src/main.ts`);
+    const hasAppVue = existsSync(join(projectPath, 'src', 'App.vue'));
+    const hasAppTsx = existsSync(join(projectPath, 'src', 'App.tsx'));
+    addCheck(`${label}_app_entry`, hasAppVue || hasAppTsx, `工程 ${project.dir} 缺少 src/App.vue（或历史兼容的 src/App.tsx）`);
+    const farrisConfigPath = join(projectPath, 'farris.config.mjs');
+    const configContent = existsSync(farrisConfigPath) ? readFileSync(farrisConfigPath, 'utf-8') : '';
+    const hasRelativeBase = /base\s*:\s*['"]\.\/?['"]/.test(configContent);
+    const hasHistoryRouter = /routerMode\s*:\s*['"]history['"]/.test(configContent);
+    addCheck(`${label}_base_router_compatibility`, !(hasRelativeBase && hasHistoryRouter), `工程 ${project.dir} 配置冲突: 相对路径 base 与 history 路由模式不可同时使用`);
+}
+function verifyLibProject(project, projectPath, pkg, label, addCheck) {
+    addCheck(`${label}_components_entry`, existsSync(join(projectPath, 'components', 'index.ts')), `组件库 ${project.dir} 缺少 components/index.ts（发布物唯一入口）`);
+    addCheck(`${label}_files_whitelist`, Array.isArray(pkg.files) && pkg.files.length > 0, `组件库 ${project.dir} 的 package.json 缺少 files 白名单，误执行 npm publish 会把 src/ 推上去`);
+    addCheck(`${label}_publish_config`, !!pkg.publishConfig, `组件库 ${project.dir} 的 package.json 缺少 publishConfig`);
+}
+function verifyProject(wsRoot, project, addCheck) {
+    const label = `${project.type}_${project.dir.replace(/\//g, '_')}`;
+    const projectPath = join(wsRoot, project.dir);
+    const pkgPath = join(projectPath, 'package.json');
+    const farrisConfigPath = join(projectPath, 'farris.config.mjs');
+    const tsconfigPath = join(projectPath, 'tsconfig.json');
+    if (!existsSync(pkgPath)) {
+        addCheck(`${label}_package_json`, false, `工程 ${project.dir} 缺少 package.json`);
+        return;
+    }
+    const pkg = readJson(pkgPath);
+    if (!pkg) {
+        addCheck(`${label}_package_json_valid`, false, `工程 ${project.dir} 的 package.json 解析失败`);
+        return;
+    }
+    addCheck(`${label}_name`, !!pkg.name, `工程 ${project.dir} 的 package.json 缺少 name 字段`);
+    addCheck(`${label}_farris_config`, existsSync(farrisConfigPath), `工程 ${project.dir} 缺少 farris.config.mjs`);
+    addCheck(`${label}_tsconfig`, existsSync(tsconfigPath), `工程 ${project.dir} 缺少 tsconfig.json`);
+    addCheck(`${label}_typecheck_script`, !!pkg.scripts?.typecheck, `工程 ${project.dir} 缺少 typecheck 脚本，根 pnpm typecheck 会静默跳过它`);
+    if (project.type === 'app') {
+        verifyAppProject(project, projectPath, pkg, label, addCheck);
+    }
+    else {
+        verifyLibProject(project, projectPath, pkg, label, addCheck);
+    }
+    for (const file of [pkgPath, farrisConfigPath, tsconfigPath]) {
+        if (!existsSync(file)) {
+            continue;
+        }
+        const unreplaced = findUnreplacedPlaceholders(readFileSync(file, 'utf-8'));
+        addCheck(`${label}_placeholders_${relative(wsRoot, file).replace(/\\/g, '/')}`, unreplaced.length === 0, `文件 ${relative(wsRoot, file)} 存在未替换占位符: ${unreplaced.join(', ')}`);
+    }
+}
 /**
- * 校验 Workspace 完整性与规范合规性
+ * 校验 Workspace 完整性与规范合规性。
+ *
+ * 新结构（pnpm-workspace.yaml 含 applications/* 或 libraries/*）走强校验；
+ * 旧结构（只含 packages/*）只做兼容校验，不因历史模板缺失的项失败。
  */
 export function verifyWorkspace(targetDir, preservedInputs = []) {
     const checks = [];
@@ -22,127 +98,95 @@ export function verifyWorkspace(targetDir, preservedInputs = []) {
             errors: [`目标路径不存在: ${resolvedTarget}`]
         };
     }
-    // 1. 检查根 package.json
+    const isNewLayout = usesNewContainers(resolvedTarget);
+    // 1. 根 package.json
     const rootPkgPath = join(resolvedTarget, 'package.json');
     if (!existsSync(rootPkgPath)) {
         addCheck('root_package_json', false, '缺少根 package.json');
     }
     else {
-        try {
-            const pkg = JSON.parse(readFileSync(rootPkgPath, 'utf-8'));
+        const pkg = readJson(rootPkgPath);
+        if (!pkg) {
+            addCheck('root_package_json_valid', false, '根 package.json 解析失败');
+        }
+        else {
             addCheck('root_package_private', pkg.private === true, '根 package.json 必须声明 "private": true');
-            addCheck('root_package_scripts', !!(pkg.scripts?.build && pkg.scripts?.dev && pkg.scripts?.typecheck), '根 package.json 必须声明 build, dev, typecheck 脚本');
             addCheck('root_package_no_name', !pkg.name, '根 package.json 不应设置 name');
-        }
-        catch (e) {
-            addCheck('root_package_json_valid', false, `根 package.json 解析失败: ${e.message}`);
+            const scripts = (pkg.scripts ?? {});
+            const missingRootScripts = REQUIRED_ROOT_SCRIPTS.filter((script) => !scripts[script]);
+            addCheck('root_package_scripts', missingRootScripts.length === 0, `根 package.json 缺少必需脚本: ${missingRootScripts.join(', ')}`);
+            if (isNewLayout) {
+                const wrongScripts = ROOT_SCRIPT_CONTRACT.filter((item) => scripts[item.script] !== expectedRootScriptValue(item.script));
+                addCheck('root_package_scripts_contract', wrongScripts.length === 0, `根脚本必须按契约声明: ${wrongScripts
+                    .map((item) => `${item.script} → ${expectedRootScriptValue(item.script)}`)
+                    .join('; ')}`);
+                const forbidden = FORBIDDEN_ROOT_SCRIPTS.filter((script) => scripts[script] !== undefined);
+                addCheck('root_package_no_forbidden_scripts', forbidden.length === 0, `根 package.json 不得声明长驻服务脚本: ${forbidden.join(', ')}`);
+                addCheck('root_package_cli_dependency', pkg.devDependencies?.['@farris/cli'] === 'catalog:', '根 package.json 必须声明 "@farris/cli": "catalog:"，否则根脚本无法解析 farris-cli bin');
+            }
         }
     }
-    // 2. 检查 pnpm-workspace.yaml
+    // 2. pnpm-workspace.yaml
     const wsYamlPath = join(resolvedTarget, 'pnpm-workspace.yaml');
     if (!existsSync(wsYamlPath)) {
         addCheck('workspace_yaml', false, '缺少 pnpm-workspace.yaml');
     }
     else {
         const yamlContent = readFileSync(wsYamlPath, 'utf-8');
-        addCheck('workspace_packages_glob', yamlContent.includes('packages/*'), 'pnpm-workspace.yaml 必须包含 "packages/*"');
+        if (isNewLayout) {
+            const missingContainers = CONTAINER_LIST.filter((container) => !yamlContent.includes(`${container}/*`));
+            addCheck('workspace_packages_glob', missingContainers.length === 0, `pnpm-workspace.yaml 必须包含新容器 glob: ${missingContainers
+                .map((container) => `${container}/*`)
+                .join(', ')}`);
+        }
+        else {
+            addCheck('workspace_packages_glob', yamlContent.includes('packages/*'), 'pnpm-workspace.yaml 必须包含 "packages/*"');
+        }
         addCheck('workspace_catalog', yamlContent.includes('catalog:'), 'pnpm-workspace.yaml 必须声明 catalog 依赖版本');
     }
-    // 3. 检查 packages 目录与子应用
-    const packagesDir = join(resolvedTarget, 'packages');
-    if (!existsSync(packagesDir) || !statSync(packagesDir).isDirectory()) {
-        addCheck('packages_dir', false, '缺少 packages/ 目录');
+    // 3. 容器目录
+    if (isNewLayout) {
+        for (const container of CONTAINER_LIST) {
+            addCheck(`container_${container}`, existsSync(join(resolvedTarget, container)), `缺少容器目录: ${container}/`);
+        }
     }
     else {
-        const appDirs = readdirSync(packagesDir).filter((f) => {
-            const p = join(packagesDir, f);
-            return statSync(p).isDirectory();
-        });
-        if (appDirs.length === 0) {
-            addCheck('has_sub_apps', false, 'packages/ 目录下未发现任何应用子包');
+        const legacyContainer = LEGACY_CONTAINERS[0];
+        addCheck(`container_${legacyContainer}`, existsSync(join(resolvedTarget, legacyContainer)), `缺少容器目录: ${legacyContainer}/`);
+    }
+    // 4. 逐个工程按类型校验
+    for (const project of listProjects(resolvedTarget)) {
+        verifyProject(resolvedTarget, project, addCheck);
+    }
+    // 5. AGENTS.md 体系（仅新结构强校验，见设计文档 §8.3）
+    if (isNewLayout) {
+        const agentsPath = join(resolvedTarget, 'AGENTS.md');
+        if (!existsSync(agentsPath)) {
+            addCheck('agents_doc_exists', false, '缺少根 AGENTS.md（AI 协作契约的唯一真源）');
         }
         else {
-            addCheck('has_sub_apps', true);
-            // 逐个检查子应用
-            for (const appDir of appDirs) {
-                const appPath = join(packagesDir, appDir);
-                const appPkgPath = join(appPath, 'package.json');
-                const farrisConfigPath = join(appPath, 'farris.config.mjs');
-                const indexHtmlPath = join(appPath, 'index.html');
-                const tsconfigPath = join(appPath, 'tsconfig.json');
-                const mainTsPath = join(appPath, 'src', 'main.ts');
-                const appTsxPath = join(appPath, 'src', 'App.tsx');
-                if (!existsSync(appPkgPath)) {
-                    addCheck(`app_${appDir}_package_json`, false, `应用 ${appDir} 缺少 package.json`);
-                }
-                else {
-                    try {
-                        const appPkg = JSON.parse(readFileSync(appPkgPath, 'utf-8'));
-                        addCheck(`app_${appDir}_name`, !!appPkg.name, `应用 ${appDir} 的 package.json 缺少 name 字段`);
-                        addCheck(`app_${appDir}_catalog_deps`, appPkg.dependencies?.['@farris/ui-vue'] === 'catalog:', `应用 ${appDir} 的 @farris/ui-vue 依赖必须使用 catalog: 协议`);
-                    }
-                    catch (e) {
-                        addCheck(`app_${appDir}_package_json_valid`, false, `应用 ${appDir} package.json 解析失败: ${e.message}`);
-                    }
-                }
-                // 检查 index.html 入口
-                if (!existsSync(indexHtmlPath)) {
-                    addCheck(`app_${appDir}_index_html`, false, `应用 ${appDir} 缺少 index.html`);
-                }
-                else {
-                    const html = readFileSync(indexHtmlPath, 'utf-8');
-                    const hasCorrectEntry = /<script\s+type="module"\s+src="\/src\/main\.ts">\s*<\/script>/.test(html);
-                    const hasWrongEntry = /<script\s+type="module"\s+src="\.\/src\/main\.ts">\s*<\/script>/.test(html);
-                    addCheck(`app_${appDir}_html_entry`, hasCorrectEntry && !hasWrongEntry, `应用 ${appDir} 的 index.html 入口必须为 /src/main.ts，不得写为 ./src/main.ts`);
-                }
-                // 检查 farris.config.mjs
-                if (!existsSync(farrisConfigPath)) {
-                    addCheck(`app_${appDir}_farris_config`, false, `应用 ${appDir} 缺少 farris.config.mjs`);
-                }
-                else {
-                    const configContent = readFileSync(farrisConfigPath, 'utf-8');
-                    // 检查相对 base 与 history 组合
-                    const hasRelativeBase = /base\s*:\s*['"]\.\/?['"]/.test(configContent);
-                    const hasHistoryRouter = /routerMode\s*:\s*['"]history['"]/.test(configContent);
-                    if (hasRelativeBase && hasHistoryRouter) {
-                        addCheck(`app_${appDir}_base_router_compatibility`, false, `应用 ${appDir} 配置冲突: 相对路径 base 与 history 路由模式不可同时使用`);
-                    }
-                    else {
-                        addCheck(`app_${appDir}_base_router_compatibility`, true);
-                    }
-                }
-                // 检查 TSX 入口与多语言资源骨架
-                const localesIndexPath = join(appPath, 'src', 'locales', 'index.ts');
-                const localesZhJsonPath = join(appPath, 'src', 'locales', 'zh-CN.json');
-                addCheck(`app_${appDir}_tsconfig`, existsSync(tsconfigPath), `应用 ${appDir} 缺少 tsconfig.json`);
-                addCheck(`app_${appDir}_main_ts`, existsSync(mainTsPath), `应用 ${appDir} 缺少 src/main.ts`);
-                addCheck(`app_${appDir}_app_tsx`, existsSync(appTsxPath), `应用 ${appDir} 缺少 src/App.tsx`);
-                addCheck(`app_${appDir}_locales_index`, existsSync(localesIndexPath), `应用 ${appDir} 缺少 src/locales/index.ts`);
-                addCheck(`app_${appDir}_locales_zh_json`, existsSync(localesZhJsonPath), `应用 ${appDir} 缺少 src/locales/zh-CN.json`);
-                // 检查未替换占位符
-                const checkFiles = [appPkgPath, farrisConfigPath, indexHtmlPath, mainTsPath, appTsxPath, localesIndexPath, localesZhJsonPath];
-                for (const file of checkFiles) {
-                    if (existsSync(file)) {
-                        const content = readFileSync(file, 'utf-8');
-                        const unreplaced = findUnreplacedPlaceholders(content);
-                        if (unreplaced.length > 0) {
-                            addCheck(`app_${appDir}_placeholders_${file}`, false, `文件 ${file} 存在未替换占位符: ${unreplaced.join(', ')}`);
-                        }
-                    }
-                }
-            }
+            addCheck('agents_doc_exists', true);
+            const content = readFileSync(agentsPath, 'utf-8');
+            const missingDeclaration = CONTAINER_LIST.filter((container) => !content.includes(`${container}/`));
+            addCheck('agents_doc_containers', missingDeclaration.length === 0, `根 AGENTS.md 未声明容器目录: ${missingDeclaration.join(', ')}`);
+            const legacyContainer = LEGACY_CONTAINERS[0];
+            addCheck('agents_doc_no_legacy_container', !content.includes(`${legacyContainer}/`), `根 AGENTS.md 仍引用旧容器目录 ${legacyContainer}/，与 PROJECT_CONTAINERS 不一致`);
+            const missingCommands = CLI_COMMAND_REGISTRY.filter((command) => !content.includes(command));
+            addCheck('agents_doc_commands', missingCommands.length === 0, `根 AGENTS.md 未覆盖命令注册表中的命令: ${missingCommands.join(', ')}`);
         }
-    }
-    // 4. 检查受保护输入是否依然完好
-    if (preservedInputs.length > 0) {
-        for (const entry of preservedInputs) {
-            const entryPath = join(resolvedTarget, entry);
-            addCheck(`preserved_input_${entry}`, existsSync(entryPath), `受保护输入文件/目录丢失或被覆盖: ${entry}`);
+        const claudePath = join(resolvedTarget, 'CLAUDE.md');
+        if (existsSync(claudePath)) {
+            const raw = readFileSync(claudePath, 'utf-8');
+            const lines = raw.trimEnd().split(/\r?\n/);
+            addCheck('claude_pointer_thin', lines.length <= 3 && raw.includes('AGENTS.md'), 'CLAUDE.md 必须是不含规则正文的薄指针（≤ 3 行且包含 AGENTS.md 字样）');
         }
     }
-    const ok = errors.length === 0;
+    // 6. 受保护输入是否依然完好
+    for (const entry of preservedInputs) {
+        addCheck(`preserved_input_${entry}`, existsSync(join(resolvedTarget, entry)), `受保护输入文件/目录丢失或被覆盖: ${entry}`);
+    }
     return {
-        ok,
+        ok: errors.length === 0,
         target: resolvedTarget,
         checks,
         errors