soloforge 1.1.38 → 1.1.42

package/dist/engine/config/detector/framework_map.js

@@ -0,0 +1,406 @@
+/**
+ * 框架知识表 — 16 个框架的探测 profile。
+ *
+ * 每个 profile 包含：
+ * - markers: 文件标记（含内容验证）
+ * - defaultScope: 框架约定的目录结构
+ * - defaultBuildCommands: 默认构建命令
+ * - wrapperCheck: wrapper 脚本检测
+ * - layer: backend | frontend 分类
+ *
+ * 关键设计决策（设计文档 §5.3）：
+ * 1. 精确框架识别 — detect 函数检查文件内容，非仅文件存在
+ * 2. 后端先检测 + 前端排除已用标记 — 解决 NestJS 误判
+ * 3. 版本号实时解析 — 从实际文件内容提取
+ * 4. wrapper 检测 — mvnw/gradlew 存在性影响构建命令
+ */
+import fs from "node:fs";
+import path from "node:path";
+// ── 工具函数 ──
+/** 从 package.json 合并所有依赖 */
+export function getAllDeps(pkg) {
+    if (!pkg)
+        return {};
+    return { ...pkg.dependencies, ...pkg.devDependencies };
+}
+/** 从依赖版本字符串中提取主版本号 */
+export function extractMajorVersion(versionStr, fallback = "0") {
+    if (!versionStr)
+        return fallback;
+    const m = versionStr.match(/(\d+)/);
+    return m ? m[1] : fallback;
+}
+/** 安全读取文件内容 */
+export function readFileContent(filePath) {
+    try {
+        return fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+// ── 16 框架 Profile 数据表 ──
+export const FRAMEWORK_PROFILES = [
+    // ━━ 后端框架 ━━
+    {
+        name: "spring-boot",
+        lang: "java",
+        layer: "backend",
+        markers: [{
+                file: "pom.xml",
+                detect: (content) => content.includes("spring-boot-starter") || content.includes("org.springframework.boot"),
+                extractVersion: (content) => {
+                    // 从 parent 版本提取
+                    const m = content.match(/<spring-boot[^>]*version>\s*([^<]+)/s);
+                    if (m)
+                        return m[1];
+                    const parentM = content.match(/<version>\s*(\d+\.\d+\.\d+)\s*<\/version>/);
+                    return parentM ? parentM[1] : "3.x";
+                },
+            }],
+        defaultScope: ["src/main/java/", "src/test/java/", "src/main/resources/"],
+        defaultBuildCommands: { build: "mvn compile -q", test: "mvn test -q", full: "mvn verify -q" },
+        wrapperFile: "mvnw",
+        wrapperPrefix: "./mvnw",
+    },
+    {
+        name: "quarkus",
+        lang: "java",
+        layer: "backend",
+        markers: [{
+                file: "pom.xml",
+                detect: (content) => content.includes("quarkus") && content.includes("io.quarkus"),
+                extractVersion: (content) => {
+                    const m = content.match(/<quarkus\.platform\.version>\s*([^<]+)/s);
+                    return m ? m[1] : "3.x";
+                },
+            }],
+        defaultScope: ["src/main/java/", "src/test/java/", "src/main/resources/"],
+        defaultBuildCommands: { build: "mvn compile -q", test: "mvn test -q", full: "mvn verify -q" },
+        wrapperFile: "mvnw",
+        wrapperPrefix: "./mvnw",
+    },
+    {
+        name: "gradle-java",
+        lang: "java",
+        layer: "backend",
+        markers: [
+            {
+                file: "build.gradle",
+                detect: (content) => !content.includes("quarkus") && !content.includes("spring-boot"),
+                extractVersion: () => "8.x",
+            },
+            {
+                file: "build.gradle.kts",
+                detect: (content) => !content.includes("quarkus") && !content.includes("spring-boot"),
+                extractVersion: () => "8.x",
+            },
+        ],
+        defaultScope: ["src/main/java/", "src/test/java/"],
+        defaultBuildCommands: { build: "gradle compileJava", test: "gradle test", full: "gradle check" },
+        wrapperFile: "gradlew",
+        wrapperPrefix: "./gradlew",
+    },
+    {
+        name: "go",
+        lang: "go",
+        layer: "backend",
+        markers: [{
+                file: "go.mod",
+                detect: (content) => content.includes("module ") || content.startsWith("module"),
+                extractVersion: (content) => {
+                    const m = content.match(/go\s+(\d+\.\d+)/);
+                    return m ? m[1] : "1.22";
+                },
+            }],
+        defaultScope: ["."],
+        defaultBuildCommands: { build: "go build ./...", test: "go test ./...", full: "go test -race ./..." },
+    },
+    {
+        name: "rust",
+        lang: "rust",
+        layer: "backend",
+        markers: [{
+                file: "Cargo.toml",
+                detect: (content) => content.includes("[package]") || content.includes("[dependencies]"),
+                extractVersion: () => "1.x",
+            }],
+        defaultScope: ["src/"],
+        defaultBuildCommands: { build: "cargo build", test: "cargo test", full: "cargo test --all" },
+    },
+    {
+        name: "nestjs",
+        lang: "typescript",
+        layer: "backend",
+        markers: [{
+                file: "package.json",
+                detect: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return !!deps["@nestjs/core"];
+                },
+                extractVersion: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return extractMajorVersion(deps["@nestjs/core"], "10");
+                },
+            }],
+        defaultScope: ["src/"],
+        defaultBuildCommands: { build: "npm run build", test: "npm test", full: "npm run build && npm test" },
+    },
+    {
+        name: "express",
+        lang: "typescript",
+        layer: "backend",
+        markers: [{
+                file: "package.json",
+                detect: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return !!deps["express"] && !deps["@nestjs/core"];
+                },
+                extractVersion: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return extractMajorVersion(deps["express"], "4");
+                },
+            }],
+        defaultScope: ["src/", "routes/", "middleware/"],
+        defaultBuildCommands: { build: "npm run build", test: "npm test", full: "npm run build && npm test" },
+    },
+    {
+        name: "django",
+        lang: "python",
+        layer: "backend",
+        markers: [
+            {
+                file: "manage.py",
+                detect: (content) => content.includes("django"),
+                extractVersion: () => "5.x",
+            },
+            {
+                file: "requirements.txt",
+                detect: (content) => content.includes("django") || content.includes("Django"),
+                extractVersion: (content) => {
+                    const m = content.match(/[Dd]jango[=><]+(\d+\.\d+)/);
+                    return m ? m[1] : "5.x";
+                },
+            },
+        ],
+        defaultScope: ["."],
+        defaultBuildCommands: { build: "python manage.py check", test: "python manage.py test", full: "python manage.py test" },
+    },
+    // ━━ 前端框架 ━━
+    {
+        name: "react",
+        lang: "typescript",
+        layer: "frontend",
+        markers: [{
+                file: "package.json",
+                detect: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return !!deps["react"] && !deps["next"];
+                },
+                extractVersion: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return extractMajorVersion(deps["react"], "18");
+                },
+            }],
+        defaultScope: ["src/"],
+        defaultBuildCommands: { build: "npm run build", test: "npm test", full: "npm run build && npm test" },
+    },
+    {
+        name: "next",
+        lang: "typescript",
+        layer: "frontend",
+        markers: [{
+                file: "package.json",
+                detect: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return !!deps["next"];
+                },
+                extractVersion: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return extractMajorVersion(deps["next"], "14");
+                },
+            }],
+        defaultScope: ["src/", "app/", "pages/"],
+        defaultBuildCommands: { build: "npm run build", test: "npm test", full: "npm run build && npm test" },
+    },
+    {
+        name: "vue",
+        lang: "typescript",
+        layer: "frontend",
+        markers: [{
+                file: "package.json",
+                detect: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return !!deps["vue"] && !deps["nuxt"];
+                },
+                extractVersion: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return extractMajorVersion(deps["vue"], "3");
+                },
+            }],
+        defaultScope: ["src/"],
+        defaultBuildCommands: { build: "npm run build", test: "npm test", full: "npm run build && npm test" },
+    },
+    {
+        name: "nuxt",
+        lang: "typescript",
+        layer: "frontend",
+        markers: [{
+                file: "package.json",
+                detect: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return !!deps["nuxt"];
+                },
+                extractVersion: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return extractMajorVersion(deps["nuxt"], "3");
+                },
+            }],
+        defaultScope: ["pages/", "components/", "server/"],
+        defaultBuildCommands: { build: "npm run build", test: "npm test", full: "npm run build && npm test" },
+    },
+    {
+        name: "angular",
+        lang: "typescript",
+        layer: "frontend",
+        markers: [
+            {
+                file: "angular.json",
+                detect: () => true,
+                extractVersion: () => "17",
+            },
+            {
+                file: "package.json",
+                detect: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return !!deps["@angular/core"];
+                },
+                extractVersion: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return extractMajorVersion(deps["@angular/core"], "17");
+                },
+            },
+        ],
+        defaultScope: ["src/"],
+        defaultBuildCommands: { build: "npx ng build", test: "npx ng test", full: "npx ng build && npx ng test" },
+    },
+    {
+        name: "svelte",
+        lang: "typescript",
+        layer: "frontend",
+        markers: [{
+                file: "package.json",
+                detect: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return !!deps["svelte"];
+                },
+                extractVersion: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return extractMajorVersion(deps["svelte"], "5");
+                },
+            }],
+        defaultScope: ["src/"],
+        defaultBuildCommands: { build: "npm run build", test: "npm test", full: "npm run build && npm test" },
+    },
+    {
+        name: "solid",
+        lang: "typescript",
+        layer: "frontend",
+        markers: [{
+                file: "package.json",
+                detect: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return !!deps["solid-js"];
+                },
+                extractVersion: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return extractMajorVersion(deps["solid-js"], "1");
+                },
+            }],
+        defaultScope: ["src/"],
+        defaultBuildCommands: { build: "npm run build", test: "npm test", full: "npm run build && npm test" },
+    },
+    {
+        name: "astro",
+        lang: "typescript",
+        layer: "frontend",
+        markers: [{
+                file: "package.json",
+                detect: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return !!deps["astro"];
+                },
+                extractVersion: (_content, pkg) => {
+                    const deps = getAllDeps(pkg);
+                    return extractMajorVersion(deps["astro"], "4");
+                },
+            }],
+        defaultScope: ["src/", "pages/", "components/"],
+        defaultBuildCommands: { build: "npm run build", test: "npm test", full: "npm run build && npm test" },
+    },
+];
+/** 按层级获取 profile */
+export function getBackendProfiles() {
+    return FRAMEWORK_PROFILES.filter((p) => p.layer === "backend");
+}
+export function getFrontendProfiles() {
+    return FRAMEWORK_PROFILES.filter((p) => p.layer === "frontend");
+}
+/** 按名称查找 profile */
+export function getProfileByName(name) {
+    return FRAMEWORK_PROFILES.find((p) => p.name === name);
+}
+/**
+ * 对单个 profile 执行探测 — 检查标记文件是否存在且内容匹配。
+ * 返回匹配的标记信息，无匹配返回 null。
+ */
+export function detectProfile(profile, projectRoot, pkgJson) {
+    for (const marker of profile.markers) {
+        const filePath = path.join(projectRoot, marker.file);
+        // 对于 package.json 标记，使用传入的 pkgJson 数据
+        if (marker.file === "package.json") {
+            if (pkgJson && marker.detect("", pkgJson)) {
+                return {
+                    framework: profile.name,
+                    lang: profile.lang,
+                    version: marker.extractVersion("", pkgJson),
+                    detected_from: "package.json",
+                };
+            }
+            continue;
+        }
+        // 其他文件标记：读取文件内容并验证
+        const content = readFileContent(filePath);
+        if (content !== null && marker.detect(content)) {
+            return {
+                framework: profile.name,
+                lang: profile.lang,
+                version: marker.extractVersion(content),
+                detected_from: marker.file,
+            };
+        }
+    }
+    return null;
+}
+/**
+ * 获取框架的构建命令 — 考虑 wrapper 检测。
+ * 如果 wrapper 文件存在，使用 wrapperPrefix 替代默认命令前缀。
+ */
+export function resolveBuildCommands(profile, projectRoot) {
+    const cmds = { ...profile.defaultBuildCommands };
+    if (profile.wrapperFile && profile.wrapperPrefix) {
+        const wrapperPath = path.join(projectRoot, profile.wrapperFile);
+        if (fs.existsSync(wrapperPath)) {
+            // 将默认命令中的工具名替换为 wrapper 路径
+            const prefix = profile.wrapperPrefix;
+            const oldPrefix = cmds.build.split(" ")[0];
+            if (oldPrefix) {
+                cmds.build = cmds.build.replace(oldPrefix, prefix);
+                cmds.test = cmds.test.replace(oldPrefix, prefix);
+                cmds.full = cmds.full.replace(oldPrefix, prefix);
+            }
+        }
+    }
+    return cmds;
+}
+//# sourceMappingURL=framework_map.js.map

package/dist/engine/config/detector/framework_map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework_map.js","sourceRoot":"","sources":["../../../../src/engine/config/detector/framework_map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAgD7B,aAAa;AAEb,4BAA4B;AAC5B,MAAM,UAAU,UAAU,CAAC,GAAwB;IACjD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;AACzD,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,mBAAmB,CAAC,UAAmB,EAAE,QAAQ,GAAG,GAAG;IACrE,IAAI,CAAC,UAAU;QAAE,OAAO,QAAQ,CAAC;IACjC,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC7B,CAAC;AAED,eAAe;AACf,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,0BAA0B;AAE1B,MAAM,CAAC,MAAM,kBAAkB,GAAuB;IACpD,aAAa;IAEb;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC;gBAC5G,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE;oBAC1B,gBAAgB;oBAChB,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;oBAChE,IAAI,CAAC;wBAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;oBACnB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;oBAC3E,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;gBACtC,CAAC;aACF,CAAC;QACF,YAAY,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,qBAAqB,CAAC;QACzE,oBAAoB,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,EAAE;QAC7F,WAAW,EAAE,MAAM;QACnB,aAAa,EAAE,QAAQ;KACxB;IAED;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAClF,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE;oBAC1B,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;oBACnE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;gBAC1B,CAAC;aACF,CAAC;QACF,YAAY,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,qBAAqB,CAAC;QACzE,oBAAoB,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,EAAE;QAC7F,WAAW,EAAE,MAAM;QACnB,aAAa,EAAE,QAAQ;KACxB;IAED;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;gBACrF,cAAc,EAAE,GAAG,EAAE,CAAC,KAAK;aAC5B;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;gBACrF,cAAc,EAAE,GAAG,EAAE,CAAC,KAAK;aAC5B;SACF;QACD,YAAY,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;QAClD,oBAAoB,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,EAAE;QAChG,WAAW,EAAE,SAAS;QACtB,aAAa,EAAE,WAAW;KAC3B;IAED;QACE,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAChF,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE;oBAC1B,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;oBAC3C,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBAC3B,CAAC;aACF,CAAC;QACF,YAAY,EAAE,CAAC,GAAG,CAAC;QACnB,oBAAoB,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,qBAAqB,EAAE;KACtG;IAED;QACE,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,YAAY;gBAClB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBACxF,cAAc,EAAE,GAAG,EAAE,CAAC,KAAK;aAC5B,CAAC;QACF,YAAY,EAAE,CAAC,MAAM,CAAC;QACtB,oBAAoB,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB,EAAE;KAC7F;IAED;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBACxB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBAChC,CAAC;gBACD,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBAChC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,mBAAmB,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,CAAC;gBACzD,CAAC;aACF,CAAC;QACF,YAAY,EAAE,CAAC,MAAM,CAAC;QACtB,oBAAoB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,2BAA2B,EAAE;KACtG;IAED;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBACxB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBACpD,CAAC;gBACD,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBAChC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC;gBACnD,CAAC;aACF,CAAC;QACF,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC;QAChD,oBAAoB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,2BAA2B,EAAE;KACtG;IAED;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC/C,cAAc,EAAE,GAAG,EAAE,CAAC,KAAK;aAC5B;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC7E,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE;oBAC1B,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;oBACrD,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;gBAC1B,CAAC;aACF;SACF;QACD,YAAY,EAAE,CAAC,GAAG,CAAC;QACnB,oBAAoB,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,uBAAuB,EAAE;KACxH;IAED,aAAa;IAEb;QACE,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBACxB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC1C,CAAC;gBACD,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBAChC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;gBAClD,CAAC;aACF,CAAC;QACF,YAAY,EAAE,CAAC,MAAM,CAAC;QACtB,oBAAoB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,2BAA2B,EAAE;KACtG;IAED;QACE,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBACxB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACxB,CAAC;gBACD,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBAChC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;gBACjD,CAAC;aACF,CAAC;QACF,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;QACxC,oBAAoB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,2BAA2B,EAAE;KACtG;IAED;QACE,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBACxB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACxC,CAAC;gBACD,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBAChC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC/C,CAAC;aACF,CAAC;QACF,YAAY,EAAE,CAAC,MAAM,CAAC;QACtB,oBAAoB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,2BAA2B,EAAE;KACtG;IAED;QACE,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBACxB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACxB,CAAC;gBACD,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBAChC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;gBAChD,CAAC;aACF,CAAC;QACF,YAAY,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,CAAC;QAClD,oBAAoB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,2BAA2B,EAAE;KACtG;IAED;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI;gBAClB,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI;aAC3B;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBACxB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;gBACjC,CAAC;gBACD,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBAChC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,mBAAmB,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC,CAAC;gBAC1D,CAAC;aACF;SACF;QACD,YAAY,EAAE,CAAC,MAAM,CAAC;QACtB,oBAAoB,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,6BAA6B,EAAE;KAC1G;IAED;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBACxB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC1B,CAAC;gBACD,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBAChC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC;gBAClD,CAAC;aACF,CAAC;QACF,YAAY,EAAE,CAAC,MAAM,CAAC;QACtB,oBAAoB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,2BAA2B,EAAE;KACtG;IAED;QACE,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBACxB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC5B,CAAC;gBACD,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBAChC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;gBACpD,CAAC;aACF,CAAC;QACF,YAAY,EAAE,CAAC,MAAM,CAAC;QACtB,oBAAoB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,2BAA2B,EAAE;KACtG;IAED;QACE,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBACxB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACzB,CAAC;gBACD,cAAc,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;oBAChC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;gBACjD,CAAC;aACF,CAAC;QACF,YAAY,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC;QAC/C,oBAAoB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,2BAA2B,EAAE;KACtG;CACF,CAAC;AAEF,oBAAoB;AACpB,MAAM,UAAU,kBAAkB;IAChC,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC;AAClE,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAyB,EACzB,WAAmB,EACnB,OAA4B;IAE5B,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAErD,sCAAsC;QACtC,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACnC,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC1C,OAAO;oBACL,SAAS,EAAE,OAAO,CAAC,IAAI;oBACvB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC;oBAC3C,aAAa,EAAE,cAAc;iBAC9B,CAAC;YACJ,CAAC;YACD,SAAS;QACX,CAAC;QAED,mBAAmB;QACnB,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/C,OAAO;gBACL,SAAS,EAAE,OAAO,CAAC,IAAI;gBACvB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC;gBACvC,aAAa,EAAE,MAAM,CAAC,IAAI;aAC3B,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAyB,EACzB,WAAmB;IAEnB,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAEjD,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QACjD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAChE,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/B,2BAA2B;YAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;YACrC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBACnD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBACjD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/engine/config/detector/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 探测器公共接口 — 统一导出所有探测模块。
+ */
+export { detectFingerprint } from "./fingerprint.js";
+export type { Fingerprint, DetectedFramework, WorkspaceInfo, WorkspacePackage } from "./fingerprint.js";
+export { FRAMEWORK_PROFILES, getBackendProfiles, getFrontendProfiles, getProfileByName, detectProfile, resolveBuildCommands, getAllDeps, extractMajorVersion, } from "./framework_map.js";
+export type { FrameworkProfile, FrameworkMarker, PkgJsonData } from "./framework_map.js";
+export { verifyDetection } from "./verify.js";
+export type { VerificationResult, VerificationCheck } from "./verify.js";
+export { parseBlueprint } from "./blueprint.js";
+export type { BlueprintResult } from "./blueprint.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/config/detector/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/engine/config/detector/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGxG,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,UAAU,EACV,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGzF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/engine/config/detector/index.js

@@ -0,0 +1,12 @@
+/**
+ * 探测器公共接口 — 统一导出所有探测模块。
+ */
+// 核心探测
+export { detectFingerprint } from "./fingerprint.js";
+// 框架知识表
+export { FRAMEWORK_PROFILES, getBackendProfiles, getFrontendProfiles, getProfileByName, detectProfile, resolveBuildCommands, getAllDeps, extractMajorVersion, } from "./framework_map.js";
+// 探测验证
+export { verifyDetection } from "./verify.js";
+// Blueprint 解析
+export { parseBlueprint } from "./blueprint.js";
+//# sourceMappingURL=index.js.map

package/dist/engine/config/detector/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/engine/config/detector/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO;AACP,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,QAAQ;AACR,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,UAAU,EACV,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO;AACP,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/engine/config/detector/verify.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 探测验证 — 验证探测结果的准确性。
+ *
+ * 5 类验证项（设计文档 §5.5）：
+ * 1. 框架标记文件内容验证
+ * 2. 构建命令引用文件存在
+ * 3. scope 目录存在
+ * 4. wrapper 文件存在
+ * 5. package.json scripts 引用
+ */
+import type { Fingerprint } from "./fingerprint.js";
+/** 验证结果 */
+export interface VerificationResult {
+    /** 是否全部通过 */
+    passed: boolean;
+    /** 验证项列表 */
+    checks: VerificationCheck[];
+}
+/** 单项验证结果 */
+export interface VerificationCheck {
+    /** 验证项名称 */
+    name: string;
+    /** 是否通过 */
+    ok: boolean;
+    /** 失败原因 */
+    reason?: string;
+}
+/**
+ * 验证探测结果 — 不阻断启动，作为信号传递。
+ */
+export declare function verifyDetection(fp: Fingerprint): VerificationResult;
+//# sourceMappingURL=verify.d.ts.map

package/dist/engine/config/detector/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../../src/engine/config/detector/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,kBAAkB,CAAC;AAGvE,WAAW;AACX,MAAM,WAAW,kBAAkB;IACjC,aAAa;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY;IACZ,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED,aAAa;AACb,MAAM,WAAW,iBAAiB;IAChC,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,kBAAkB,CA4BnE"}

package/dist/engine/config/detector/verify.js

@@ -0,0 +1,107 @@
+/**
+ * 探测验证 — 验证探测结果的准确性。
+ *
+ * 5 类验证项（设计文档 §5.5）：
+ * 1. 框架标记文件内容验证
+ * 2. 构建命令引用文件存在
+ * 3. scope 目录存在
+ * 4. wrapper 文件存在
+ * 5. package.json scripts 引用
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { getProfileByName } from "./framework_map.js";
+/**
+ * 验证探测结果 — 不阻断启动，作为信号传递。
+ */
+export function verifyDetection(fp) {
+    const checks = [];
+    // 1. 验证后端框架标记
+    if (fp.backend) {
+        checks.push(...verifyFramework(fp.backend, fp.project_root));
+    }
+    // 2. 验证前端框架标记
+    if (fp.frontend) {
+        checks.push(...verifyFramework(fp.frontend, fp.project_root));
+    }
+    // 3. 验证 wrapper 存在性
+    if (fp.backend) {
+        checks.push(...verifyWrapper(fp.backend, fp.project_root));
+    }
+    // 4. 验证 scope 目录存在性
+    checks.push(...verifyScopeDirectories(fp));
+    // 5. 验证 pkg_scripts 引用的命令可用
+    checks.push(...verifyPkgScripts(fp));
+    return {
+        passed: checks.every((c) => c.ok),
+        checks,
+    };
+}
+function verifyFramework(fw, projectRoot) {
+    const checks = [];
+    const profile = getProfileByName(fw.framework);
+    if (!profile) {
+        checks.push({ name: `${fw.framework} profile`, ok: false, reason: `未找到框架 profile: ${fw.framework}` });
+        return checks;
+    }
+    for (const marker of profile.markers) {
+        if (marker.file === "package.json")
+            continue; // 已在探测时验证
+        const filePath = path.join(projectRoot, marker.file);
+        if (fs.existsSync(filePath)) {
+            checks.push({ name: `${fw.framework} 标记文件 ${marker.file}`, ok: true });
+        }
+        else {
+            checks.push({ name: `${fw.framework} 标记文件 ${marker.file}`, ok: false, reason: `${marker.file} 不存在` });
+        }
+    }
+    return checks;
+}
+function verifyWrapper(fw, projectRoot) {
+    const profile = getProfileByName(fw.framework);
+    if (!profile?.wrapperFile)
+        return [];
+    const wrapperPath = path.join(projectRoot, profile.wrapperFile);
+    const exists = fs.existsSync(wrapperPath);
+    return [{
+            name: `${fw.framework} wrapper ${profile.wrapperFile}`,
+            ok: exists,
+            reason: exists ? undefined : `${profile.wrapperFile} 不存在，将使用全局命令`,
+        }];
+}
+function verifyScopeDirectories(fp) {
+    const checks = [];
+    for (const fw of [fp.backend, fp.frontend]) {
+        if (!fw)
+            continue;
+        const profile = getProfileByName(fw.framework);
+        if (!profile)
+            continue;
+        for (const scopeDir of profile.defaultScope) {
+            // "." 表示当前目录，不需要检查
+            if (scopeDir === ".")
+                continue;
+            const dirPath = path.join(fp.project_root, scopeDir);
+            const exists = fs.existsSync(dirPath);
+            checks.push({
+                name: `${fw.framework} scope 目录 ${scopeDir}`,
+                ok: exists,
+                reason: exists ? undefined : `scope 目录 ${scopeDir} 不存在`,
+            });
+        }
+    }
+    return checks;
+}
+function verifyPkgScripts(fp) {
+    const checks = [];
+    const scripts = fp.pkg_scripts;
+    // 检查常用 scripts 是否存在
+    const expectedScripts = ["build", "test"];
+    for (const scriptName of expectedScripts) {
+        if (scripts[scriptName]) {
+            checks.push({ name: `pkg_scripts.${scriptName}`, ok: true });
+        }
+    }
+    return checks;
+}
+//# sourceMappingURL=verify.js.map

package/dist/engine/config/detector/verify.js.map

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

package/dist/engine/config/intent.d.ts

@@ -0,0 +1,26 @@
+/**
+ * intent.yaml 读写 — 项目意图声明的加载与持久化。
+ *
+ * loadIntent: 宽松读取，文件不存在返回 {}，语法错误不阻断。
+ * saveIntent: 严格校验后写入，自动添加文件头注释。
+ */
+import { type StrictIntent, type LenientIntent } from "./intent_schema.js";
+/**
+ * 加载 intent.yaml — 宽松模式。
+ *
+ * - 文件不存在 → 返回 `{}`（纯探测模式）
+ * - YAML 语法错误 → warning 日志，返回 `{}`
+ * - 字段值不合法 → warning 日志，该字段 fallback
+ */
+export declare function loadIntent(projectRoot: string): Promise<LenientIntent>;
+/**
+ * 保存 intent.yaml — 严格模式。
+ *
+ * - 数据必须通过 StrictIntentSchema 校验
+ * - 自动添加文件头注释
+ * - 原子写入（先写临时文件再 rename）
+ *
+ * @throws 校验失败时抛出 Error，包含详细校验错误信息
+ */
+export declare function saveIntent(projectRoot: string, data: StrictIntent): Promise<void>;
+//# sourceMappingURL=intent.d.ts.map

package/dist/engine/config/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../src/engine/config/intent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAW5B;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA0B5E;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBvF"}