@wowok/agent-mcp 2.3.14 → 2.3.16

package/dist/knowledge/industry-generalizer.js

@@ -0,0 +1,381 @@
+import { getIndustryProfile, listIndustries, registerIndustry, } from "./industry-registry.js";
+const TRAIT_INFERENCE_RULES = [
+    { keywords: ["物流", "发货", "配送", "快递", "送货", "delivery", "shipping", "logistics", "ship"],
+        trait: "has_logistics", value: true, weight: 0.85 },
+    { keywords: ["数字", "在线", "云端", "线上", "digital", "online", "cloud"],
+        trait: "has_logistics", value: false, weight: 0.7 },
+    { keywords: ["咨询", "沟通", "需求确认", "修改轮次", "consult", "communication", "negotiate"],
+        trait: "communication_heavy", value: true, weight: 0.8 },
+    { keywords: ["标准品", "现货", "一键下单", "standard", "instant"],
+        trait: "communication_heavy", value: false, weight: 0.7 },
+    { keywords: ["数字", "文件", "代码", "设计稿", "电子", "在线", "digital", "file", "online"],
+        trait: "pure_digital", value: true, weight: 0.8 },
+    { keywords: ["实物", "硬件", "设备", "physical", "hardware", "equipment"],
+        trait: "pure_digital", value: false, weight: 0.75 },
+    { keywords: ["课程", "学期", "周期长", "长期", "项目制", "course", "semester", "long-term", "project"],
+        trait: "long_cycle", value: true, weight: 0.75 },
+    { keywords: ["即时", "现货", "当天", "instant", "same-day", "immediate"],
+        trait: "long_cycle", value: false, weight: 0.8 },
+    { keywords: ["租赁", "租用", "押金", "rental", "rent", "deposit", "lease"],
+        trait: "deposit_required", value: true, weight: 0.9 },
+    { keywords: ["购买", "买断", "purchase", "buy"],
+        trait: "deposit_required", value: false, weight: 0.6 },
+    { keywords: ["多方", "分段", "多阶段", "多商家", "行程", "multi-party", "segment", "multi-vendor"],
+        trait: "multi_tier_allocation", value: true, weight: 0.75 },
+    { keywords: ["医疗", "法律", "金融", "保险", "药品", "medical", "legal", "finance", "insurance", "pharma"],
+        trait: "regulatory_intensity", value: "high", weight: 0.9 },
+    { keywords: ["教育", "食品", "建筑", "education", "food", "construction"],
+        trait: "regulatory_intensity", value: "medium", weight: 0.7 },
+    { keywords: ["娱乐", "游戏", "数字", "entertainment", "game", "digital"],
+        trait: "regulatory_intensity", value: "low", weight: 0.6 },
+    { keywords: ["定制", "高价值", "定制化", "custom", "high-value", "bespoke"],
+        trait: "trust_sensitivity", value: "high", weight: 0.8 },
+    { keywords: ["标准品", "小额", "standard", "low-value"],
+        trait: "trust_sensitivity", value: "low", weight: 0.7 },
+    { keywords: ["订阅", "会员", "周期性", "subscription", "membership", "recurring"],
+        trait: "consumption_frequency", value: "frequent", weight: 0.85 },
+    { keywords: ["课程", "学期", "教育", "course", "education"],
+        trait: "consumption_frequency", value: "one_time", weight: 0.75 },
+    { keywords: ["日常", "频繁", "常用", "daily", "frequent"],
+        trait: "consumption_frequency", value: "frequent", weight: 0.75 },
+    { keywords: ["小额", "日常", "便利店", "micro", "small-ticket"],
+        trait: "avg_ticket_size", value: "micro", weight: 0.7 },
+    { keywords: ["零售", "商品", "标准品", "retail", "commodity"],
+        trait: "avg_ticket_size", value: "small", weight: 0.7 },
+    { keywords: ["定制", "项目", "外包", "custom", "project"],
+        trait: "avg_ticket_size", value: "medium", weight: 0.7 },
+    { keywords: ["房产", "汽车", "高价值", "奢侈品", "realestate", "luxury", "car"],
+        trait: "avg_ticket_size", value: "large", weight: 0.85 },
+];
+export const DEFAULT_TRAITS = {
+    has_logistics: false,
+    communication_heavy: false,
+    pure_digital: false,
+    long_cycle: false,
+    deposit_required: false,
+    multi_tier_allocation: false,
+    regulatory_intensity: "low",
+    trust_sensitivity: "medium",
+    consumption_frequency: "occasional",
+    avg_ticket_size: "small",
+};
+export function inferTraitsFromDescription(description) {
+    const text = (description ?? "").toLowerCase();
+    const matched = [];
+    const traitConfidence = new Map();
+    const traitValue = new Map();
+    for (const rule of TRAIT_INFERENCE_RULES) {
+        const hit = rule.keywords.find((k) => text.includes(k.toLowerCase()));
+        if (hit) {
+            matched.push(hit);
+            const prev = traitConfidence.get(rule.trait) ?? 0;
+            if (rule.weight > prev) {
+                traitConfidence.set(rule.trait, rule.weight);
+                traitValue.set(rule.trait, rule.value);
+            }
+        }
+    }
+    const traits = { ...DEFAULT_TRAITS };
+    for (const [k, v] of traitValue.entries()) {
+        traits[k] = v;
+    }
+    const hitCount = traitConfidence.size;
+    const confidence = Math.min(1, hitCount / 10);
+    return {
+        traits,
+        confidence,
+        matched_keywords: Array.from(new Set(matched)),
+        trait_confidence: Object.fromEntries(traitConfidence),
+    };
+}
+export function findSimilarIndustries(traits, limit) {
+    const all = listIndustries({ source: "builtin" });
+    const results = [];
+    for (const profile of all) {
+        const other = profile.traits;
+        let score = 0;
+        const matched = [];
+        const booleanKeys = [
+            "has_logistics", "communication_heavy", "pure_digital",
+            "long_cycle", "deposit_required", "multi_tier_allocation",
+        ];
+        for (const k of booleanKeys) {
+            if (traits[k] === other[k]) {
+                score += 1;
+                matched.push(k);
+            }
+        }
+        const enumKeys = [
+            "regulatory_intensity", "trust_sensitivity",
+            "consumption_frequency", "avg_ticket_size",
+        ];
+        for (const k of enumKeys) {
+            if (traits[k] === other[k]) {
+                score += 1;
+                matched.push(k);
+            }
+        }
+        results.push({
+            industry: profile.name,
+            similarity: score / 10,
+            matched_traits: matched,
+        });
+    }
+    results.sort((a, b) => b.similarity - a.similarity);
+    return typeof limit === "number" ? results.slice(0, Math.max(0, limit)) : results;
+}
+const FALLBACK_RISK_CHECK_RULES = [
+    {
+        trait_key: "deposit_required", trait_value: true,
+        check: {
+            id: "fb_deposit_lock", description: "押金锁定期安全（押金不可被商家随时撤回）",
+            weight: 30,
+            passed: (p) => p?.fund_safety?.lock_duration_safe ?? false,
+            advice: "⚠️ 锁定期不安全：押金可能被随时撤回，建议要求锁定期 ≥ 7 天。",
+        },
+        need: {
+            id: "need_deposit_lock", tier: "personalized",
+            description: "押金锁定期安全",
+            satisfied: (p) => p?.fund_safety?.lock_duration_safe ?? false,
+            advice: "押金锁定期不安全。",
+        },
+    },
+    {
+        trait_key: "has_logistics", trait_value: true,
+        check: {
+            id: "fb_logistics_track", description: "物流 Guard 配置（发货/收货验证）",
+            weight: 25,
+            passed: (p) => p?.workflow_analysis?.has_milestone_nodes ?? false,
+            advice: "⚠️ 无物流 Guard：发货与收货状态无第三方验证。",
+        },
+    },
+    {
+        trait_key: "pure_digital", trait_value: true,
+        check: {
+            id: "fb_wip_verified", description: "WIP hash 验证（数字交付物可溯源）",
+            weight: 25,
+            passed: (p) => p?.service_basics?.wip_verified === true,
+            advice: "⚠️ WIP 未验证：数字交付物无法溯源。",
+        },
+    },
+    {
+        trait_key: "long_cycle", trait_value: true,
+        check: {
+            id: "fb_milestone", description: "里程碑节点（分阶段验收）",
+            weight: 25,
+            passed: (p) => p?.workflow_analysis?.has_milestone_nodes ?? false,
+            advice: "⚠️ 无里程碑节点：长周期项目缺少分阶段验收。",
+        },
+    },
+    {
+        trait_key: "regulatory_intensity", trait_value: "high",
+        check: {
+            id: "fb_compliance", description: "合规配置（仲裁 + 赔偿金）",
+            weight: 30,
+            passed: (p) => (p?.workflow_analysis?.has_arbitration_path ?? false) &&
+                (p?.service_basics?.compensation_fund_balance ?? 0n) > 0n,
+            advice: "🔴 合规要求未满足：高监管行业必须配置仲裁与赔偿金。",
+        },
+    },
+    {
+        trait_key: "multi_tier_allocation", trait_value: true,
+        check: {
+            id: "fb_multi_tier_fair", description: "多层分账公平性（每个 segment 有对应 Allocator）",
+            weight: 20,
+            passed: (p) => (p?.workflow_analysis?.total_nodes ?? 0) >= 3,
+            advice: "⚠️ 多层分账需配置对应节点与 Allocator，否则资金分配不透明。",
+        },
+    },
+];
+function buildFallbackFlywheel(name, traits) {
+    const sellingPoints = ["资金托管 + 流程透明"];
+    if (traits.deposit_required)
+        sellingPoints.push("押金托管 + 锁定期保障");
+    if (traits.has_logistics)
+        sellingPoints.push("物流 Guard 验证");
+    if (traits.pure_digital)
+        sellingPoints.push("WIP 数字交付物溯源");
+    if (traits.regulatory_intensity === "high")
+        sellingPoints.push("合规仲裁 + 赔偿金保障");
+    const keyActions = [
+        { action: "设置首单 Reward", purpose: "吸引新客户", mutableField: "rewards", metricToWatch: "新客下单率" },
+        { action: "配置 compensation_fund", purpose: "提升信任分", mutableField: "compensation_fund", metricToWatch: "信任分" },
+    ];
+    if (traits.long_cycle) {
+        keyActions.push({ action: "里程碑 Reward", purpose: "激励完成长周期项目", mutableField: "rewards", metricToWatch: "完单率" });
+    }
+    if (traits.consumption_frequency === "frequent") {
+        keyActions.push({ action: "忠诚度 Reward", purpose: "提升复购", mutableField: "rewards", metricToWatch: "复购率" });
+    }
+    return {
+        industry: name,
+        trustSellingPoints: sellingPoints,
+        keyActions,
+        rewardStrategy: "首单奖励 + 推荐返现" + (traits.consumption_frequency === "frequent" ? " + 忠诚度奖励" : ""),
+        discountStrategy: traits.long_cycle ? "长期合作折扣 + 阶梯优惠" : "首单折扣 + 满减",
+        trustDescription: sellingPoints.join(" + "),
+    };
+}
+function buildFallbackPreferenceTemplate(traits) {
+    return {
+        max_acceptable_cycle: traits.long_cycle ? 90 : 14,
+        response_time_expectation: traits.communication_heavy ? 4 : 12,
+        require_arbitration: traits.regulatory_intensity !== "low" || traits.trust_sensitivity === "high",
+        require_compensation_fund: traits.trust_sensitivity === "high" || traits.deposit_required,
+        risk_appetite: traits.trust_sensitivity === "high" ? "conservative" : "balanced",
+        delivery_speed_priority: traits.has_logistics && traits.consumption_frequency === "frequent" ? "urgent" : "normal",
+        after_sales_expectation: traits.trust_sensitivity === "high" ? "full" : "basic",
+    };
+}
+export function synthesizeProfile(traits, name) {
+    const similar = findSimilarIndustries(traits, 1);
+    const bestMatch = similar[0];
+    const reuseBasis = bestMatch && bestMatch.similarity >= 0.6
+        ? getIndustryProfile(bestMatch.industry)
+        : undefined;
+    const industryName = name ?? `custom_${Date.now().toString(36)}`;
+    const displayName = name ?? `自定义行业`;
+    const flywheel = reuseBasis
+        ? { ...reuseBasis.flywheel, industry: industryName }
+        : buildFallbackFlywheel(industryName, traits);
+    const preferenceTemplate = reuseBasis
+        ? {
+            ...reuseBasis.preference_template,
+            max_acceptable_cycle: traits.long_cycle
+                ? Math.max(reuseBasis.preference_template.max_acceptable_cycle, 90)
+                : reuseBasis.preference_template.max_acceptable_cycle,
+            require_compensation_fund: traits.trust_sensitivity === "high"
+                ? true
+                : reuseBasis.preference_template.require_compensation_fund,
+        }
+        : buildFallbackPreferenceTemplate(traits);
+    const riskChecks = [];
+    const needs = [];
+    for (const rule of FALLBACK_RISK_CHECK_RULES) {
+        if (traits[rule.trait_key] === rule.trait_value) {
+            riskChecks.push({ ...rule.check, industry: industryName });
+            if (rule.need) {
+                needs.push({ ...rule.need });
+            }
+        }
+    }
+    if (riskChecks.length === 0) {
+        riskChecks.push({
+            id: "fb_basic_arbitration",
+            industry: industryName,
+            description: "配置仲裁（基础纠纷解决）",
+            weight: 100,
+            passed: (p) => p?.workflow_analysis?.has_arbitration_path ?? false,
+            advice: "⚠️ 未配置仲裁：基础纠纷无解决通道。",
+        });
+    }
+    return {
+        name: industryName,
+        display_name: displayName,
+        traits,
+        source: "inferred",
+        version: "v1",
+        flywheel,
+        risk_checks: riskChecks,
+        preference_template: preferenceTemplate,
+        needs,
+        confidence: bestMatch?.similarity ?? 0.3,
+        evolution: {
+            version: 1,
+            last_updated: Date.now(),
+            signal_count: 0,
+            pending_suggestions: 0,
+        },
+    };
+}
+export function composeIndustries(names, newName) {
+    if (!names || names.length === 0)
+        return undefined;
+    const profiles = [];
+    for (const n of names) {
+        const p = getIndustryProfile(n);
+        if (!p)
+            return undefined;
+        profiles.push(p);
+    }
+    const composedTraits = {
+        has_logistics: profiles.some((p) => p.traits.has_logistics),
+        communication_heavy: profiles.some((p) => p.traits.communication_heavy),
+        pure_digital: profiles.every((p) => p.traits.pure_digital),
+        long_cycle: profiles.some((p) => p.traits.long_cycle),
+        deposit_required: profiles.some((p) => p.traits.deposit_required),
+        multi_tier_allocation: profiles.some((p) => p.traits.multi_tier_allocation),
+        regulatory_intensity: pickStrictest(profiles.map((p) => p.traits.regulatory_intensity), ["low", "medium", "high"]),
+        trust_sensitivity: pickStrictest(profiles.map((p) => p.traits.trust_sensitivity), ["low", "medium", "high"]),
+        consumption_frequency: pickStrictest(profiles.map((p) => p.traits.consumption_frequency), ["one_time", "occasional", "frequent"]),
+        avg_ticket_size: pickStrictest(profiles.map((p) => p.traits.avg_ticket_size), ["micro", "small", "medium", "large"]),
+    };
+    const newNameResolved = newName ?? `composed_${names.join("_and_")}`;
+    const sellingPoints = Array.from(new Set(profiles.flatMap((p) => p.flywheel.trustSellingPoints)));
+    const keyActions = Array.from(new Set(profiles.flatMap((p) => p.flywheel.keyActions)));
+    const flywheel = {
+        industry: newNameResolved,
+        trustSellingPoints: sellingPoints,
+        keyActions,
+        rewardStrategy: profiles.map((p) => p.flywheel.rewardStrategy).join(" + "),
+        discountStrategy: profiles.map((p) => p.flywheel.discountStrategy).join(" + "),
+        trustDescription: profiles.map((p) => p.flywheel.trustDescription).join(" + "),
+    };
+    const riskCheckMap = new Map();
+    for (const p of profiles) {
+        for (const c of p.risk_checks) {
+            if (!riskCheckMap.has(c.id)) {
+                riskCheckMap.set(c.id, { ...c, industry: newNameResolved });
+            }
+        }
+    }
+    const needMap = new Map();
+    for (const p of profiles) {
+        for (const n of p.needs) {
+            if (!needMap.has(n.id)) {
+                needMap.set(n.id, { ...n });
+            }
+        }
+    }
+    const prefTpl = {
+        max_acceptable_cycle: Math.max(...profiles.map((p) => p.preference_template.max_acceptable_cycle)),
+        response_time_expectation: Math.min(...profiles.map((p) => p.preference_template.response_time_expectation)),
+        require_arbitration: profiles.some((p) => p.preference_template.require_arbitration),
+        require_compensation_fund: profiles.some((p) => p.preference_template.require_compensation_fund),
+        risk_appetite: pickStrictest(profiles.map((p) => p.preference_template.risk_appetite), ["aggressive", "balanced", "conservative"]),
+        delivery_speed_priority: pickStrictest(profiles.map((p) => p.preference_template.delivery_speed_priority), ["flexible", "normal", "urgent"]),
+        after_sales_expectation: pickStrictest(profiles.map((p) => p.preference_template.after_sales_expectation), ["minimal", "basic", "full"]),
+    };
+    const composed = {
+        name: newNameResolved,
+        display_name: newName ?? `组合行业(${names.join("+")})`,
+        traits: composedTraits,
+        source: "composed",
+        version: "v1",
+        flywheel,
+        risk_checks: Array.from(riskCheckMap.values()),
+        preference_template: prefTpl,
+        needs: Array.from(needMap.values()),
+        parent_industries: [...names],
+        evolution: {
+            version: 1,
+            last_updated: Date.now(),
+            signal_count: 0,
+            pending_suggestions: 0,
+        },
+    };
+    registerIndustry(composed);
+    return composed;
+}
+function pickStrictest(values, strictness) {
+    let maxIdx = 0;
+    let result = values[0] ?? strictness[0];
+    for (const v of values) {
+        const idx = strictness.indexOf(v);
+        if (idx >= 0 && idx > maxIdx) {
+            maxIdx = idx;
+            result = v;
+        }
+    }
+    return result;
+}

package/dist/knowledge/industry-registry.d.ts

@@ -0,0 +1,49 @@
+import type { AcquisitionFlywheel } from "./acquisition-flywheel.js";
+import type { IndustryRiskCheck, IndustryNeed } from "../customer/industry-risks.js";
+import type { IndustryTemplate } from "../customer/user-preferences.js";
+export interface IndustryTraits {
+    has_logistics: boolean;
+    communication_heavy: boolean;
+    pure_digital: boolean;
+    long_cycle: boolean;
+    deposit_required: boolean;
+    multi_tier_allocation: boolean;
+    regulatory_intensity: "low" | "medium" | "high";
+    trust_sensitivity: "low" | "medium" | "high";
+    consumption_frequency: "one_time" | "occasional" | "frequent";
+    avg_ticket_size: "micro" | "small" | "medium" | "large";
+}
+export type IndustrySource = "builtin" | "inferred" | "composed" | "custom";
+export interface IndustryEvolutionMeta {
+    version: number;
+    last_updated: number;
+    signal_count: number;
+    pending_suggestions: number;
+    last_health_score?: number;
+}
+export interface IndustryProfile {
+    name: string;
+    display_name: string;
+    traits: IndustryTraits;
+    source: IndustrySource;
+    version: string;
+    flywheel: AcquisitionFlywheel;
+    risk_checks: IndustryRiskCheck[];
+    preference_template: IndustryTemplate;
+    needs: IndustryNeed[];
+    evolution?: IndustryEvolutionMeta;
+    confidence?: number;
+    parent_industries?: string[];
+}
+export type ExtendedIndustry = "freelance" | "rental" | "education" | "travel" | "subscription" | "retail" | "general" | "custom";
+export declare const INDUSTRY_REGISTRY_VERSION = 1;
+export declare function getIndustryProfile(name: string): IndustryProfile | undefined;
+export declare function listIndustries(filter?: {
+    source?: IndustrySource;
+}): IndustryProfile[];
+export declare function registerIndustry(profile: IndustryProfile): boolean;
+export declare function getIndustryTraits(name: string): IndustryTraits | undefined;
+export declare function resolveIndustryName(alias: string): string | undefined;
+export declare function getRegistrySize(): number;
+export declare function _resetRegistryForTest(): void;
+export declare function listBuiltinIndustryNames(): string[];

package/dist/knowledge/industry-registry.js

@@ -0,0 +1,167 @@
+import { getFlywheelForIndustry, listIndustries as listFlywheelIndustries } from "./acquisition-flywheel.js";
+import { getIndustryRiskChecks, getIndustryNeeds } from "../customer/industry-risks.js";
+import { getIndustryTemplate, SUPPORTED_INDUSTRIES } from "../customer/user-preferences.js";
+const BUILTIN_TRAITS = {
+    freelance: {
+        has_logistics: false, communication_heavy: true, pure_digital: true,
+        long_cycle: false, deposit_required: false, multi_tier_allocation: false,
+        regulatory_intensity: "low", trust_sensitivity: "high",
+        consumption_frequency: "occasional", avg_ticket_size: "medium",
+    },
+    rental: {
+        has_logistics: true, communication_heavy: false, pure_digital: false,
+        long_cycle: false, deposit_required: true, multi_tier_allocation: false,
+        regulatory_intensity: "low", trust_sensitivity: "high",
+        consumption_frequency: "occasional", avg_ticket_size: "medium",
+    },
+    education: {
+        has_logistics: false, communication_heavy: true, pure_digital: false,
+        long_cycle: true, deposit_required: false, multi_tier_allocation: false,
+        regulatory_intensity: "medium", trust_sensitivity: "high",
+        consumption_frequency: "one_time", avg_ticket_size: "large",
+    },
+    travel: {
+        has_logistics: true, communication_heavy: true, pure_digital: false,
+        long_cycle: false, deposit_required: false, multi_tier_allocation: true,
+        regulatory_intensity: "medium", trust_sensitivity: "high",
+        consumption_frequency: "one_time", avg_ticket_size: "large",
+    },
+    subscription: {
+        has_logistics: false, communication_heavy: false, pure_digital: true,
+        long_cycle: false, deposit_required: false, multi_tier_allocation: false,
+        regulatory_intensity: "low", trust_sensitivity: "medium",
+        consumption_frequency: "frequent", avg_ticket_size: "small",
+    },
+    retail: {
+        has_logistics: true, communication_heavy: false, pure_digital: false,
+        long_cycle: false, deposit_required: false, multi_tier_allocation: false,
+        regulatory_intensity: "low", trust_sensitivity: "medium",
+        consumption_frequency: "frequent", avg_ticket_size: "small",
+    },
+};
+const BUILTIN_DISPLAY_NAMES = {
+    freelance: "自由职业",
+    rental: "租赁",
+    education: "教育",
+    travel: "旅行",
+    subscription: "订阅",
+    retail: "零售",
+    general: "通用",
+    custom: "自定义",
+};
+const INDUSTRY_ALIASES = {
+    "自由职业": "freelance",
+    "外包": "freelance",
+    "设计": "freelance",
+    "开发": "freelance",
+    "咨询": "freelance",
+    "租赁": "rental",
+    "租用": "rental",
+    "出租": "rental",
+    "教育": "education",
+    "课程": "education",
+    "培训": "education",
+    "旅行": "travel",
+    "旅游": "travel",
+    "行程": "travel",
+    "订阅": "subscription",
+    "会员": "subscription",
+    "零售": "retail",
+    "电商": "retail",
+    "商品": "retail",
+    "通用": "general",
+    "自定义": "custom",
+    "freelancer": "freelance",
+    "gig": "freelance",
+    "rent": "rental",
+    "lease": "rental",
+    "course": "education",
+    "edu": "education",
+    "trip": "travel",
+    "tour": "travel",
+    "subscribe": "subscription",
+    "membership": "subscription",
+    "shop": "retail",
+    "ecommerce": "retail",
+    "general_industry": "general",
+};
+export const INDUSTRY_REGISTRY_VERSION = 1;
+const registry = new Map();
+function seedBuiltinProfile(name) {
+    const traits = BUILTIN_TRAITS[name];
+    if (!traits)
+        return undefined;
+    const flywheel = getFlywheelForIndustry(name);
+    if (!flywheel)
+        return undefined;
+    const riskChecks = getIndustryRiskChecks(name);
+    const needs = getIndustryNeeds(name);
+    const preferenceTemplate = getIndustryTemplate(name);
+    return {
+        name,
+        display_name: BUILTIN_DISPLAY_NAMES[name] ?? name,
+        traits,
+        source: "builtin",
+        version: "v1",
+        flywheel,
+        risk_checks: riskChecks,
+        preference_template: preferenceTemplate,
+        needs,
+    };
+}
+function seedBuiltinIndustries() {
+    for (const name of SUPPORTED_INDUSTRIES) {
+        const profile = seedBuiltinProfile(name);
+        if (profile) {
+            registry.set(name, profile);
+        }
+    }
+}
+seedBuiltinIndustries();
+export function getIndustryProfile(name) {
+    const p = registry.get(name);
+    return p ? JSON.parse(JSON.stringify(p)) : undefined;
+}
+export function listIndustries(filter) {
+    const all = Array.from(registry.values());
+    if (filter?.source) {
+        return all.filter((p) => p.source === filter.source);
+    }
+    return all;
+}
+export function registerIndustry(profile) {
+    if (!profile.name || !profile.traits || !profile.flywheel)
+        return false;
+    registry.set(profile.name, profile);
+    return true;
+}
+export function getIndustryTraits(name) {
+    return registry.get(name)?.traits;
+}
+export function resolveIndustryName(alias) {
+    if (!alias || typeof alias !== "string")
+        return undefined;
+    const trimmed = alias.trim();
+    if (!trimmed)
+        return undefined;
+    const lower = trimmed.toLowerCase();
+    if (INDUSTRY_ALIASES[trimmed])
+        return INDUSTRY_ALIASES[trimmed];
+    if (INDUSTRY_ALIASES[lower])
+        return INDUSTRY_ALIASES[lower];
+    if (registry.has(trimmed))
+        return trimmed;
+    if (registry.has(lower))
+        return lower;
+    return undefined;
+}
+export function getRegistrySize() {
+    return registry.size;
+}
+export function _resetRegistryForTest() {
+    registry.clear();
+    seedBuiltinIndustries();
+}
+export function listBuiltinIndustryNames() {
+    return listFlywheelIndustries();
+}

package/dist/knowledge/intent-metrics.d.ts

@@ -0,0 +1,42 @@
+import type { IndustryMetrics, IndustryHealthReport, IndustryUpdateSuggestion } from "./industry-evolution.js";
+export type BusinessIntent = "default" | "growth" | "retention" | "compliance" | "efficiency" | "trust_building" | "custom";
+export type MetricDimension = "completed_rate" | "dispute_rate" | "refund_rate" | "repeat_buyer_rate" | "cycle_efficiency" | "arbitration_coverage" | "compensation_coverage" | "milestone_adoption" | "review_openness";
+export interface IntentMetricSpec {
+    intent: BusinessIntent;
+    display_name: string;
+    weights: Partial<Record<MetricDimension, number>>;
+    healthy_thresholds: Partial<Record<MetricDimension, number>>;
+    suggestion_triggers: IntentSuggestionTrigger[];
+    level_thresholds?: {
+        thriving?: number;
+        healthy?: number;
+        stressed?: number;
+    };
+    role_advice_routing?: Record<"user" | "merchant" | "arbitrator", string[]>;
+}
+export interface IntentSuggestionTrigger {
+    metric: MetricDimension;
+    operator: ">=" | "<=" | ">" | "<" | "==";
+    threshold: number;
+    suggestion_type: IndustryUpdateSuggestion["suggestion_type"];
+    field: string;
+    suggested_value: unknown;
+    evidence_template: string;
+    confidence: number;
+    priority: IndustryUpdateSuggestion["priority"];
+    target_roles?: Array<"user" | "merchant" | "arbitrator">;
+}
+export declare const BUILTIN_INTENT_SPECS: Record<BusinessIntent, IntentMetricSpec>;
+export declare function registerIntentProfile(spec: IntentMetricSpec): boolean;
+export declare function getIntentProfile(intent: BusinessIntent): IntentMetricSpec | undefined;
+export declare function listIntents(): BusinessIntent[];
+export declare function _resetIntentRegistryForTest(): void;
+export declare function evaluateIndustryHealthByIntent(industry: string, metrics: IndustryMetrics, intent?: BusinessIntent): IndustryHealthReport;
+export declare function suggestIndustryUpdateByIntent(industry: string, metrics: IndustryMetrics, intent?: BusinessIntent): IndustryUpdateSuggestion[];
+export declare function evaluateIndustryHealthMultiIntent(industry: string, metrics: IndustryMetrics, intents: Array<{
+    intent: BusinessIntent;
+    weight: number;
+}>): IndustryHealthReport;
+export type AdviceRole = "user" | "merchant" | "arbitrator";
+export declare function getRoleAdvice(intent: BusinessIntent, role: AdviceRole): string[];
+export declare function filterSuggestionsByRole(suggestions: IndustryUpdateSuggestion[], role: AdviceRole, triggers?: IntentSuggestionTrigger[]): IndustryUpdateSuggestion[];