@farris/cli 2.0.2 → 2.1.0

package/lib/common/output.js

@@ -0,0 +1,93 @@
+import ora from 'ora';
+import { SCHEMA_VERSION, ExitCode } from './constant.js';
+let isJsonMode = false;
+export function setJsonMode(value) {
+    isJsonMode = !!value;
+}
+export function getJsonMode() {
+    return isJsonMode;
+}
+/**
+ * 统一输出 JSON 信封到 stdout，并以指定退出码结束进程或返回信封
+ */
+export function sendJson(envelope, exitCode) {
+    const result = {
+        schemaVersion: SCHEMA_VERSION,
+        ok: envelope.ok !== undefined ? envelope.ok : true,
+        command: envelope.command || 'unknown',
+        ...envelope
+    };
+    process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+    if (exitCode !== undefined) {
+        process.exit(exitCode);
+    }
+}
+/**
+ * 输出日志或进度信息：在 JSON 模式下重定向至 stderr，在普通模式下输出至 stdout
+ */
+export function logInfo(message) {
+    if (isJsonMode) {
+        process.stderr.write(`[INFO] ${message}\n`);
+    }
+    else {
+        console.log(message);
+    }
+}
+export function logWarn(message) {
+    if (isJsonMode) {
+        process.stderr.write(`[WARN] ${message}\n`);
+    }
+    else {
+        console.warn(`\x1b[33m${message}\x1b[0m`);
+    }
+}
+export function logError(message) {
+    if (isJsonMode) {
+        process.stderr.write(`[ERROR] ${message}\n`);
+    }
+    else {
+        console.error(`\x1b[31m${message}\x1b[0m`);
+    }
+}
+/**
+ * 失败处理：统一支持 JSON 信封和控制台输出
+ */
+export function fail(options) {
+    const { command, error, exitCode = ExitCode.GENERAL_ERROR, extra = {} } = options;
+    if (isJsonMode) {
+        sendJson({
+            command,
+            ok: false,
+            error,
+            ...extra
+        }, exitCode);
+    }
+    else {
+        logError(`\n✖ 错误: ${error}`);
+        process.exit(exitCode);
+    }
+    process.exit(exitCode);
+}
+/**
+ * 创建 Spinner（在 JSON 模式下静默）
+ */
+export function createSpinner(text) {
+    if (isJsonMode) {
+        return {
+            start: () => ({ text }),
+            succeed: (t) => {
+                if (t)
+                    process.stderr.write(`[SUCCESS] ${t}\n`);
+            },
+            fail: (t) => {
+                if (t)
+                    process.stderr.write(`[FAIL] ${t}\n`);
+            },
+            stop: () => { },
+            text
+        };
+    }
+    const spinner = ora(text);
+    return spinner;
+}
+//# sourceMappingURL=output.js.map

package/lib/common/output.js.map

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

package/lib/common/safety.js

@@ -0,0 +1,172 @@
+import { existsSync, lstatSync, readdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { WorkspaceStatus } from './constant.js';
+// 已知 AI 配置与项目元数据文件/目录（忽略列表）
+export const KNOWN_AI_AND_META_ENTRIES = new Set([
+    '.git',
+    '.gitignore',
+    '.agent',
+    '.agents',
+    '.cursor',
+    '.vscode',
+    '.superpowers',
+    '.changeset',
+    '.github',
+    '.codebuddy',
+    '.trae',
+    'agents.md',
+    'claude.md',
+    'gemini.md',
+    '.windsurfrules',
+    '.cursorrules'
+]);
+// 工程证据关键文件
+export const PROJECT_EVIDENCE_FILES = [
+    'package.json',
+    'pnpm-workspace.yaml',
+    'vite.config.ts',
+    'vite.config.js',
+    'vite.config.mjs',
+    'farris.config.ts',
+    'farris.config.js',
+    'farris.config.mjs',
+    'tsconfig.json',
+    'src',
+    'packages',
+    'node_modules'
+];
+/**
+ * 校验目标路径安全性，防止目录穿越与非法路径
+ */
+export function validateTargetPath(target) {
+    if (!target || typeof target !== 'string') {
+        return { valid: false, resolved: '', error: '目标路径不能为空' };
+    }
+    const resolved = resolve(process.cwd(), target);
+    // 检查是否在非法系统根或包含非法控制字符
+    if (resolved.includes('\0')) {
+        return { valid: false, resolved: '', error: '目标路径包含非法字符' };
+    }
+    return { valid: true, resolved };
+}
+/**
+ * 扫描目标目录状态
+ */
+export function inspectTarget(targetPath) {
+    const pathValidation = validateTargetPath(targetPath);
+    if (!pathValidation.valid) {
+        return {
+            status: WorkspaceStatus.INVALID_TARGET,
+            canCreate: false,
+            target: targetPath,
+            exists: false,
+            conflicts: [],
+            preservedInputEntries: [],
+            message: pathValidation.error
+        };
+    }
+    const resolvedTarget = pathValidation.resolved;
+    if (!existsSync(resolvedTarget)) {
+        return {
+            status: WorkspaceStatus.MISSING,
+            canCreate: true,
+            target: resolvedTarget,
+            exists: false,
+            conflicts: [],
+            preservedInputEntries: []
+        };
+    }
+    const stat = lstatSync(resolvedTarget);
+    if (!stat.isDirectory()) {
+        return {
+            status: WorkspaceStatus.INVALID_TARGET,
+            canCreate: false,
+            target: resolvedTarget,
+            exists: true,
+            conflicts: [resolvedTarget],
+            preservedInputEntries: [],
+            message: '目标路径存在但不是目录'
+        };
+    }
+    const entries = readdirSync(resolvedTarget);
+    if (entries.length === 0) {
+        return {
+            status: WorkspaceStatus.EMPTY,
+            canCreate: true,
+            target: resolvedTarget,
+            exists: true,
+            conflicts: [],
+            preservedInputEntries: []
+        };
+    }
+    // 检查是否是现有 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,
+            canCreate: false,
+            target: resolvedTarget,
+            exists: true,
+            conflicts: ['pnpm-workspace.yaml'],
+            preservedInputEntries: []
+        };
+    }
+    // 检查是否包含已有工程特征
+    const projectConflicts = entries.filter((e) => PROJECT_EVIDENCE_FILES.includes(e));
+    if (projectConflicts.length > 0) {
+        return {
+            status: WorkspaceStatus.EXISTING_OR_UNKNOWN_PROJECT,
+            canCreate: false,
+            target: resolvedTarget,
+            exists: true,
+            conflicts: projectConflicts,
+            preservedInputEntries: []
+        };
+    }
+    // 分析是否全是 AI 配置或受保护输入
+    let hasAiOnly = true;
+    const preservedInputs = [];
+    for (const entry of entries) {
+        const lower = entry.toLowerCase();
+        if (KNOWN_AI_AND_META_ENTRIES.has(lower)) {
+            continue;
+        }
+        hasAiOnly = false;
+        // 属于非冲突的用户保留文件（如 docs, prd.md, design.md 等）
+        preservedInputs.push(entry);
+    }
+    if (hasAiOnly) {
+        return {
+            status: WorkspaceStatus.AI_CONFIG_ONLY,
+            canCreate: true,
+            target: resolvedTarget,
+            exists: true,
+            conflicts: [],
+            preservedInputEntries: []
+        };
+    }
+    return {
+        status: WorkspaceStatus.PRESERVED_INPUT_ONLY,
+        canCreate: true,
+        target: resolvedTarget,
+        exists: true,
+        conflicts: [],
+        preservedInputEntries: preservedInputs
+    };
+}
+/**
+ * 预检计划写入的文件与已有文件是否存在冲突
+ */
+export function checkPlannedConflicts(targetDir, plannedRelativeFiles) {
+    const conflicts = [];
+    for (const relFile of plannedRelativeFiles) {
+        const fullPath = resolve(targetDir, relFile);
+        if (existsSync(fullPath)) {
+            conflicts.push(relFile);
+        }
+    }
+    return conflicts;
+}
+//# sourceMappingURL=safety.js.map

package/lib/common/safety.js.map

@@ -0,0 +1 @@
+{"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,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,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;IACjE,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACxD,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAEpD,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-renderer.js

@@ -0,0 +1,113 @@
+import { existsSync, readdirSync, statSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join, dirname, relative } from 'node:path';
+/**
+ * 将变量替换为模板内容
+ */
+export function renderTemplateString(content, variables) {
+    let result = content;
+    Object.keys(variables).forEach((key) => {
+        const value = variables[key];
+        const regexp = new RegExp(`<%=\\s*${key}\\s*%>`, 'g');
+        let strValue = '';
+        if (typeof value === 'object' && value !== null) {
+            if (Array.isArray(value)) {
+                strValue = JSON.stringify(value);
+            }
+            else {
+                strValue = JSON.stringify(value, null, 2);
+            }
+        }
+        else {
+            strValue = String(value ?? '');
+        }
+        result = result.replace(regexp, () => strValue);
+    });
+    return result;
+}
+/**
+ * 检测文件内容中未被替换的 <%= xxx %> 占位符
+ */
+export function findUnreplacedPlaceholders(content) {
+    const matches = content.match(/<%=\s*[\w.-]+\s*%>/g);
+    return matches ? Array.from(new Set(matches)) : [];
+}
+/**
+ * 仅枚举模板渲染后会写入的相对路径，不产生任何文件系统写入。
+ */
+export function collectTemplateOutputPaths(sourceDir, filter) {
+    const outputs = [];
+    function walk(currentSrc) {
+        if (!existsSync(currentSrc))
+            return;
+        for (const entry of readdirSync(currentSrc)) {
+            const srcPath = join(currentSrc, entry);
+            const relativePath = relative(sourceDir, srcPath).replace(/\\/g, '/');
+            if (filter && !filter(relativePath))
+                continue;
+            if (statSync(srcPath).isDirectory()) {
+                walk(srcPath);
+            }
+            else {
+                outputs.push(relativePath.endsWith('.tpl') ? relativePath.slice(0, -4) : relativePath);
+            }
+        }
+    }
+    walk(sourceDir);
+    return outputs;
+}
+/**
+ * 递归渲染模板目录到目标目录
+ */
+export function renderTemplateDir(options) {
+    const { sourceDir, targetDir, variables, skipExisting = false, filter } = options;
+    const filesCreated = [];
+    const unreplaced = [];
+    function walk(currentSrc, currentTarget) {
+        if (!existsSync(currentSrc)) {
+            return;
+        }
+        const entries = readdirSync(currentSrc);
+        for (const entry of entries) {
+            const srcPath = join(currentSrc, entry);
+            const stat = statSync(srcPath);
+            const relPath = relative(sourceDir, srcPath).replace(/\\/g, '/');
+            if (filter && !filter(relPath)) {
+                continue;
+            }
+            if (stat.isDirectory()) {
+                const nextTarget = join(currentTarget, entry);
+                walk(srcPath, nextTarget);
+            }
+            else {
+                // 去掉 .tpl 后缀
+                let targetFileName = entry;
+                if (targetFileName.endsWith('.tpl')) {
+                    targetFileName = targetFileName.slice(0, -4);
+                }
+                const targetFilePath = join(currentTarget, targetFileName);
+                if (existsSync(targetFilePath) && skipExisting) {
+                    continue;
+                }
+                const rawContent = readFileSync(srcPath, 'utf-8');
+                const rendered = renderTemplateString(rawContent, variables);
+                const leftovers = findUnreplacedPlaceholders(rendered);
+                if (leftovers.length > 0) {
+                    leftovers.forEach((p) => {
+                        unreplaced.push({ file: targetFilePath, placeholder: p });
+                    });
+                }
+                if (!existsSync(dirname(targetFilePath))) {
+                    mkdirSync(dirname(targetFilePath), { recursive: true });
+                }
+                writeFileSync(targetFilePath, rendered, 'utf-8');
+                filesCreated.push(targetFilePath);
+            }
+        }
+    }
+    walk(sourceDir, targetDir);
+    return {
+        filesCreated,
+        unreplacedPlaceholders: unreplaced
+    };
+}
+//# sourceMappingURL=template-renderer.js.map

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

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

package/lib/common/transaction.js

@@ -0,0 +1,84 @@
+import { existsSync, readFileSync, writeFileSync, unlinkSync, rmdirSync, readdirSync } from 'node:fs';
+export class Transaction {
+    constructor() {
+        this.createdFiles = new Set();
+        this.modifiedFiles = new Map(); // path -> original content
+        this.createdDirs = new Set();
+        this.committed = false;
+    }
+    /**
+     * 记录新建目录
+     */
+    recordCreatedDir(dirPath) {
+        if (!this.createdDirs.has(dirPath)) {
+            this.createdDirs.add(dirPath);
+        }
+    }
+    /**
+     * 记录即将写入/修改的文件
+     */
+    prepareWrite(filePath) {
+        if (this.createdFiles.has(filePath) || this.modifiedFiles.has(filePath)) {
+            return;
+        }
+        if (existsSync(filePath)) {
+            const original = readFileSync(filePath, 'utf-8');
+            this.modifiedFiles.set(filePath, original);
+        }
+        else {
+            this.createdFiles.add(filePath);
+        }
+    }
+    /**
+     * 提交事务
+     */
+    commit() {
+        this.committed = true;
+    }
+    /**
+     * 回滚事务
+     */
+    rollback() {
+        if (this.committed) {
+            return { rolledBackFiles: [], errors: [] };
+        }
+        const rolledBackFiles = [];
+        const errors = [];
+        // 恢复修改的文件
+        for (const [filePath, originalContent] of this.modifiedFiles.entries()) {
+            try {
+                writeFileSync(filePath, originalContent, 'utf-8');
+                rolledBackFiles.push(filePath);
+            }
+            catch (err) {
+                errors.push(`恢复文件失败: ${filePath}, 原因: ${err.message}`);
+            }
+        }
+        // 删除新建的文件
+        for (const filePath of this.createdFiles) {
+            try {
+                if (existsSync(filePath)) {
+                    unlinkSync(filePath);
+                    rolledBackFiles.push(filePath);
+                }
+            }
+            catch (err) {
+                errors.push(`删除新建文件失败: ${filePath}, 原因: ${err.message}`);
+            }
+        }
+        // 尝试清理新建的空目录（由深到浅排序）
+        const sortedDirs = Array.from(this.createdDirs).sort((a, b) => b.length - a.length);
+        for (const dir of sortedDirs) {
+            try {
+                if (existsSync(dir) && readdirSync(dir).length === 0) {
+                    rmdirSync(dir);
+                }
+            }
+            catch {
+                // 忽略非空目录清理异常
+            }
+        }
+        return { rolledBackFiles, errors };
+    }
+}
+//# sourceMappingURL=transaction.js.map

package/lib/common/transaction.js.map

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

package/lib/common/verifier.js

@@ -0,0 +1,147 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import { findUnreplacedPlaceholders } from './template-renderer.js';
+/**
+ * 校验 Workspace 完整性与规范合规性
+ */
+export function verifyWorkspace(targetDir, preservedInputs = []) {
+    const checks = [];
+    const errors = [];
+    const addCheck = (name, passed, message) => {
+        checks.push({ name, passed, message });
+        if (!passed && message) {
+            errors.push(message);
+        }
+    };
+    const resolvedTarget = resolve(process.cwd(), targetDir);
+    if (!existsSync(resolvedTarget)) {
+        return {
+            ok: false,
+            target: resolvedTarget,
+            checks: [{ name: 'target_exists', passed: false, message: `目标路径不存在: ${resolvedTarget}` }],
+            errors: [`目标路径不存在: ${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'));
+            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}`);
+        }
+    }
+    // 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/*"');
+        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/ 目录');
+    }
+    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/ 目录下未发现任何应用子包');
+        }
+        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 入口
+                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`);
+                // 检查未替换占位符
+                const checkFiles = [appPkgPath, farrisConfigPath, indexHtmlPath, mainTsPath, appTsxPath];
+                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(', ')}`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    // 4. 检查受保护输入是否依然完好
+    if (preservedInputs.length > 0) {
+        for (const entry of preservedInputs) {
+            const entryPath = join(resolvedTarget, entry);
+            addCheck(`preserved_input_${entry}`, existsSync(entryPath), `受保护输入文件/目录丢失或被覆盖: ${entry}`);
+        }
+    }
+    const ok = errors.length === 0;
+    return {
+        ok,
+        target: resolvedTarget,
+        checks,
+        errors
+    };
+}
+//# sourceMappingURL=verifier.js.map

package/lib/common/verifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.js","sourceRoot":"","sources":["../../src/common/verifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAepE;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,kBAA4B,EAAE;IAC/E,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,MAAe,EAAE,OAAgB,EAAE,EAAE;QACnE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,IAAI,OAAO,EAAE;YACtB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;SACtB;IACH,CAAC,CAAC;IAEF,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IAEzD,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE;QAC/B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,cAAc,EAAE,EAAE,CAAC;YACzF,MAAM,EAAE,CAAC,YAAY,cAAc,EAAE,CAAC;SACvC,CAAC;KACH;IAED,sBAAsB;IACtB,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE;QAC5B,QAAQ,CAAC,mBAAmB,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC;KAC1D;SAAM;QACL,IAAI;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;YAC3D,QAAQ,CAAC,sBAAsB,EAAE,GAAG,CAAC,OAAO,KAAK,IAAI,EAAE,qCAAqC,CAAC,CAAC;YAC9F,QAAQ,CACN,sBAAsB,EACtB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,EACpE,8CAA8C,CAC/C,CAAC;YACF,QAAQ,CAAC,sBAAsB,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC;SACzE;QAAC,OAAO,CAAM,EAAE;YACf,QAAQ,CAAC,yBAAyB,EAAE,KAAK,EAAE,wBAAwB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;SACjF;KACF;IAED,4BAA4B;IAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAC;IAC/D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QAC3B,QAAQ,CAAC,gBAAgB,EAAE,KAAK,EAAE,wBAAwB,CAAC,CAAC;KAC7D;SAAM;QACL,MAAM,WAAW,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACtD,QAAQ,CAAC,yBAAyB,EAAE,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,uCAAuC,CAAC,CAAC;QACjH,QAAQ,CAAC,mBAAmB,EAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,uCAAuC,CAAC,CAAC;KAC1G;IAED,wBAAwB;IACxB,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,EAAE;QACpE,QAAQ,CAAC,cAAc,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC;KACpD;SAAM;QACL,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACpD,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAC/B,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE;YACxB,QAAQ,CAAC,cAAc,EAAE,KAAK,EAAE,wBAAwB,CAAC,CAAC;SAC3D;aAAM;YACL,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;YAE/B,UAAU;YACV,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE;gBAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;gBAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;gBACjD,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;gBAC5D,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;gBAClD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;gBACpD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;gBACnD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;gBAEnD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;oBAC3B,QAAQ,CAAC,OAAO,MAAM,eAAe,EAAE,KAAK,EAAE,MAAM,MAAM,kBAAkB,CAAC,CAAC;iBAC/E;qBAAM;oBACL,IAAI;wBACF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;wBAC7D,QAAQ,CAAC,OAAO,MAAM,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,MAAM,4BAA4B,CAAC,CAAC;wBACxF,QAAQ,CACN,OAAO,MAAM,eAAe,EAC5B,MAAM,CAAC,YAAY,EAAE,CAAC,gBAAgB,CAAC,KAAK,UAAU,EACtD,MAAM,MAAM,sCAAsC,CACnD,CAAC;qBACH;oBAAC,OAAO,CAAM,EAAE;wBACf,QAAQ,CAAC,OAAO,MAAM,qBAAqB,EAAE,KAAK,EAAE,MAAM,MAAM,uBAAuB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;qBACrG;iBACF;gBAED,mBAAmB;gBACnB,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE;oBAC9B,QAAQ,CAAC,OAAO,MAAM,aAAa,EAAE,KAAK,EAAE,MAAM,MAAM,gBAAgB,CAAC,CAAC;iBAC3E;qBAAM;oBACL,MAAM,IAAI,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;oBAClD,MAAM,eAAe,GAAG,+DAA+D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACnG,MAAM,aAAa,GAAG,iEAAiE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAEnG,QAAQ,CACN,OAAO,MAAM,aAAa,EAC1B,eAAe,IAAI,CAAC,aAAa,EACjC,MAAM,MAAM,qDAAqD,CAClE,CAAC;iBACH;gBAED,uBAAuB;gBACvB,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE;oBACjC,QAAQ,CAAC,OAAO,MAAM,gBAAgB,EAAE,KAAK,EAAE,MAAM,MAAM,uBAAuB,CAAC,CAAC;iBACrF;qBAAM;oBACL,MAAM,aAAa,GAAG,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;oBAC9D,yBAAyB;oBACzB,MAAM,eAAe,GAAG,0BAA0B,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;oBACvE,MAAM,gBAAgB,GAAG,kCAAkC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;oBAEhF,IAAI,eAAe,IAAI,gBAAgB,EAAE;wBACvC,QAAQ,CACN,OAAO,MAAM,4BAA4B,EACzC,KAAK,EACL,MAAM,MAAM,uCAAuC,CACpD,CAAC;qBACH;yBAAM;wBACL,QAAQ,CAAC,OAAO,MAAM,4BAA4B,EAAE,IAAI,CAAC,CAAC;qBAC3D;iBACF;gBAED,YAAY;gBACZ,QAAQ,CAAC,OAAO,MAAM,WAAW,EAAE,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,MAAM,mBAAmB,CAAC,CAAC;gBAC9F,QAAQ,CAAC,OAAO,MAAM,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,MAAM,iBAAiB,CAAC,CAAC;gBACzF,QAAQ,CAAC,OAAO,MAAM,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,MAAM,iBAAiB,CAAC,CAAC;gBAEzF,WAAW;gBACX,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;gBACzF,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE;oBAC7B,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE;wBACpB,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;wBAC5C,MAAM,UAAU,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;wBACvD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE;4BACzB,QAAQ,CACN,OAAO,MAAM,iBAAiB,IAAI,EAAE,EACpC,KAAK,EACL,MAAM,IAAI,cAAc,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChD,CAAC;yBACH;qBACF;iBACF;aACF;SACF;KACF;IAED,mBAAmB;IACnB,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE;QAC9B,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE;YACnC,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;YAC9C,QAAQ,CACN,mBAAmB,KAAK,EAAE,EAC1B,UAAU,CAAC,SAAS,CAAC,EACrB,qBAAqB,KAAK,EAAE,CAC7B,CAAC;SACH;KACF;IAED,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IAC/B,OAAO;QACL,EAAE;QACF,MAAM,EAAE,cAAc;QACtB,MAAM;QACN,MAAM;KACP,CAAC;AACJ,CAAC"}

package/lib/config/vite-common.js

@@ -3,7 +3,7 @@ import vueJsx from '@vitejs/plugin-vue-jsx';
 import { CWD } from '../common/constant.js';
 export default {
     root: CWD,
-    base: './',
+    base: '/',
     plugins: [
         vue(),
         vueJsx()

package/lib/config/vite-common.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite-common.js","sourceRoot":"","sources":["../../src/config/vite-common.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,oBAAoB,CAAC;AACrC,OAAO,MAAM,MAAM,wBAAwB,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAE5C,eAAe;IACb,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,IAAI;IACV,OAAO,EAAE;QACP,GAAG,EAAE;QACL,MAAM,EAAE;KACT;IACD,UAAU,EAAE,KAAK;IACjB,GAAG,EAAE;QACH,mBAAmB,EAAE;YACnB,IAAI,EAAE;gBACJ,GAAG,EAAE,iBAAiB;gBACtB,mBAAmB,EAAE,CAAC,gBAAgB,EAAE,eAAe,CAAC;aACzD;SACF;KACF;CACF,CAAC"}
+{"version":3,"file":"vite-common.js","sourceRoot":"","sources":["../../src/config/vite-common.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,oBAAoB,CAAC;AACrC,OAAO,MAAM,MAAM,wBAAwB,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAE5C,eAAe;IACb,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,OAAO,EAAE;QACP,GAAG,EAAE;QACL,MAAM,EAAE;KACT;IACD,UAAU,EAAE,KAAK;IACjB,GAAG,EAAE;QACH,mBAAmB,EAAE;YACnB,IAAI,EAAE;gBACJ,GAAG,EAAE,iBAAiB;gBACtB,mBAAmB,EAAE,CAAC,gBAAgB,EAAE,eAAe,CAAC;aACzD;SACF;KACF;CACF,CAAC"}