@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/knowledge/arbitration-context.js

@@ -1,505 +1 @@
-import { MAX_VOTING_GUARD_COUNT, } from "@wowok/wowok";
-import { ARBITRATION_SCENES, DUAL_GUARD_MATRIX, ARB_STATUS_CODE, ARB_TERMINAL_STATUSES, findSceneByPermissionIndex, inferSceneFromIntent, getScenesByCategory, getDualGuardMatrixEntry, isValidArbStatusTransition, isTerminalArbStatus, getActiveArbitrationPermissions, getAllArbitrationPermissions, } from "./arbitration-ledger.js";
-import { getTemplatesByScene, } from "./arbitration-templates.js";
-import { ARBITRATION_CONSTRAINT_RULES, matchSemanticPattern, } from "./arbitration-translation.js";
-import { getAllRiskRules, assessArbitrationRisks, } from "./arbitration-risk.js";
-import { initPuzzleFromIntent, checkPuzzleCompleteness, } from "./arbitration-puzzle.js";
-import { ARBITRATION_OPERATION_CHECKLIST, ARBITRATION_CONFIRMATION_QUESTIONS, } from "./arbitration-confirm.js";
-export const ARBITRATION_CONTEXT_VERSION = "1.0.0";
-export function buildArbitrationContext(input) {
-    const max_length = input.max_length ?? 4500;
-    let matched_scene;
-    if (input.intent) {
-        matched_scene = inferSceneFromIntent(input.intent);
-    }
-    else if (input.target_permission_index !== undefined) {
-        matched_scene = findSceneByPermissionIndex(input.target_permission_index);
-    }
-    else if (input.target_operation_category) {
-        const scenes = getScenesByCategory(input.target_operation_category);
-        if (scenes.length > 0)
-            matched_scene = scenes[0];
-    }
-    let matched_template;
-    if (matched_scene) {
-        const templates = getTemplatesByScene(matched_scene.id);
-        if (templates.length > 0)
-            matched_template = templates[0];
-    }
-    let matched_pattern;
-    if (input.intent) {
-        const patterns = matchSemanticPattern(input.intent);
-        if (patterns.length > 0)
-            matched_pattern = patterns[0];
-    }
-    let puzzle_state;
-    let puzzle_completeness;
-    if (input.mode === "initial_design" && input.intent) {
-        puzzle_state = initPuzzleFromIntent({ rule_sentence: input.intent });
-        puzzle_completeness = checkPuzzleCompleteness(puzzle_state);
-    }
-    const relevant_risks = filterRiskRules(input.mode, input.stakeholder, matched_scene);
-    let risk_assessment;
-    if (input.mode === "pre_publish" && input.arbitration_json) {
-        const ctx = {
-            object: input.arbitration_json.object,
-            description: input.arbitration_json.description,
-            location: input.arbitration_json.location,
-            fee: input.arbitration_json.fee,
-            pause: input.arbitration_json.pause,
-            dispute: input.arbitration_json.dispute,
-            confirm: input.arbitration_json.confirm,
-            voting_deadline_change: input.arbitration_json.voting_deadline_change,
-            vote: input.arbitration_json.vote,
-            feedback: input.arbitration_json.feedback,
-            arbitration: input.arbitration_json.arbitration,
-            reset: input.arbitration_json.reset,
-            arb_withdraw: input.arbitration_json.arb_withdraw,
-            fees_transfer: input.arbitration_json.fees_transfer,
-            usage_guard: input.arbitration_json.usage_guard,
-            voting_guard: input.arbitration_json.voting_guard,
-            um: input.arbitration_json.um,
-            builder: input.arbitration_json.builder,
-            current_arb_status: input.current_arb_status,
-            expected_arb_status: input.arbitration_json.arbitration ? "Arbitrated" : input.current_arb_status,
-        };
-        risk_assessment = assessArbitrationRisks(ctx);
-    }
-    const relevant_checklist = filterChecklist(input.mode);
-    const relevant_questions = filterQuestions(input.mode);
-    const relevant_constraints = filterConstraints(input.mode, matched_scene);
-    const relevant_permissions = input.stakeholder === "system"
-        ? getAllArbitrationPermissions()
-        : getActiveArbitrationPermissions();
-    let dual_guard_matrix_entry;
-    if (input.voting_guard_empty !== undefined && input.usage_guard_none !== undefined) {
-        dual_guard_matrix_entry = getDualGuardMatrixEntry(input.voting_guard_empty, input.usage_guard_none);
-    }
-    else if (matched_scene) {
-        const vEmpty = matched_scene.requires_voting_guard === "empty";
-        const uNone = matched_scene.requires_usage_guard === "none";
-        dual_guard_matrix_entry = getDualGuardMatrixEntry(vEmpty, uNone);
-    }
-    const arb_lifecycle_context = buildArbLifecycleContext(input.current_arb_status, matched_scene);
-    const cross_object_refs = buildCrossObjectRefs(matched_scene);
-    const onchain_constraints = buildOnchainConstraints();
-    const rendering_hints = buildRenderingHints(input.mode, max_length, !!input.arbitration_json?.arbitration, !!input.arbitration_json?.builder);
-    return {
-        version: ARBITRATION_CONTEXT_VERSION,
-        mode: input.mode,
-        stakeholder_perspective: input.stakeholder,
-        matched_scene,
-        matched_template,
-        matched_pattern,
-        puzzle_state,
-        puzzle_completeness,
-        relevant_risks,
-        risk_assessment,
-        relevant_checklist,
-        relevant_questions,
-        relevant_permissions,
-        relevant_constraints,
-        dual_guard_matrix_entry,
-        arb_lifecycle_context,
-        cross_object_refs,
-        onchain_constraints,
-        rendering_hints,
-    };
-}
-function filterRiskRules(mode, stakeholder, scene) {
-    const rules = getAllRiskRules();
-    if (mode === "initial_design") {
-        return rules.filter(r => r.category === "structural" || r.category === "authority");
-    }
-    if (mode === "pre_publish") {
-        return rules;
-    }
-    if (mode === "stakeholder_review" && stakeholder) {
-        if (stakeholder === "owner") {
-            return rules.filter(r => r.category === "authority" || r.category === "lifecycle" || r.category === "cross_object");
-        }
-        if (stakeholder === "arbiter") {
-            return rules.filter(r => r.category === "authority" || r.category === "lifecycle");
-        }
-        if (stakeholder === "voter") {
-            return rules.filter(r => r.category === "structural" || r.category === "lifecycle");
-        }
-        if (stakeholder === "disputant") {
-            return rules.filter(r => r.category === "semantic" || r.category === "lifecycle");
-        }
-        if (stakeholder === "system") {
-            return rules.filter(r => r.category === "structural" || r.category === "cross_object");
-        }
-    }
-    if (mode === "post_publish_modify") {
-        return rules.filter(r => r.category === "lifecycle" || r.category === "cross_object");
-    }
-    return rules;
-}
-function filterChecklist(mode) {
-    if (mode === "initial_design") {
-        return ARBITRATION_OPERATION_CHECKLIST.filter(i => ["C-AB-01", "C-AB-02", "C-AB-03", "C-AB-04"].includes(i.id));
-    }
-    return [...ARBITRATION_OPERATION_CHECKLIST];
-}
-function filterQuestions(mode) {
-    if (mode === "pre_publish") {
-        return [...ARBITRATION_CONFIRMATION_QUESTIONS];
-    }
-    if (mode === "post_publish_modify") {
-        return ARBITRATION_CONFIRMATION_QUESTIONS.filter(q => q.id !== "QAB5");
-    }
-    return [];
-}
-function filterConstraints(mode, scene) {
-    if (mode === "initial_design") {
-        return ARBITRATION_CONSTRAINT_RULES.filter(c => c.category === "structural");
-    }
-    if (mode === "pre_publish") {
-        return [...ARBITRATION_CONSTRAINT_RULES];
-    }
-    if (scene) {
-        const categoryMap = {
-            lifecycle: ["structural", "authority"],
-            dispute: ["semantic", "lifecycle"],
-            voting: ["semantic", "lifecycle"],
-            ruling: ["authority", "lifecycle"],
-            fund: ["cross_object"],
-            guard: ["structural", "semantic"],
-            governance: ["authority"],
-        };
-        const cats = categoryMap[scene.operation_category] ?? [];
-        return ARBITRATION_CONSTRAINT_RULES.filter(c => cats.includes(c.category));
-    }
-    return [...ARBITRATION_CONSTRAINT_RULES];
-}
-function buildArbLifecycleContext(current_status, scene) {
-    if (!current_status && !scene)
-        return undefined;
-    const is_terminal = current_status ? isTerminalArbStatus(current_status) : false;
-    const valid_next_statuses = [];
-    if (current_status) {
-        const allStatuses = [
-            "Principal_confirming",
-            "Arbitrator_confirming",
-            "Voting",
-            "Arbitrated",
-            "Objectionable",
-            "Finished",
-            "Withdrawn",
-        ];
-        for (const target of allStatuses) {
-            if (target !== current_status && isValidArbStatusTransition(current_status, target)) {
-                valid_next_statuses.push(target);
-            }
-        }
-    }
-    const valid_operations_from_here = [];
-    for (const s of ARBITRATION_SCENES) {
-        if (current_status && s.required_arb_status && s.required_arb_status.includes(current_status)) {
-            valid_operations_from_here.push(s.id);
-        }
-    }
-    return {
-        current_status,
-        current_status_code: current_status ? ARB_STATUS_CODE[current_status] : undefined,
-        is_terminal,
-        valid_next_statuses,
-        valid_operations_from_here,
-    };
-}
-function buildCrossObjectRefs(scene) {
-    const refs = [];
-    const outboundRefs = [
-        {
-            object: "Order",
-            field: "dispute.order",
-            scene_id: "arbitration_dispute",
-            description: "dispute() takes Order address — Order is the source of disputes",
-            direction: "references",
-        },
-        {
-            object: "Arb",
-            field: "dispute (spawns Arb)",
-            scene_id: "arbitration_dispute",
-            description: "Each dispute() creates a new Arb case object with 7-state lifecycle",
-            direction: "references",
-        },
-        {
-            object: "Guard",
-            field: "voting_guard / usage_guard",
-            scene_id: "arbitration_voting_guard_config / arbitration_usage_guard_config",
-            description: "voting_guard controls vote weight (max 50); usage_guard filters who can file disputes",
-            direction: "references",
-        },
-        {
-            object: "Allocation",
-            field: "fees_transfer.to.allocation",
-            scene_id: "arbitration_fees_transfer",
-            description: "Withdrawn fees can be routed to Allocation for arbiter compensation distribution",
-            direction: "references",
-        },
-        {
-            object: "Treasury",
-            field: "fees_transfer.to.treasury",
-            scene_id: "arbitration_fees_transfer",
-            description: "Withdrawn fees can be routed to Treasury as alternative destination",
-            direction: "references",
-        },
-        {
-            object: "Contact",
-            field: "um",
-            scene_id: "arbitration_um_set",
-            description: "um (Contact object) for arbitrator ↔ disputant communication channel",
-            direction: "references",
-        },
-        {
-            object: "Payment",
-            field: "fees_transfer.payment_remark / payment_index",
-            scene_id: "arbitration_fees_transfer",
-            description: "fees_transfer creates Payment object with remark + index for audit trail",
-            direction: "references",
-        },
-    ];
-    const inboundRefs = [
-        {
-            object: "Service",
-            field: "arbitrations (MAX_ARBITRATION_COUNT=20)",
-            scene_id: "service_arbitration_config",
-            description: "Service embeds up to 20 Arbitration references for dispute resolution per service",
-            direction: "referenced_by",
-        },
-    ];
-    if (scene) {
-        const sceneId = scene.id;
-        return [...outboundRefs, ...inboundRefs].filter(r => r.scene_id === sceneId || r.scene_id.includes(sceneId.split("_")[1] ?? ""));
-    }
-    return [...outboundRefs, ...inboundRefs];
-}
-function buildOnchainConstraints() {
-    return [
-        {
-            name: "MAX_VOTING_GUARD_COUNT",
-            value: MAX_VOTING_GUARD_COUNT,
-            description: "Maximum voting_guard entries per Arbitration (Move source: arbitration.move:25)",
-        },
-        {
-            name: "ARBITRATION_PERMISSION_INDEX_RANGE",
-            value: "350-368 (352 reserved)",
-            description: "19 built-in permission indexes for Arbitration — most among all 22 objects",
-        },
-        {
-            name: "ARB_STATE_COUNT",
-            value: 7,
-            description: "Arb has 7-state lifecycle: Principal_confirming → Arbitrator_confirming → Voting → Arbitrated → Objectionable → Finished/Withdrawn",
-        },
-        {
-            name: "ARB_TERMINAL_STATUSES",
-            value: ARB_TERMINAL_STATUSES.length,
-            description: `Terminal statuses: ${ARB_TERMINAL_STATUSES.join(", ")} (no further transitions)`,
-        },
-        {
-            name: "DUAL_GUARD_COMBINATIONS",
-            value: DUAL_GUARD_MATRIX.length,
-            description: "4 dual-Guard combos: (voting_guard empty/non-empty) × (usage_guard none/some)",
-        },
-    ];
-}
-function buildRenderingHints(mode, max_length, hasIndemnity, hasOwnershipTransfer) {
-    return {
-        include_puzzle_template: mode === "initial_design",
-        include_risk_details: mode === "pre_publish" || mode === "stakeholder_review",
-        include_questions: mode === "pre_publish",
-        include_dual_guard_matrix: mode === "initial_design" || mode === "pre_publish",
-        include_arb_lifecycle: mode === "pre_publish" || mode === "post_publish_modify" || mode === "stakeholder_review",
-        include_immutability_warning: mode === "post_publish_modify",
-        include_indemnity_warning: hasIndemnity,
-        include_ownership_transfer_warning: hasOwnershipTransfer,
-        max_length,
-    };
-}
-export function buildPromptFromArbitrationContext(bundle) {
-    const lines = [];
-    const h = bundle.rendering_hints;
-    lines.push(`═══ Arbitration Context (mode: ${bundle.mode}) ═══`);
-    lines.push("");
-    if (bundle.stakeholder_perspective) {
-        lines.push(`Stakeholder perspective: ${bundle.stakeholder_perspective}`);
-        lines.push("");
-    }
-    if (bundle.matched_scene) {
-        lines.push(`Scene: ${bundle.matched_scene.name}`);
-        lines.push(`Category: ${bundle.matched_scene.operation_category}`);
-        lines.push(`Permission index: ${bundle.matched_scene.permission_index} (${bundle.matched_scene.permission_name})`);
-        if (bundle.matched_scene.required_arb_status && bundle.matched_scene.required_arb_status.length > 0) {
-            lines.push(`Required Arb status: ${bundle.matched_scene.required_arb_status.join(" | ")}`);
-        }
-        if (bundle.matched_scene.resulting_arb_status) {
-            lines.push(`Resulting Arb status: ${bundle.matched_scene.resulting_arb_status}`);
-        }
-        lines.push(`Has _with_passport variant: ${bundle.matched_scene.has_passport_variant ? "YES" : "NO"}`);
-        lines.push("");
-    }
-    if (bundle.matched_template) {
-        lines.push(`Suggested template: ${bundle.matched_template.id} — ${bundle.matched_template.name}`);
-        lines.push(`Description: ${bundle.matched_template.description}`);
-        lines.push("");
-    }
-    if (bundle.matched_pattern) {
-        lines.push(`Matched pattern: ${bundle.matched_pattern.id} — ${bundle.matched_pattern.pattern_name}`);
-        lines.push(`Intent: ${bundle.matched_pattern.semantic_intent}`);
-        lines.push("");
-    }
-    if (h.include_puzzle_template && bundle.puzzle_completeness) {
-        const c = bundle.puzzle_completeness;
-        lines.push("─ Puzzle Completeness ──────────────");
-        lines.push(`Complete: ${c.complete ? "YES" : "NO"}`);
-        if (c.missing.length > 0) {
-            lines.push(`Missing dimensions: ${c.missing.join(", ")}`);
-        }
-        lines.push(`Next step: ${c.next_step}`);
-        lines.push("");
-    }
-    if (h.include_dual_guard_matrix && bundle.dual_guard_matrix_entry) {
-        const m = bundle.dual_guard_matrix_entry;
-        lines.push("─ Dual-Guard Matrix Entry ──────────────");
-        lines.push(`Voting guard: ${m.voting_guard_empty ? "EMPTY (open vote)" : "NON-EMPTY (weighted)"}`);
-        lines.push(`Usage guard: ${m.usage_guard_none ? "NONE (open dispute)" : "SOME (filtered dispute)"}`);
-        lines.push(`Vote method: ${m.vote_method}`);
-        lines.push(`Dispute method: ${m.dispute_method}`);
-        lines.push(`Scenario: ${m.scenario}`);
-        lines.push("");
-    }
-    if (h.include_arb_lifecycle && bundle.arb_lifecycle_context) {
-        const lc = bundle.arb_lifecycle_context;
-        lines.push("─ Arb 7-State Lifecycle Context ──────────────");
-        if (lc.current_status) {
-            lines.push(`Current Arb status: ${lc.current_status} (code ${lc.current_status_code})`);
-            lines.push(`Terminal: ${lc.is_terminal ? "YES — no further transitions" : "NO"}`);
-            if (lc.valid_next_statuses.length > 0) {
-                lines.push(`Valid next statuses: ${lc.valid_next_statuses.join(", ")}`);
-            }
-            if (lc.valid_operations_from_here.length > 0) {
-                lines.push(`Valid operations from here (${lc.valid_operations_from_here.length}):`);
-                for (const op of lc.valid_operations_from_here.slice(0, 6)) {
-                    lines.push(`  - ${op}`);
-                }
-                if (lc.valid_operations_from_here.length > 6) {
-                    lines.push(`  ... and ${lc.valid_operations_from_here.length - 6} more`);
-                }
-            }
-        }
-        else {
-            lines.push("No current Arb status provided — lifecycle context inactive");
-        }
-        lines.push("");
-    }
-    if (h.include_risk_details && bundle.relevant_risks.length > 0) {
-        lines.push(`─ Relevant Risk Rules (${bundle.relevant_risks.length}) ──────────────`);
-        for (const r of bundle.relevant_risks.slice(0, 6)) {
-            lines.push(`  ${r.id} — ${r.trigger}`);
-        }
-        if (bundle.relevant_risks.length > 6) {
-            lines.push(`  ... and ${bundle.relevant_risks.length - 6} more`);
-        }
-        lines.push("");
-    }
-    if (bundle.risk_assessment) {
-        lines.push("─ Risk Assessment ──────────────");
-        lines.push(`Overall risk: ${bundle.risk_assessment.overall_risk}`);
-        lines.push(`Detected: ${bundle.risk_assessment.risks.length} risk(s)`);
-        if (bundle.risk_assessment.risks.length > 0) {
-            for (const r of bundle.risk_assessment.risks.slice(0, 3)) {
-                lines.push(`  [${r.level}] ${r.id}: ${r.title}`);
-            }
-            if (bundle.risk_assessment.risks.length > 3) {
-                lines.push(`  ... and ${bundle.risk_assessment.risks.length - 3} more`);
-            }
-        }
-        lines.push("");
-    }
-    if (bundle.relevant_permissions.length > 0) {
-        lines.push(`─ Relevant Permissions (${bundle.relevant_permissions.length}) ──────────────`);
-        for (const p of bundle.relevant_permissions.slice(0, 10)) {
-            const reserved = p.is_reserved ? " [RESERVED]" : "";
-            lines.push(`  [${p.index}] ${p.name}${reserved}: ${p.description}`);
-        }
-        if (bundle.relevant_permissions.length > 10) {
-            lines.push(`  ... and ${bundle.relevant_permissions.length - 10} more`);
-        }
-        lines.push("");
-    }
-    if (bundle.relevant_constraints.length > 0) {
-        lines.push(`─ Relevant Constraint Rules (${bundle.relevant_constraints.length}) ──────────────`);
-        for (const c of bundle.relevant_constraints.slice(0, 5)) {
-            lines.push(`  ${c.id} [${c.category}]: ${c.rule}`);
-        }
-        if (bundle.relevant_constraints.length > 5) {
-            lines.push(`  ... and ${bundle.relevant_constraints.length - 5} more`);
-        }
-        lines.push("");
-    }
-    if (h.include_indemnity_warning) {
-        lines.push("⚠️ INDEMNITY OPERATION DETECTED — arbitration.indemnity transfers WOW from arbiter to disputant");
-        lines.push("   This is IRREVERSIBLE once the ruling is finalized. Verify indemnity amount carefully.");
-        lines.push("");
-    }
-    if (h.include_ownership_transfer_warning) {
-        lines.push("⚠️ OWNERSHIP TRANSFER DETECTED — builder field transfers Arbitration ownership");
-        lines.push("   This is IRREVERSIBLE. Original owner will lose all administrative rights.");
-        lines.push("");
-    }
-    if (h.include_immutability_warning) {
-        lines.push("ℹ️ POST-PUBLISH MODIFICATION — Arbitration is already on-chain");
-        lines.push("   Some fields can be modified (description, location, fee, voting_guard, usage_guard)");
-        lines.push("   but core properties (coin_type, permission object) are immutable.");
-        lines.push("");
-    }
-    if (bundle.cross_object_refs.length > 0) {
-        lines.push(`─ Cross-Object References (${bundle.cross_object_refs.length}) ──────────────`);
-        for (const r of bundle.cross_object_refs.slice(0, 6)) {
-            const arrow = r.direction === "references" ? "→" : "←";
-            lines.push(`  ${arrow} ${r.object}.${r.field} (${r.direction}) — ${r.description}`);
-        }
-        if (bundle.cross_object_refs.length > 6) {
-            lines.push(`  ... and ${bundle.cross_object_refs.length - 6} more`);
-        }
-        lines.push("");
-    }
-    if (bundle.onchain_constraints.length > 0) {
-        lines.push("─ On-chain Constraints ──────────────");
-        for (const c of bundle.onchain_constraints) {
-            lines.push(`  ${c.name} = ${c.value} — ${c.description}`);
-        }
-        lines.push("");
-    }
-    return lines.join("\n");
-}
-export function getArbitrationContextSummary(bundle) {
-    const parts = [
-        `mode=${bundle.mode}`,
-        `scene=${bundle.matched_scene?.id ?? "none"}`,
-        `risks=${bundle.relevant_risks.length}`,
-        `permissions=${bundle.relevant_permissions.length}`,
-        `constraints=${bundle.relevant_constraints.length}`,
-    ];
-    if (bundle.stakeholder_perspective)
-        parts.push(`stakeholder=${bundle.stakeholder_perspective}`);
-    if (bundle.risk_assessment)
-        parts.push(`overall_risk=${bundle.risk_assessment.overall_risk}`);
-    if (bundle.dual_guard_matrix_entry) {
-        parts.push(`dual_guard=${bundle.dual_guard_matrix_entry.vote_method}+${bundle.dual_guard_matrix_entry.dispute_method}`);
-    }
-    if (bundle.arb_lifecycle_context?.current_status) {
-        parts.push(`arb_status=${bundle.arb_lifecycle_context.current_status}`);
-    }
-    if (bundle.cross_object_refs.length > 0)
-        parts.push(`xrefs=${bundle.cross_object_refs.length}`);
-    return parts.join(", ");
-}
-export { ARBITRATION_LEDGER_VERSION, ARBITRATION_SCENES, ARBITRATION_PERMISSIONS, DUAL_GUARD_MATRIX, ARB_STATUS_CODE, ARB_TERMINAL_STATUSES, findSceneById, findSceneByPermissionIndex, inferSceneFromIntent, getScenesByCategory, getDualGuardMatrixEntry, isValidArbStatusTransition, isTerminalArbStatus, getActiveArbitrationPermissions, getAllArbitrationPermissions, } from "./arbitration-ledger.js";
-export { ARBITRATION_TEMPLATES_VERSION, ARBITRATION_TEMPLATES, suggestTemplateForScene, getTemplatesByScene, getTemplateById, } from "./arbitration-templates.js";
-export { ARBITRATION_TRANSLATION_VERSION, SEMANTIC_TO_SCHEMA_RULES, ARBITRATION_CONSTRAINT_RULES, matchSemanticPattern, explainArbitrationCallData, explainPermissionIndex, explainArbStatus, } from "./arbitration-translation.js";
-export { ARBITRATION_RISK_VERSION, getAllRiskRules, assessArbitrationRisks, } from "./arbitration-risk.js";
-export { ARBITRATION_CONFIRM_VERSION, ARBITRATION_OPERATION_CHECKLIST, ARBITRATION_CONFIRMATION_QUESTIONS, runArbitrationConfirmGate, } from "./arbitration-confirm.js";
-export { initPuzzleFromIntent, checkPuzzleCompleteness, validateConstraints, } from "./arbitration-puzzle.js";
+import{MAX_VOTING_GUARD_COUNT}from'@wowok/wowok';import{ARBITRATION_SCENES,DUAL_GUARD_MATRIX,ARB_STATUS_CODE,ARB_TERMINAL_STATUSES,findSceneByPermissionIndex,inferSceneFromIntent,getScenesByCategory,getDualGuardMatrixEntry,isValidArbStatusTransition,isTerminalArbStatus,getActiveArbitrationPermissions,getAllArbitrationPermissions}from'./arbitration-ledger.js';import{getTemplatesByScene}from'./arbitration-templates.js';import{ARBITRATION_CONSTRAINT_RULES,matchSemanticPattern}from'./arbitration-translation.js';import{getAllRiskRules,assessArbitrationRisks}from'./arbitration-risk.js';import{initPuzzleFromIntent,checkPuzzleCompleteness}from'./arbitration-puzzle.js';import{ARBITRATION_OPERATION_CHECKLIST,ARBITRATION_CONFIRMATION_QUESTIONS}from'./arbitration-confirm.js';export const ARBITRATION_CONTEXT_VERSION='1.0.0';export function buildArbitrationContext(a){const b=a['max_length']??0x1194;let c;if(a['intent'])c=inferSceneFromIntent(a['intent']);else{if(a['target_permission_index']!==undefined)c=findSceneByPermissionIndex(a['target_permission_index']);else{if(a['target_operation_category']){const s=getScenesByCategory(a['target_operation_category']);if(s['length']>0x0)c=s[0x0];}}}let d;if(c){const t=getTemplatesByScene(c['id']);if(t['length']>0x0)d=t[0x0];}let e;if(a['intent']){const u=matchSemanticPattern(a['intent']);if(u['length']>0x0)e=u[0x0];}let f,g;a['mode']==='initial_design'&&a['intent']&&(f=initPuzzleFromIntent({'rule_sentence':a['intent']}),g=checkPuzzleCompleteness(f));const h=filterRiskRules(a['mode'],a['stakeholder'],c);let i;if(a['mode']==='pre_publish'&&a['arbitration_json']){const v={'object':a['arbitration_json']['object'],'description':a['arbitration_json']['description'],'location':a['arbitration_json']['location'],'fee':a['arbitration_json']['fee'],'pause':a['arbitration_json']['pause'],'dispute':a['arbitration_json']['dispute'],'confirm':a['arbitration_json']['confirm'],'voting_deadline_change':a['arbitration_json']['voting_deadline_change'],'vote':a['arbitration_json']['vote'],'feedback':a['arbitration_json']['feedback'],'arbitration':a['arbitration_json']['arbitration'],'reset':a['arbitration_json']['reset'],'arb_withdraw':a['arbitration_json']['arb_withdraw'],'fees_transfer':a['arbitration_json']['fees_transfer'],'usage_guard':a['arbitration_json']['usage_guard'],'voting_guard':a['arbitration_json']['voting_guard'],'um':a['arbitration_json']['um'],'builder':a['arbitration_json']['builder'],'current_arb_status':a['current_arb_status'],'expected_arb_status':a['arbitration_json']['arbitration']?'Arbitrated':a['current_arb_status']};i=assessArbitrationRisks(v);}const j=filterChecklist(a['mode']),k=filterQuestions(a['mode']),l=filterConstraints(a['mode'],c),m=a['stakeholder']==='system'?getAllArbitrationPermissions():getActiveArbitrationPermissions();let n;if(a['voting_guard_empty']!==undefined&&a['usage_guard_none']!==undefined)n=getDualGuardMatrixEntry(a['voting_guard_empty'],a['usage_guard_none']);else{if(c){const w=c['requires_voting_guard']==='empty',x=c['requires_usage_guard']==='none';n=getDualGuardMatrixEntry(w,x);}}const o=buildArbLifecycleContext(a['current_arb_status'],c),p=buildCrossObjectRefs(c),q=buildOnchainConstraints(),r=buildRenderingHints(a['mode'],b,!!a['arbitration_json']?.['arbitration'],!!a['arbitration_json']?.['builder']);return{'version':ARBITRATION_CONTEXT_VERSION,'mode':a['mode'],'stakeholder_perspective':a['stakeholder'],'matched_scene':c,'matched_template':d,'matched_pattern':e,'puzzle_state':f,'puzzle_completeness':g,'relevant_risks':h,'risk_assessment':i,'relevant_checklist':j,'relevant_questions':k,'relevant_permissions':m,'relevant_constraints':l,'dual_guard_matrix_entry':n,'arb_lifecycle_context':o,'cross_object_refs':p,'onchain_constraints':q,'rendering_hints':r};}function filterRiskRules(a,b,c){const d=getAllRiskRules();if(a==='initial_design')return d['filter'](e=>e['category']==='structural'||e['category']==='authority');if(a==='pre_publish')return d;if(a==='stakeholder_review'&&b){if(b==='owner')return d['filter'](e=>e['category']==='authority'||e['category']==='lifecycle'||e['category']==='cross_object');if(b==='arbiter')return d['filter'](e=>e['category']==='authority'||e['category']==='lifecycle');if(b==='voter')return d['filter'](e=>e['category']==='structural'||e['category']==='lifecycle');if(b==='disputant')return d['filter'](e=>e['category']==='semantic'||e['category']==='lifecycle');if(b==='system')return d['filter'](e=>e['category']==='structural'||e['category']==='cross_object');}if(a==='post_publish_modify')return d['filter'](e=>e['category']==='lifecycle'||e['category']==='cross_object');return d;}function filterChecklist(a){if(a==='initial_design')return ARBITRATION_OPERATION_CHECKLIST['filter'](b=>['C-AB-01','C-AB-02','C-AB-03','C-AB-04']['includes'](b['id']));return[...ARBITRATION_OPERATION_CHECKLIST];}function filterQuestions(a){if(a==='pre_publish')return[...ARBITRATION_CONFIRMATION_QUESTIONS];if(a==='post_publish_modify')return ARBITRATION_CONFIRMATION_QUESTIONS['filter'](b=>b['id']!=='QAB5');return[];}function filterConstraints(a,b){if(a==='initial_design')return ARBITRATION_CONSTRAINT_RULES['filter'](d=>d['category']==='structural');if(a==='pre_publish')return[...ARBITRATION_CONSTRAINT_RULES];if(b){const c={'lifecycle':['structural','authority'],'dispute':['semantic','lifecycle'],'voting':['semantic','lifecycle'],'ruling':['authority','lifecycle'],'fund':['cross_object'],'guard':['structural','semantic'],'governance':['authority']},d=c[b['operation_category']]??[];return ARBITRATION_CONSTRAINT_RULES['filter'](e=>d['includes'](e['category']));}return[...ARBITRATION_CONSTRAINT_RULES];}function buildArbLifecycleContext(a,b){if(!a&&!b)return undefined;const c=a?isTerminalArbStatus(a):![],d=[];if(a){const f=['Principal_confirming','Arbitrator_confirming','Voting','Arbitrated','Objectionable','Finished','Withdrawn'];for(const g of f){g!==a&&isValidArbStatusTransition(a,g)&&d['push'](g);}}const e=[];for(const h of ARBITRATION_SCENES){a&&h['required_arb_status']&&h['required_arb_status']['includes'](a)&&e['push'](h['id']);}return{'current_status':a,'current_status_code':a?ARB_STATUS_CODE[a]:undefined,'is_terminal':c,'valid_next_statuses':d,'valid_operations_from_here':e};}function buildCrossObjectRefs(a){const b=[],c=[{'object':'Order','field':'dispute.order','scene_id':'arbitration_dispute','description':'dispute()\x20takes\x20Order\x20address\x20—\x20Order\x20is\x20the\x20source\x20of\x20disputes','direction':'references'},{'object':'Arb','field':'dispute\x20(spawns\x20Arb)','scene_id':'arbitration_dispute','description':'Each\x20dispute()\x20creates\x20a\x20new\x20Arb\x20case\x20object\x20with\x207-state\x20lifecycle','direction':'references'},{'object':'Guard','field':'voting_guard\x20/\x20usage_guard','scene_id':'arbitration_voting_guard_config\x20/\x20arbitration_usage_guard_config','description':'voting_guard\x20controls\x20vote\x20weight\x20(max\x2050);\x20usage_guard\x20filters\x20who\x20can\x20file\x20disputes','direction':'references'},{'object':'Allocation','field':'fees_transfer.to.allocation','scene_id':'arbitration_fees_transfer','description':'Withdrawn\x20fees\x20can\x20be\x20routed\x20to\x20Allocation\x20for\x20arbiter\x20compensation\x20distribution','direction':'references'},{'object':'Treasury','field':'fees_transfer.to.treasury','scene_id':'arbitration_fees_transfer','description':'Withdrawn\x20fees\x20can\x20be\x20routed\x20to\x20Treasury\x20as\x20alternative\x20destination','direction':'references'},{'object':'Contact','field':'um','scene_id':'arbitration_um_set','description':'um\x20(Contact\x20object)\x20for\x20arbitrator\x20↔\x20disputant\x20communication\x20channel','direction':'references'},{'object':'Payment','field':'fees_transfer.payment_remark\x20/\x20payment_index','scene_id':'arbitration_fees_transfer','description':'fees_transfer\x20creates\x20Payment\x20object\x20with\x20remark\x20+\x20index\x20for\x20audit\x20trail','direction':'references'}],d=[{'object':'Service','field':'arbitrations\x20(MAX_ARBITRATION_COUNT=20)','scene_id':'service_arbitration_config','description':'Service\x20embeds\x20up\x20to\x2020\x20Arbitration\x20references\x20for\x20dispute\x20resolution\x20per\x20service','direction':'referenced_by'}];if(a){const e=a['id'];return[...c,...d]['filter'](f=>f['scene_id']===e||f['scene_id']['includes'](e['split']('_')[0x1]??''));}return[...c,...d];}function buildOnchainConstraints(){return[{'name':'MAX_VOTING_GUARD_COUNT','value':MAX_VOTING_GUARD_COUNT,'description':'Maximum\x20voting_guard\x20entries\x20per\x20Arbitration\x20(Move\x20source:\x20arbitration.move:25)'},{'name':'ARBITRATION_PERMISSION_INDEX_RANGE','value':'350-368\x20(352\x20reserved)','description':'19\x20built-in\x20permission\x20indexes\x20for\x20Arbitration\x20—\x20most\x20among\x20all\x2022\x20objects'},{'name':'ARB_STATE_COUNT','value':0x7,'description':'Arb\x20has\x207-state\x20lifecycle:\x20Principal_confirming\x20→\x20Arbitrator_confirming\x20→\x20Voting\x20→\x20Arbitrated\x20→\x20Objectionable\x20→\x20Finished/Withdrawn'},{'name':'ARB_TERMINAL_STATUSES','value':ARB_TERMINAL_STATUSES['length'],'description':'Terminal\x20statuses:\x20'+ARB_TERMINAL_STATUSES['join'](',\x20')+'\x20(no\x20further\x20transitions)'},{'name':'DUAL_GUARD_COMBINATIONS','value':DUAL_GUARD_MATRIX['length'],'description':'4\x20dual-Guard\x20combos:\x20(voting_guard\x20empty/non-empty)\x20×\x20(usage_guard\x20none/some)'}];}function buildRenderingHints(a,b,c,d){return{'include_puzzle_template':a==='initial_design','include_risk_details':a==='pre_publish'||a==='stakeholder_review','include_questions':a==='pre_publish','include_dual_guard_matrix':a==='initial_design'||a==='pre_publish','include_arb_lifecycle':a==='pre_publish'||a==='post_publish_modify'||a==='stakeholder_review','include_immutability_warning':a==='post_publish_modify','include_indemnity_warning':c,'include_ownership_transfer_warning':d,'max_length':b};}export function buildPromptFromArbitrationContext(a){const b=[],d=a['rendering_hints'];b['push']('═══\x20Arbitration\x20Context\x20(mode:\x20'+a['mode']+')\x20═══'),b['push']('');a['stakeholder_perspective']&&(b['push']('Stakeholder\x20perspective:\x20'+a['stakeholder_perspective']),b['push'](''));a['matched_scene']&&(b['push']('Scene:\x20'+a['matched_scene']['name']),b['push']('Category:\x20'+a['matched_scene']['operation_category']),b['push']('Permission\x20index:\x20'+a['matched_scene']['permission_index']+'\x20('+a['matched_scene']['permission_name']+')'),a['matched_scene']['required_arb_status']&&a['matched_scene']['required_arb_status']['length']>0x0&&b['push']('Required\x20Arb\x20status:\x20'+a['matched_scene']['required_arb_status']['join']('\x20|\x20')),a['matched_scene']['resulting_arb_status']&&b['push']('Resulting\x20Arb\x20status:\x20'+a['matched_scene']['resulting_arb_status']),b['push']('Has\x20_with_passport\x20variant:\x20'+(a['matched_scene']['has_passport_variant']?'YES':'NO')),b['push'](''));a['matched_template']&&(b['push']('Suggested\x20template:\x20'+a['matched_template']['id']+'\x20—\x20'+a['matched_template']['name']),b['push']('Description:\x20'+a['matched_template']['description']),b['push'](''));a['matched_pattern']&&(b['push']('Matched\x20pattern:\x20'+a['matched_pattern']['id']+'\x20—\x20'+a['matched_pattern']['pattern_name']),b['push']('Intent:\x20'+a['matched_pattern']['semantic_intent']),b['push'](''));if(d['include_puzzle_template']&&a['puzzle_completeness']){const e=a['puzzle_completeness'];b['push']('─\x20Puzzle\x20Completeness\x20──────────────'),b['push']('Complete:\x20'+(e['complete']?'YES':'NO')),e['missing']['length']>0x0&&b['push']('Missing\x20dimensions:\x20'+e['missing']['join'](',\x20')),b['push']('Next\x20step:\x20'+e['next_step']),b['push']('');}if(d['include_dual_guard_matrix']&&a['dual_guard_matrix_entry']){const f=a['dual_guard_matrix_entry'];b['push']('─\x20Dual-Guard\x20Matrix\x20Entry\x20──────────────'),b['push']('Voting\x20guard:\x20'+(f['voting_guard_empty']?'EMPTY\x20(open\x20vote)':'NON-EMPTY\x20(weighted)')),b['push']('Usage\x20guard:\x20'+(f['usage_guard_none']?'NONE\x20(open\x20dispute)':'SOME\x20(filtered\x20dispute)')),b['push']('Vote\x20method:\x20'+f['vote_method']),b['push']('Dispute\x20method:\x20'+f['dispute_method']),b['push']('Scenario:\x20'+f['scenario']),b['push']('');}if(d['include_arb_lifecycle']&&a['arb_lifecycle_context']){const g=a['arb_lifecycle_context'];b['push']('─\x20Arb\x207-State\x20Lifecycle\x20Context\x20──────────────');if(g['current_status']){b['push']('Current\x20Arb\x20status:\x20'+g['current_status']+'\x20(code\x20'+g['current_status_code']+')'),b['push']('Terminal:\x20'+(g['is_terminal']?'YES\x20—\x20no\x20further\x20transitions':'NO'));g['valid_next_statuses']['length']>0x0&&b['push']('Valid\x20next\x20statuses:\x20'+g['valid_next_statuses']['join'](',\x20'));if(g['valid_operations_from_here']['length']>0x0){b['push']('Valid\x20operations\x20from\x20here\x20('+g['valid_operations_from_here']['length']+'):');for(const i of g['valid_operations_from_here']['slice'](0x0,0x6)){b['push']('\x20\x20-\x20'+i);}g['valid_operations_from_here']['length']>0x6&&b['push']('\x20\x20...\x20and\x20'+(g['valid_operations_from_here']['length']-0x6)+'\x20more');}}else b['push']('No\x20current\x20Arb\x20status\x20provided\x20—\x20lifecycle\x20context\x20inactive');b['push']('');}if(d['include_risk_details']&&a['relevant_risks']['length']>0x0){b['push']('─\x20Relevant\x20Risk\x20Rules\x20('+a['relevant_risks']['length']+')\x20──────────────');for(const j of a['relevant_risks']['slice'](0x0,0x6)){b['push']('\x20\x20'+j['id']+'\x20—\x20'+j['trigger']);}a['relevant_risks']['length']>0x6&&b['push']('\x20\x20...\x20and\x20'+(a['relevant_risks']['length']-0x6)+'\x20more'),b['push']('');}if(a['risk_assessment']){b['push']('─\x20Risk\x20Assessment\x20──────────────'),b['push']('Overall\x20risk:\x20'+a['risk_assessment']['overall_risk']),b['push']('Detected:\x20'+a['risk_assessment']['risks']['length']+'\x20risk(s)');if(a['risk_assessment']['risks']['length']>0x0){for(const k of a['risk_assessment']['risks']['slice'](0x0,0x3)){b['push']('\x20\x20['+k['level']+']\x20'+k['id']+':\x20'+k['title']);}a['risk_assessment']['risks']['length']>0x3&&b['push']('\x20\x20...\x20and\x20'+(a['risk_assessment']['risks']['length']-0x3)+'\x20more');}b['push']('');}if(a['relevant_permissions']['length']>0x0){b['push']('─\x20Relevant\x20Permissions\x20('+a['relevant_permissions']['length']+')\x20──────────────');for(const l of a['relevant_permissions']['slice'](0x0,0xa)){const n=l['is_reserved']?'\x20[RESERVED]':'';b['push']('\x20\x20['+l['index']+']\x20'+l['name']+n+':\x20'+l['description']);}a['relevant_permissions']['length']>0xa&&b['push']('\x20\x20...\x20and\x20'+(a['relevant_permissions']['length']-0xa)+'\x20more'),b['push']('');}if(a['relevant_constraints']['length']>0x0){b['push']('─\x20Relevant\x20Constraint\x20Rules\x20('+a['relevant_constraints']['length']+')\x20──────────────');for(const o of a['relevant_constraints']['slice'](0x0,0x5)){b['push']('\x20\x20'+o['id']+'\x20['+o['category']+']:\x20'+o['rule']);}a['relevant_constraints']['length']>0x5&&b['push']('\x20\x20...\x20and\x20'+(a['relevant_constraints']['length']-0x5)+'\x20more'),b['push']('');}d['include_indemnity_warning']&&(b['push']('⚠️\x20INDEMNITY\x20OPERATION\x20DETECTED\x20—\x20arbitration.indemnity\x20transfers\x20WOW\x20from\x20arbiter\x20to\x20disputant'),b['push']('\x20\x20\x20This\x20is\x20IRREVERSIBLE\x20once\x20the\x20ruling\x20is\x20finalized.\x20Verify\x20indemnity\x20amount\x20carefully.'),b['push'](''));d['include_ownership_transfer_warning']&&(b['push']('⚠️\x20OWNERSHIP\x20TRANSFER\x20DETECTED\x20—\x20builder\x20field\x20transfers\x20Arbitration\x20ownership'),b['push']('\x20\x20\x20This\x20is\x20IRREVERSIBLE.\x20Original\x20owner\x20will\x20lose\x20all\x20administrative\x20rights.'),b['push'](''));d['include_immutability_warning']&&(b['push']('ℹ️\x20POST-PUBLISH\x20MODIFICATION\x20—\x20Arbitration\x20is\x20already\x20on-chain'),b['push']('\x20\x20\x20Some\x20fields\x20can\x20be\x20modified\x20(description,\x20location,\x20fee,\x20voting_guard,\x20usage_guard)'),b['push']('\x20\x20\x20but\x20core\x20properties\x20(coin_type,\x20permission\x20object)\x20are\x20immutable.'),b['push'](''));if(a['cross_object_refs']['length']>0x0){b['push']('─\x20Cross-Object\x20References\x20('+a['cross_object_refs']['length']+')\x20──────────────');for(const q of a['cross_object_refs']['slice'](0x0,0x6)){const s=q['direction']==='references'?'→':'←';b['push']('\x20\x20'+s+'\x20'+q['object']+'.'+q['field']+'\x20('+q['direction']+')\x20—\x20'+q['description']);}a['cross_object_refs']['length']>0x6&&b['push']('\x20\x20...\x20and\x20'+(a['cross_object_refs']['length']-0x6)+'\x20more'),b['push']('');}if(a['onchain_constraints']['length']>0x0){b['push']('─\x20On-chain\x20Constraints\x20──────────────');for(const t of a['onchain_constraints']){b['push']('\x20\x20'+t['name']+'\x20=\x20'+t['value']+'\x20—\x20'+t['description']);}b['push']('');}return b['join']('\x0a');}export function getArbitrationContextSummary(a){const b=['mode='+a['mode'],'scene='+(a['matched_scene']?.['id']??'none'),'risks='+a['relevant_risks']['length'],'permissions='+a['relevant_permissions']['length'],'constraints='+a['relevant_constraints']['length']];if(a['stakeholder_perspective'])b['push']('stakeholder='+a['stakeholder_perspective']);if(a['risk_assessment'])b['push']('overall_risk='+a['risk_assessment']['overall_risk']);a['dual_guard_matrix_entry']&&b['push']('dual_guard='+a['dual_guard_matrix_entry']['vote_method']+'+'+a['dual_guard_matrix_entry']['dispute_method']);a['arb_lifecycle_context']?.['current_status']&&b['push']('arb_status='+a['arb_lifecycle_context']['current_status']);if(a['cross_object_refs']['length']>0x0)b['push']('xrefs='+a['cross_object_refs']['length']);return b['join'](',\x20');}export{ARBITRATION_LEDGER_VERSION,ARBITRATION_SCENES,ARBITRATION_PERMISSIONS,DUAL_GUARD_MATRIX,ARB_STATUS_CODE,ARB_TERMINAL_STATUSES,findSceneById,findSceneByPermissionIndex,inferSceneFromIntent,getScenesByCategory,getDualGuardMatrixEntry,isValidArbStatusTransition,isTerminalArbStatus,getActiveArbitrationPermissions,getAllArbitrationPermissions}from'./arbitration-ledger.js';export{ARBITRATION_TEMPLATES_VERSION,ARBITRATION_TEMPLATES,suggestTemplateForScene,getTemplatesByScene,getTemplateById}from'./arbitration-templates.js';export{ARBITRATION_TRANSLATION_VERSION,SEMANTIC_TO_SCHEMA_RULES,ARBITRATION_CONSTRAINT_RULES,matchSemanticPattern,explainArbitrationCallData,explainPermissionIndex,explainArbStatus}from'./arbitration-translation.js';export{ARBITRATION_RISK_VERSION,getAllRiskRules,assessArbitrationRisks}from'./arbitration-risk.js';export{ARBITRATION_CONFIRM_VERSION,ARBITRATION_OPERATION_CHECKLIST,ARBITRATION_CONFIRMATION_QUESTIONS,runArbitrationConfirmGate}from'./arbitration-confirm.js';export{initPuzzleFromIntent,checkPuzzleCompleteness,validateConstraints}from'./arbitration-puzzle.js';