@wowok/agent-mcp 2.6.1 → 2.6.4

package/dist/extensions/metric-registry.js

@@ -6,8 +6,8 @@ const LEVEL_WEIGHT = {
 const BUILTIN_RISK_METRICS = [
     {
         metric_id: "funds_risk",
-        display_name: "资金风险",
-        description: "直接操作资金 / 影响资金流向 / 无资金风险",
+        display_name: "Funds Risk",
+        description: "Directly operates funds / affects fund flow / no fund risk",
         type: "risk",
         scale: "level",
         weight: 1.0,
@@ -15,8 +15,8 @@ const BUILTIN_RISK_METRICS = [
     },
     {
         metric_id: "trust_risk",
-        display_name: "信任风险",
-        description: "影响信任机制的程度",
+        display_name: "Trust Risk",
+        description: "Degree of impact on trust mechanism",
         type: "risk",
         scale: "level",
         weight: 1.0,
@@ -24,8 +24,8 @@ const BUILTIN_RISK_METRICS = [
     },
     {
         metric_id: "delivery_risk",
-        display_name: "履约风险",
-        description: "影响订单履约的程度",
+        display_name: "Delivery Risk",
+        description: "Degree of impact on order fulfillment",
         type: "risk",
         scale: "level",
         weight: 1.0,
@@ -33,8 +33,8 @@ const BUILTIN_RISK_METRICS = [
     },
     {
         metric_id: "compliance_risk",
-        display_name: "合规风险",
-        description: "涉及监管的程度",
+        display_name: "Compliance Risk",
+        description: "Degree of regulatory involvement",
         type: "risk",
         scale: "level",
         weight: 1.0,
@@ -44,8 +44,8 @@ const BUILTIN_RISK_METRICS = [
 const BUILTIN_BENEFIT_METRICS = [
     {
         metric_id: "automation_level",
-        display_name: "自动化等级",
-        description: "全自动 / 半自动 / 手动",
+        display_name: "Automation Level",
+        description: "Fully automated / semi-automated / manual",
         type: "benefit",
         scale: "level",
         weight: 1.0,
@@ -53,8 +53,8 @@ const BUILTIN_BENEFIT_METRICS = [
     },
     {
         metric_id: "trust_boost",
-        display_name: "信任提升",
-        description: "对信任机制的增强程度",
+        display_name: "Trust Boost",
+        description: "Degree of enhancement to trust mechanism",
         type: "benefit",
         scale: "level",
         weight: 1.0,
@@ -62,8 +62,8 @@ const BUILTIN_BENEFIT_METRICS = [
     },
     {
         metric_id: "efficiency_gain",
-        display_name: "效率提升",
-        description: "对效率的提升程度",
+        display_name: "Efficiency Gain",
+        description: "Degree of efficiency improvement",
         type: "benefit",
         scale: "level",
         weight: 1.0,

package/dist/extensions/mode-evaluator.js

@@ -70,34 +70,34 @@ export class ModeEvaluator {
         feasibility_score = Math.max(0, Math.min(100, Math.round(feasibility_score)));
         const recommendations = [];
         if (benefit_delta > 0) {
-            recommendations.push(`收益提升 ${benefit_delta.toFixed(1)} 分，迁移有正向价值`);
+            recommendations.push(`Benefit increased by ${benefit_delta.toFixed(1)} points, migration has positive value`);
         }
         else if (benefit_delta < 0) {
-            recommendations.push(`收益下降 ${Math.abs(benefit_delta).toFixed(1)} 分，需评估迁移必要性`);
+            recommendations.push(`Benefit decreased by ${Math.abs(benefit_delta).toFixed(1)} points, need to evaluate migration necessity`);
         }
         if (risk_delta > 10) {
-            recommendations.push(`风险增加 ${risk_delta.toFixed(1)} 分，建议加强风险控制措施`);
+            recommendations.push(`Risk increased by ${risk_delta.toFixed(1)} points, recommend strengthening risk control measures`);
         }
         else if (risk_delta < -10) {
-            recommendations.push(`风险降低 ${Math.abs(risk_delta).toFixed(1)} 分，迁移有助于风险管控`);
+            recommendations.push(`Risk decreased by ${Math.abs(risk_delta).toFixed(1)} points, migration helps risk management`);
         }
         if (added_capabilities.length > 0) {
-            recommendations.push(`新增 ${added_capabilities.length} 个能力，需要额外配置：${added_capabilities.slice(0, 3).join(", ")}`);
+            recommendations.push(`Added ${added_capabilities.length} capabilities, need extra configuration: ${added_capabilities.slice(0, 3).join(", ")}`);
         }
         if (removed_capabilities.length > 0) {
-            recommendations.push(`移除 ${removed_capabilities.length} 个能力，相关功能将不可用`);
+            recommendations.push(`Removed ${removed_capabilities.length} capabilities, related features will be unavailable`);
         }
         if (conflicting_capabilities.length > 0) {
-            recommendations.push(`检测到 ${conflicting_capabilities.length} 个能力冲突，必须解决后才能迁移`);
+            recommendations.push(`Detected ${conflicting_capabilities.length} capability conflicts, must be resolved before migration`);
         }
         if (feasibility_score >= 70) {
-            recommendations.push("迁移可行性高，建议执行");
+            recommendations.push("Migration feasibility is high, recommend executing");
         }
         else if (feasibility_score >= 40) {
-            recommendations.push("迁移可行性中等，需谨慎评估");
+            recommendations.push("Migration feasibility is medium, need careful evaluation");
         }
         else {
-            recommendations.push("迁移可行性低，建议保持当前模式或寻找替代方案");
+            recommendations.push("Migration feasibility is low, recommend keeping the current mode or finding an alternative");
         }
         return {
             feasibility_score,
@@ -142,13 +142,13 @@ export class ModeEvaluator {
     generateRecommendations(mode, risk_score, benefit_score, capability_conflicts, violated_constraints, unmet_conditions) {
         const recs = [];
         if (capability_conflicts.length > 0) {
-            recs.push(`检测到 ${capability_conflicts.length} 个能力冲突，必须解决后才能应用模式`);
+            recs.push(`Detected ${capability_conflicts.length} capability conflicts, must be resolved before applying the mode`);
         }
         if (violated_constraints.length > 0) {
-            recs.push(`检测到 ${violated_constraints.length} 个硬约束违规，需要补充缺失的能力或调整模式配置`);
+            recs.push(`Detected ${violated_constraints.length} hard constraint violations, need to supplement missing capabilities or adjust mode configuration`);
         }
         if (unmet_conditions.length > 0) {
-            recs.push(`检测到 ${unmet_conditions.length} 个软约束未满足，建议调整以提升模式质量`);
+            recs.push(`Detected ${unmet_conditions.length} soft constraints not met, recommend adjusting to improve mode quality`);
         }
         const appetiteThresholds = {
             conservative: { max_risk: 30, min_benefit: 50 },
@@ -157,13 +157,13 @@ export class ModeEvaluator {
         };
         const threshold = appetiteThresholds[mode.risk_appetite];
         if (risk_score > threshold.max_risk) {
-            recs.push(`风险评分 ${risk_score} 超过 ${mode.risk_appetite} 模式阈值 ${threshold.max_risk}，建议降低风险或调整风险偏好`);
+            recs.push(`Risk score ${risk_score} exceeds ${mode.risk_appetite} mode threshold ${threshold.max_risk}, recommend reducing risk or adjusting risk appetite`);
         }
         if (benefit_score < threshold.min_benefit) {
-            recs.push(`收益评分 ${benefit_score} 低于 ${mode.risk_appetite} 模式阈值 ${threshold.min_benefit}，建议增加收益能力或调整风险偏好`);
+            recs.push(`Benefit score ${benefit_score} below ${mode.risk_appetite} mode threshold ${threshold.min_benefit}, recommend adding benefit capabilities or adjusting risk appetite`);
         }
         if (recs.length === 0) {
-            recs.push(`模式评估通过：风险 ${risk_score} / 收益 ${benefit_score} / 风险-收益比 ${(benefit_score / Math.max(risk_score, 1)).toFixed(2)}`);
+            recs.push(`Mode evaluation passed: risk ${risk_score} / benefit ${benefit_score} / risk-benefit ratio ${(benefit_score / Math.max(risk_score, 1)).toFixed(2)}`);
         }
         return recs;
     }

package/dist/extensions/modes.js

@@ -25,9 +25,9 @@ const GENERAL_FLYWHEEL = {
 const GENERAL_MACHINE_SHAPE = [
     { name: "paid", role: "Entry: order created and paid" },
     { name: "delivering", role: "Service delivery in progress" },
+    { name: "delivered", role: "Deliverable available for review" },
     { name: "completed", role: "Service completed, funds released" },
-    { name: "refunded", role: "Customer refund path" },
-    { name: "cancelled", role: "Pre-delivery cancellation" },
+    { name: "cancelled", role: "Pre-delivery cancellation — triggers refund Allocator" },
 ];
 const GENERAL_ALLOCATOR = {
     recipient: "signer",
@@ -41,8 +41,8 @@ const RETAIL_MACHINE_SHAPE = [
     { name: "delivered", role: "Goods delivered to buyer" },
     { name: "confirmed", role: "Buyer confirms receipt" },
     { name: "completed", role: "Funds released to merchant" },
-    { name: "refunded", role: "Return & refund path" },
-    { name: "cancelled", role: "Pre-ship cancellation" },
+    { name: "returned", role: "Buyer ships goods back — triggers refund Allocator (R-M1-11 compliant)" },
+    { name: "cancelled", role: "Pre-ship cancellation — triggers refund Allocator" },
 ];
 const RETAIL_GUARDS = [
     { template_id: "buy_guard_inventory", host: "service", purpose: "Verify inventory and buyer address on purchase" },
@@ -64,19 +64,47 @@ const RETAIL_BUILD_NOTES = [
     "Refund path must support return-and-exchange flow",
     "Compensation fund covers return/exchange disputes",
 ];
+const RETAIL_D2C_MACHINE_SHAPE = [
+    { name: "ordered", role: "Entry: order created (funds escrowed in Allocation)" },
+    { name: "shipped", role: "Merchant ships goods" },
+    { name: "delivered", role: "Goods delivered to buyer" },
+    { name: "completed", role: "Buyer confirms receipt — withdraw_guard releases funds" },
+    { name: "cancelled", role: "Pre-ship cancellation — refund_guard refunds buyer" },
+];
+const RETAIL_D2C_GUARDS = [
+    { template_id: "withdraw_guard_delivery", host: "service", purpose: "Release funds to merchant + processor on order completion (delivery confirmation)" },
+    { template_id: "refund_guard_cancellation", host: "service", purpose: "Refund 100% to buyer on order cancellation" },
+];
+const RETAIL_D2C_ALLOCATOR = {
+    recipient: "entity",
+    count: 2,
+    mode: "rate",
+    description: "Merchant 97% + Processor 3% (rate-based split, no platform commission)",
+};
+const RETAIL_D2C_KEY_RISK = "No platform arbitration — disputes rely on optional Arbitration or off-chain chargeback";
+const RETAIL_D2C_BUILD_NOTES = [
+    "Allocation escrow replaces platform custody — funds locked in contract until Guard releases",
+    "withdraw_guard enforces delivery gate — merchant must reach 'completed' state to receive payment",
+    "refund_guard ensures 100% refund on cancellation — no merchant approval needed",
+    "No buy_guard needed — D2C doesn't gate purchases (open storefront)",
+    "Arbitration is optional — add when dispute volume justifies the cost",
+    "Service ↔ Guard circular dependency: create Service (unpublished) → create Guards → update Service (publish)",
+];
 const SUPPORTED_INDUSTRY_SET = new Set([
-    "freelance", "rental", "education", "travel", "subscription", "retail",
+    "freelance", "rental", "education", "travel", "subscription", "retail", "retail_d2c",
 ]);
 function fetchTemplate(name) {
-    const traits = getIndustryTraits(name) ?? GENERAL_TRAITS;
+    const traitsLookupName = name === "retail_d2c" ? "retail" : name;
+    const traits = getIndustryTraits(traitsLookupName) ?? GENERAL_TRAITS;
     const isSupported = SUPPORTED_INDUSTRY_SET.has(name);
+    const industryLookupName = name === "retail_d2c" ? "retail" : name;
     const risk_checks = isSupported
-        ? getIndustryRiskChecks(name)
+        ? getIndustryRiskChecks(industryLookupName)
         : [];
     const needs = isSupported
-        ? getIndustryNeeds(name)
+        ? getIndustryNeeds(industryLookupName)
         : [];
-    const flywheel = getFlywheelForIndustry(name) ?? GENERAL_FLYWHEEL;
+    const flywheel = getFlywheelForIndustry(traitsLookupName) ?? GENERAL_FLYWHEEL;
     let machine_shape;
     let guards;
     let allocator;
@@ -89,6 +117,13 @@ function fetchTemplate(name) {
         key_risk = RETAIL_KEY_RISK;
         build_notes = RETAIL_BUILD_NOTES;
     }
+    else if (name === "retail_d2c") {
+        machine_shape = RETAIL_D2C_MACHINE_SHAPE;
+        guards = RETAIL_D2C_GUARDS;
+        allocator = RETAIL_D2C_ALLOCATOR;
+        key_risk = RETAIL_D2C_KEY_RISK;
+        build_notes = RETAIL_D2C_BUILD_NOTES;
+    }
     else if (name === "general") {
         const sm = getScenarioMode("general");
         machine_shape = GENERAL_MACHINE_SHAPE;
@@ -113,7 +148,7 @@ function fetchTemplate(name) {
 export const BUILTIN_MODES = [
     {
         name: "freelance",
-        display_name: "Freelance 自由职业",
+        display_name: "Freelance",
         version: "v1",
         source: "builtin",
         ...fetchTemplate("freelance"),
@@ -131,28 +166,32 @@ export const BUILTIN_MODES = [
             machine: { wip_required: true, wip_hash_algorithm: "sha256", acceptance_gate: true },
         },
         expected_benefits: [
-            { metric: "纠纷率降低", expected_value: "40%", evidence: "WIP 哈希 + 里程碑分账强制交付证据" },
-            { metric: "交付确认效率", expected_value: "提升 50%", evidence: "acceptance gate 自动化验收" },
-            { metric: "提供方回款保障", expected_value: "100%", evidence: "accepted 节点后资金自动释放给提供方" },
+            { metric: "Dispute rate reduction", expected_value: "40%", evidence: "WIP hash + milestone allocation enforces delivery evidence" },
+            { metric: "Delivery confirmation efficiency", expected_value: "+50%", evidence: "acceptance gate automates acceptance workflow" },
+            { metric: "Provider payment assurance", expected_value: "100%", evidence: "Funds auto-release to provider after accepted node" },
         ],
         risk_appetite: "balanced",
         risk_constraints: {
             require_arbitration: true,
             require_compensation_fund: false,
             require_wip_evidence: true,
-            other_constraints: ["setting_locked_time ≥ 7d 以锁定合作期规则"],
+            other_constraints: [
+                "setting_locked_time >= 7d to lock engagement-period rules",
+                "ISSUE-P1-4: 48h auto-accept requires off-chain keeper (WoWok Guard does not support time-based triggers). Deploy a keeper service that polls Progress objects in 'delivered' state and calls adminUnhold (permission 224) after 48h timeout. See keeper template in docs.",
+            ],
         },
         applicable_conditions: {
             business_scale: "small",
             min_daily_orders: 1,
-            other_conditions: ["适合中长期项目交付", "需里程碑分阶段验收"],
+            other_conditions: ["Suitable for mid-to-long-term project delivery", "Requires milestone-based phased acceptance"],
         },
         similar_industries: ["rental", "education"],
         novel_capabilities: ["allocation.distribute_milestone"],
+        disabled_builtin_constraints: ["require_compensation_fund"],
     },
     {
         name: "rental",
-        display_name: "Rental 租赁",
+        display_name: "Rental",
         version: "v1",
         source: "builtin",
         ...fetchTemplate("rental"),
@@ -170,9 +209,9 @@ export const BUILTIN_MODES = [
             machine: { wip_required: true, wip_stages: ["handover_out", "returned"], inspection_gate: true },
         },
         expected_benefits: [
-            { metric: "押金纠纷率", expected_value: "降低 60%", evidence: "pre-rental WIP 强制记录物品原始状态" },
-            { metric: "损坏定责准确率", expected_value: "提升 70%", evidence: "前后 WIP 哈希对比，杜绝无据扣款" },
-            { metric: "信任评分", expected_value: "提升 25%", evidence: "compensation_fund 覆盖损坏风险" },
+            { metric: "Deposit dispute rate", expected_value: "-60%", evidence: "pre-rental WIP mandatorily records item's original state" },
+            { metric: "Damage liability accuracy", expected_value: "+70%", evidence: "pre/post WIP hash comparison eliminates unfounded deductions" },
+            { metric: "Trust score", expected_value: "+25%", evidence: "compensation_fund covers damage risk" },
         ],
         risk_appetite: "conservative",
         risk_constraints: {
@@ -180,19 +219,20 @@ export const BUILTIN_MODES = [
             require_compensation_fund: true,
             require_wip_evidence: true,
             max_single_transaction: 10000,
-            other_constraints: ["押金必须 escrow 托管（不可直转）", "lock_duration ≥ 7d 防止商家随意提取"],
+            compensation_fund_coverage_ratio: 10,
+            other_constraints: ["Deposit must be escrowed (no direct transfer)", "lock_duration >= 7d to prevent arbitrary merchant withdrawal"],
         },
         applicable_conditions: {
             business_scale: "small",
             min_daily_orders: 1,
-            other_conditions: ["需物理物品交接", "有物流或线下交付环节"],
+            other_conditions: ["Requires physical item handover", "Has logistics or offline delivery leg"],
         },
         similar_industries: ["retail", "travel"],
         novel_capabilities: [],
     },
     {
         name: "education",
-        display_name: "Education 教育",
+        display_name: "Education",
         version: "v1",
         source: "builtin",
         ...fetchTemplate("education"),
@@ -218,28 +258,29 @@ export const BUILTIN_MODES = [
             service: { setting_locked_time: "120d", anti_runaway: true },
         },
         expected_benefits: [
-            { metric: "退费纠纷率", expected_value: "降低 50%", evidence: "per-session release 按课时释放学费" },
-            { metric: "机构跑路风险", expected_value: "消除", evidence: "资金按课时释放，未交付部分可退" },
-            { metric: "出勤可追溯", expected_value: "100%", evidence: "attendance_guard 每课时签名" },
+            { metric: "Refund dispute rate", expected_value: "-50%", evidence: "per-session release distributes tuition by class" },
+            { metric: "Institution runaway risk", expected_value: "eliminated", evidence: "Funds release per session; undelivered portion is refundable" },
+            { metric: "Attendance traceability", expected_value: "100%", evidence: "attendance_guard signs each session" },
         ],
         risk_appetite: "conservative",
         risk_constraints: {
             require_arbitration: true,
             require_compensation_fund: true,
             require_wip_evidence: false,
-            other_constraints: ["setting_locked_time 覆盖整个学期（≥90d）", "长周期需关注 >90d 进度"],
+            other_constraints: ["setting_locked_time covers the entire term (>=90d)", "Long-cycle projects must monitor >90d progress"],
         },
         applicable_conditions: {
             business_scale: "medium",
             min_daily_orders: 1,
-            other_conditions: ["长周期交付", "需分课时验收", "监管强度 medium"],
+            other_conditions: ["Long-cycle delivery", "Requires per-session acceptance", "Regulatory intensity: medium"],
         },
         similar_industries: ["freelance", "subscription"],
         novel_capabilities: ["allocation.distribute_milestone"],
+        disabled_builtin_constraints: ["require_wip_evidence"],
     },
     {
         name: "travel",
-        display_name: "Travel 旅游",
+        display_name: "Travel",
         version: "v1",
         source: "builtin",
         ...fetchTemplate("travel"),
@@ -266,28 +307,28 @@ export const BUILTIN_MODES = [
             service: { supply_chain_suborders: true, segment_guard_required: true },
         },
         expected_benefits: [
-            { metric: "资金透明度", expected_value: "100%", evidence: "multi-tier allocation 按段分账至酒店/导游/司机" },
-            { metric: "行程变更纠纷", expected_value: "降低 45%", evidence: "segment WIP 每段验收" },
-            { metric: "违约赔付保障", expected_value: "提升 60%", evidence: "compensation_fund 覆盖行程违约" },
+            { metric: "Fund transparency", expected_value: "100%", evidence: "multi-tier allocation splits per segment to hotel/guide/driver" },
+            { metric: "Itinerary change disputes", expected_value: "-45%", evidence: "segment WIP accepts each leg" },
+            { metric: "Breach compensation assurance", expected_value: "+60%", evidence: "compensation_fund covers itinerary breach" },
         ],
         risk_appetite: "balanced",
         risk_constraints: {
             require_arbitration: true,
             require_compensation_fund: true,
             require_wip_evidence: true,
-            other_constraints: ["多级分账需 guard chaining 校验", "deposit 20% + final 80% 两段付款"],
+            other_constraints: ["Multi-tier allocation requires guard chaining validation", "deposit 20% + final 80% two-stage payment"],
         },
         applicable_conditions: {
             business_scale: "medium",
             min_daily_orders: 1,
-            other_conditions: ["多段行程组合", "需酒店/导游/司机多方分账"],
+            other_conditions: ["Multi-segment itinerary combination", "Requires hotel/guide/driver multi-party allocation"],
         },
         similar_industries: ["rental", "education"],
         novel_capabilities: [],
     },
     {
         name: "subscription",
-        display_name: "Subscription 订阅",
+        display_name: "Subscription",
         version: "v1",
         source: "builtin",
         ...fetchTemplate("subscription"),
@@ -310,28 +351,30 @@ export const BUILTIN_MODES = [
             service: { creator_data_subscription: true, periodic_billing: true },
         },
         expected_benefits: [
-            { metric: "续费率", expected_value: "提升 25%", evidence: "loyalty reward + 透明订阅机制" },
-            { metric: "退订纠纷", expected_value: "消除", evidence: "cancel anytime + no auto-renew trap" },
-            { metric: "创作者留存", expected_value: "提升 30%", evidence: "deliver_guard_wip 防止内容断更" },
+            { metric: "Renewal rate", expected_value: "+25%", evidence: "loyalty reward + transparent subscription mechanism" },
+            { metric: "Cancellation disputes", expected_value: "eliminated", evidence: "cancel anytime + no auto-renew trap" },
+            { metric: "Creator retention", expected_value: "+30%", evidence: "deliver_guard_wip prevents content dropout" },
         ],
         risk_appetite: "aggressive",
         risk_constraints: {
             require_arbitration: false,
             require_compensation_fund: false,
             require_wip_evidence: false,
-            other_constraints: ["禁止 dead-end 节点（防止锁定）", "charge_guard 每期需用户确认"],
+            compensation_fund_coverage_ratio: 3,
+            other_constraints: ["Forbid dead-end nodes (prevent lock-in)", "charge_guard requires user confirmation each period"],
         },
         applicable_conditions: {
             business_scale: "small",
             min_daily_orders: 5,
-            other_conditions: ["纯数字交付", "周期性内容或 SaaS 服务"],
+            other_conditions: ["Pure-digital delivery", "Periodic content or SaaS service"],
         },
         similar_industries: ["freelance", "education"],
         novel_capabilities: [],
+        disabled_builtin_constraints: ["require_arbitration", "require_compensation_fund", "require_wip_evidence"],
     },
     {
         name: "retail",
-        display_name: "Retail 零售",
+        display_name: "Retail",
         version: "v1",
         source: "builtin",
         ...fetchTemplate("retail"),
@@ -354,28 +397,76 @@ export const BUILTIN_MODES = [
             service: { logistics_mode: "standard", first_order_discount: true },
         },
         expected_benefits: [
-            { metric: "退货纠纷率", expected_value: "降低 35%", evidence: "logistics WIP + refund path 保障" },
-            { metric: "复购率", expected_value: "提升 20%", evidence: "spend cashback reward" },
-            { metric: "商品真实性可追溯", expected_value: "100%", evidence: "WIP 验证商品/物流信息" },
+            { metric: "Return dispute rate", expected_value: "-35%", evidence: "logistics WIP + refund path assurance" },
+            { metric: "Repurchase rate", expected_value: "+20%", evidence: "spend cashback reward" },
+            { metric: "Product authenticity traceability", expected_value: "100%", evidence: "WIP verifies product/logistics info" },
         ],
         risk_appetite: "conservative",
         risk_constraints: {
             require_arbitration: true,
             require_compensation_fund: true,
             require_wip_evidence: false,
-            other_constraints: ["refund_window ≥ 7d", "confirm_gate 仅买家可确认收货"],
+            compensation_fund_coverage_ratio: 5,
+            other_constraints: ["refund_window >= 7d", "confirm_gate: only buyer can confirm receipt"],
         },
         applicable_conditions: {
             business_scale: "medium",
             min_daily_orders: 10,
-            other_conditions: ["有物流发货环节", "高频小额交易"],
+            other_conditions: ["Has logistics shipping leg", "High-frequency small-ticket transactions"],
         },
         similar_industries: ["rental", "subscription"],
         novel_capabilities: [],
+        disabled_builtin_constraints: ["require_wip_evidence"],
+    },
+    {
+        name: "retail_d2c",
+        display_name: "Retail D2C (Direct-to-Consumer)",
+        version: "v1",
+        source: "builtin",
+        ...fetchTemplate("retail_d2c"),
+        capabilities_used: [
+            "permission.index_create", "permission.role_assign",
+            "guard.validate_withdraw", "guard.validate_refund",
+            "machine.node_topology",
+            "allocation.distribute",
+            "service.publish", "progress.advance",
+            "contact.im_create",
+        ],
+        config_overrides: {
+            machine: {
+                wip_required: false,
+                confirm_gate: true,
+                refund_requires_approval: false,
+            },
+            service: { logistics_mode: "merchant_managed", multi_recipient_allocation: true },
+        },
+        expected_benefits: [
+            { metric: "Merchant revenue share", expected_value: "97%", evidence: "No platform commission — only 3% processing fee" },
+            { metric: "Fund safety", expected_value: "contract-grade", evidence: "Allocation escrow + Guard verification replaces platform custody" },
+            { metric: "Delivery reliability", expected_value: "high", evidence: "withdraw_guard enforces delivery confirmation before payment" },
+        ],
+        risk_appetite: "balanced",
+        risk_constraints: {
+            require_arbitration: false,
+            require_compensation_fund: false,
+            require_wip_evidence: false,
+            other_constraints: [
+                "Allocation escrow required (withdraw_guard + refund_guard)",
+                "Service ↔ Guard circular dependency requires 3-step creation pattern",
+            ],
+        },
+        applicable_conditions: {
+            business_scale: "small",
+            min_daily_orders: 1,
+            other_conditions: ["Independent storefront (no marketplace)", "Merchant-managed logistics", "Allocation escrow model"],
+        },
+        similar_industries: ["retail", "subscription"],
+        novel_capabilities: ["Allocation escrow as platform-custody alternative", "Multi-recipient allocation (merchant + processor)"],
+        disabled_builtin_constraints: ["require_arbitration", "require_compensation_fund", "require_wip_evidence"],
     },
     {
         name: "general",
-        display_name: "General 通用",
+        display_name: "General",
         version: "v1",
         source: "builtin",
         ...fetchTemplate("general"),
@@ -388,8 +479,8 @@ export const BUILTIN_MODES = [
             "progress.advance",
         ],
         expected_benefits: [
-            { metric: "灵活性", expected_value: "100%", evidence: "用户自定义所有信任机制参数" },
-            { metric: "降级安全", expected_value: "可用", evidence: "任意时刻可切换至 general 兜底" },
+            { metric: "Flexibility", expected_value: "100%", evidence: "User customizes all trust mechanism parameters" },
+            { metric: "Degraded safety", expected_value: "usable", evidence: "Can fall back to general at any time" },
         ],
         risk_appetite: "balanced",
         risk_constraints: {
@@ -399,9 +490,10 @@ export const BUILTIN_MODES = [
         },
         applicable_conditions: {
             business_scale: "small",
-            other_conditions: ["降级兜底模式", "未被其他行业覆盖的混合场景"],
+            other_conditions: ["Fallback degraded mode", "Hybrid scenarios not covered by other industries"],
         },
         similar_industries: [],
         novel_capabilities: [],
+        disabled_builtin_constraints: ["require_arbitration", "require_compensation_fund", "require_wip_evidence"],
     },
 ];

package/dist/extensions/registry.d.ts

@@ -6,6 +6,8 @@ export declare class IndustryModeRegistry {
     private aliases;
     private evaluator;
     private initialized;
+    private persistence;
+    private userModesLoaded;
     static Instance(): IndustryModeRegistry;
     private constructor();
     registerMode(mode: IndustryMode, aliases?: string[]): boolean;
@@ -15,16 +17,19 @@ export declare class IndustryModeRegistry {
     hasMode(name: string): boolean;
     evaluateMode(name: string, intent: string, context: ProjectContext): ModeEvaluation;
     evaluateMigration(sourceName: string, targetName: string): ModeMigrationEvaluation;
-    registerUserMode(mode: UserDefinedMode, userId: string): boolean;
-    deriveMode(sourceMode: string, modifications: Partial<UserDefinedMode>, userId: string, newName: string, newDisplayName?: string): UserDefinedMode | undefined;
-    evolveMode(modeName: string, updates: Partial<UserDefinedMode>, userId: string, changeDescription: string, bumpVersion?: boolean): UserDefinedMode | undefined;
-    listUserModes(userId: string): UserDefinedMode[];
-    getUserMode(modeName: string, userId: string): UserDefinedMode | undefined;
-    unregisterUserMode(modeName: string, userId: string): boolean;
+    registerUserMode(mode: UserDefinedMode, userId: string): Promise<boolean>;
+    deriveMode(sourceMode: string, modifications: Partial<UserDefinedMode>, userId: string, newName: string, newDisplayName?: string): Promise<UserDefinedMode | undefined>;
+    evolveMode(modeName: string, updates: Partial<UserDefinedMode>, userId: string, changeDescription: string, bumpVersion?: boolean): Promise<UserDefinedMode | undefined>;
+    listUserModes(userId: string): Promise<UserDefinedMode[]>;
+    getUserMode(modeName: string, userId: string): Promise<UserDefinedMode | undefined>;
+    unregisterUserMode(modeName: string, userId: string): Promise<boolean>;
     private userModeKey;
+    private ensureUserModesLoaded;
+    private persistUserMode;
+    private unpersistUserMode;
     private bumpPatchVersion;
-    applyTemplate(name: string, intent: string, context: ProjectContext): Blueprint;
-    applyUserMode(modeName: string, userId: string, intent: string, context: ProjectContext): Blueprint;
+    applyTemplate(name: string, intent: string, context: ProjectContext): Promise<Blueprint>;
+    applyUserMode(modeName: string, userId: string, intent: string, context: ProjectContext): Promise<Blueprint>;
     private doApplyTemplate;
     validateBlueprint(objects: BlueprintObject[], edges: BlueprintEdge[], mode: IndustryMode): {
         errors: string[];
@@ -41,8 +46,10 @@ export declare class IndustryModeRegistry {
     private buildSteps;
     private defaultScenarios;
     private recordCapabilitiesUsed;
+    private deriveGuardShortName;
+    private getFirstServiceGuardName;
     private makeObject;
     private registerBuiltinModes;
 }
 export declare function getIndustryModeRegistry(): IndustryModeRegistry;
-export declare const INDUSTRY_MODE_REGISTRY_VERSION = 2.1;
+export declare const INDUSTRY_MODE_REGISTRY_VERSION = 2.2;